È necessaria una chiave API affinché le richieste vengano elaborate dal sistema. Una volta che un utente si registra, viene generata automaticamente una chiave API per questo utente. La chiave API deve essere inviata con ogni richiesta (vedi esempio completo di seguito). Se la chiave API non viene inviata o è scaduta, si verificherà un errore. Assicurati di mantenere segreta la tua chiave API per prevenire abusi.
Per autenticarti con il sistema API, devi inviare la tua chiave API come token di autorizzazione con ogni richiesta. Puoi vedere il codice di esempio di seguito.
curl --location --request POST 'https://urlkai.com/api/account' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl); var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/account',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
Тело: ''
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/account"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/account");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); La nostra API ha un limitatore di velocità per salvaguardare da picchi di richieste per massimizzarne la stabilità. Il nostro limitatore di velocità è attualmente limitato a 30 richieste al 1 minuto. Обратите внимание, что тариф может меняться в зависимости от подписанного плана.
Insieme alla risposta verranno inviate diverse intestazioni che possono essere esaminate per determinare varie informazioni sulla richiesta.
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: TIMESTAMP
Tutte le risposte API vengono restituite in formato JSON per impostazione predefinita. Per convertirli in dati utilizzabili, sarà necessario utilizzare la funzione appropriata in base alla lingua. In PHP, la funzione json_decode() può essere utilizzata per convertire i dati in un oggetto (predefinito) o in un array (impostare il secondo parametro su true). È molto importante controllare la chiave di errore in quanto fornisce informazioni sull'eventuale presenza di un errore. Puoi anche controllare il codice dell'intestazione.
{
"error": 1,
"message": "An error occurred"
}https://urlkai.com/api/account
Per ottenere informazioni sull'account, puoi inviare una richiesta a questo endpoint che restituirà i dati sull'account.
curl --location --request GET 'https://urlkai.com/api/account' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/account',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/account"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/account");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"data": {
"id": 1,
"Электронная почта": " [электронная почта защищена] ",
"username": "sampleuser",
"аватар": "https:\/\/domain.com\/content\/avatar.png",
"status": "pro",
"истекает": "2022-11-15 15:00:00",
"Зарегистрировано": "2020-11-10 18:01:43"
}
} https://urlkai.com/api/account/update
Per aggiornare le informazioni sull'account, puoi inviare una richiesta a questo endpoint che aggiornerà i dati sull'account.
curl --location --request PUT 'https://urlkai.com/api/account/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"Электронная почта": " [электронная почта защищена] ",
"password": "newpassword"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/account/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"Электронная почта": " [электронная почта защищена] ",
"password": "newpassword"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/account/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"Электронная почта": " [электронная почта защищена] ",
"password": "newpassword"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/account/update"
полезная нагрузка = {
"Электронная почта": " [электронная почта защищена] ",
"password": "newpassword"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/account/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"Электронная почта": " [электронная почта защищена] ",
"password": "newpassword"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Аккаунт успешно обновлен."
} https://urlkai.com/api/campaigns?limit=2&page=1
Чтобы получать свои рассылки через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/campaigns?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/campaigns?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/campaigns?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/campaigns?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/campaigns?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"кампании": [
{
"id": 1,
"name": "Пример кампании",
"public": false,
"rotator": false,
"list": "https:\/\/domain.com\/u\/admin\/list-1"
},
{
"id": 2,
"domain": "Кампания в Facebook,"
"публичный": верно,
"rotator": "https:\/\/domain.com\/r\/test",
"list": "https:\/\/domain.com\/u\/admin\/test-2"
}
]
}
} https://urlkai.com/api/campaign/add
С помощью этой конечной точки можно добавить кампанию.
| Параметро | Описание |
|---|---|
| имя | (необязательно) Название кампании |
| слизняк | (необязательно) Вращательный слаг |
| общественный | (необязательно) Доступ |
curl --location --request POST 'https://urlkai.com/api/campaign/add' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"name": "Новая кампания",
"slug": "new-campaign",
"Публичный": правда
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/campaign/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"name": "Новая кампания",
"slug": "new-campaign",
"Публичный": правда
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/campaign/add',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"name": "Новая кампания",
"slug": "new-campaign",
"Публичный": правда
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/campaign/add"
полезная нагрузка = {
"name": "Новая кампания",
"slug": "new-campaign",
"Публичный": правда
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/campaign/add");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"name": "Новая кампания",
"slug": "new-campaign",
"Публичный": правда
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 3,
"domain": "Новая кампания",
"публичный": верно,
"rotator": "https:\/\/domain.com\/r\/new-campaign",
"list": "https:\/\/domain.com\/u\/admin\/new-campaign-3"
} https://urlkai.com/api/campaign/:campaignid/assign/:linkid
С помощью этой конечной точки кампании можно назначить короткую ссылку. Для конечной точки требуется идентификатор кампании и идентификатор короткой ссылки.
curl --location --request POST 'https://urlkai.com/api/campaign/:campaignid/assign/:linkid' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/campaign/:campaignid/assign/:linkid",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/campaign/:campaignid/assign/:linkid',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/campaign/:campaignid/assign/:linkid"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/campaign/:campaignid/assign/:linkid");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Ссылка успешно добавлена в рассылку."
} https://urlkai.com/api/campaign/:id/update
Чтобы обновить кампанию, нужно отправить валидные данные в формате JSON через PUT-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| имя | (обязательно) Название кампании |
| слизняк | (необязательно) Вращательный слаг |
| общественный | (необязательно) Доступ |
curl --location --request PUT 'https://urlkai.com/api/campaign/:id/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"name": "Кампания в Twitter",
"слизняк": "твиттер-кампания",
"Публичный": правда
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/campaign/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"name": "Кампания в Twitter",
"слизняк": "твиттер-кампания",
"Публичный": правда
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/campaign/:id/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"name": "Кампания в Twitter",
"слизняк": "твиттер-кампания",
"Публичный": правда
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/campaign/:id/update"
полезная нагрузка = {
"name": "Кампания в Twitter",
"слизняк": "твиттер-кампания",
"Публичный": правда
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/campaign/:id/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"name": "Кампания в Twitter",
"слизняк": "твиттер-кампания",
"Публичный": правда
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 3,
"domain": "Кампания в Twitter",
"публичный": верно,
"rotator": "https:\/\/domain.com\/r\/twitter-campaign",
"list": "https:\/\/domain.com\/u\/admin\/twitter-campaign-3"
} https://urlkai.com/api/campaign/:id/delete
Чтобы удалить рассылку, нужно отправить запрос DELETE.
curl --location --request DELETE 'https://urlkai.com/api/campaign/:id/delete' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/campaign/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "УДАЛИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/campaign/:id/delete',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/campaign/:id/delete"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/campaign/:id/delete");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Кампания успешно удалена."
} https://urlkai.com/api/channels?limit=2&page=1
Чтобы получить свои каналы через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/channels?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/channels?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/channels?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/channels?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/channels?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"каналы": [
{
"id": 1,
"name": "Канал 1",
"description": "Описание канала 1",
"цвет": "#000000",
"В звездах": правда
},
{
"id": 2,
"name": "Канал 2",
"description": "Описание канала 2",
"color": "#FF0000",
"В звездах": Ложь
}
]
}
} https://urlkai.com/api/channel/:id?limit=1&page=1
Чтобы получить элементы в выбранных каналах через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/channel/:id?limit=1&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/channel/:id?limit=1&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/channel/:id?limit=1&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/channel/:id?limit=1&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/channel/:id?limit=1&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"предметы": [
{
"type": "ссылки",
"id": 1,
"title": "Мой образец ссылки",
"превью": "https:\/\/google.com",
"ссылка": "https:\/\/urlkai.com\/google",
"Дата": "2022-05-12"
},
{
"type": "bio",
"id": 1,
"title": "Мой образец биографии",
"превью": "https:\/\/urlkai.com\/mybio",
"link": "https:\/\/urlkai.com\/mybio",
"Дата": "2022-06-01"
}
]
}
} https://urlkai.com/api/channel/add
С помощью этой конечной точки можно добавить канал.
| Параметро | Описание |
|---|---|
| имя | (обязательно) Название канала |
| описание | (необязательно) Описание канала |
| Цвет | (необязательно) Цвет значка канала (HEX) |
| усеянный | (необязательно) Помечать канал звездочкой или нет (верно или ложно) |
curl --location --request POST 'https://urlkai.com/api/channel/add' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"name": "Новый канал",
"description": "мой новый канал",
"цвет": "#000000",
"В звездах": правда
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/channel/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"name": "Новый канал",
"description": "мой новый канал",
"цвет": "#000000",
"В звездах": правда
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/channel/add',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"name": "Новый канал",
"description": "мой новый канал",
"цвет": "#000000",
"В звездах": правда
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/channel/add"
полезная нагрузка = {
"name": "Новый канал",
"description": "мой новый канал",
"цвет": "#000000",
"В звездах": правда
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/channel/add");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"name": "Новый канал",
"description": "мой новый канал",
"цвет": "#000000",
"В звездах": правда
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 3,
"name": "Новый канал",
"description": "мой новый канал",
"цвет": "#000000",
"В звездах": правда
} https://urlkai.com/api/channel/:channelid/assign/:type/:itemid
Элемент может быть назначен любому каналу, отправив запрос с идентификатором канала, типом элемента (ссылки, биография или qr) и идентификатором элемента.
| Параметро | Описание |
|---|---|
| :channelid | (обязательно) Идентификатор канала |
| :тип | (обязательные) ссылки или биография или QR |
| :itemid | (обязательно) ID элемента |
curl --location --request POST 'https://urlkai.com/api/channel/:channelid/assign/:type/:itemid' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/channel/:channelid/assign/:type/:itemid",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/channel/:channelid/assign/:type/:itemid',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/channel/:channelid/assign/:type/:itemid"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/channel/:channelid/assign/:type/:itemid");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Товар успешно добавлен в канал."
} https://urlkai.com/api/channel/:id/update
Чтобы обновить канал, нужно отправить валидные данные в формате JSON через PUT-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| имя | (необязательно) Название канала |
| описание | (необязательно) Описание канала |
| Цвет | (необязательно) Цвет значка канала (HEX) |
| усеянный | (необязательно) Помечать канал звездочкой или нет (верно или ложно) |
curl --location --request PUT 'https://urlkai.com/api/channel/:id/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"название": "Acme Corp,"
"description": "канал для товаров для Acme Corp,"
"color": "#FFFFFF",
"В звездах": Ложь
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/channel/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"название": "Acme Corp,"
"description": "канал для товаров для Acme Corp,"
"color": "#FFFFFF",
"В звездах": Ложь
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/channel/:id/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"название": "Acme Corp,"
"description": "канал для товаров для Acme Corp,"
"color": "#FFFFFF",
"В звездах": Ложь
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/channel/:id/update"
полезная нагрузка = {
"название": "Acme Corp,"
"description": "канал для товаров для Acme Corp,"
"color": "#FFFFFF",
"В звездах": Ложь
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/channel/:id/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"название": "Acme Corp,"
"description": "канал для товаров для Acme Corp,"
"color": "#FFFFFF",
"В звездах": Ложь
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Канал успешно обновлен."
} https://urlkai.com/api/channel/:id/delete
Чтобы удалить канал, нужно отправить запрос DELETE. Все предметы также будут неназначены.
curl --location --request DELETE 'https://urlkai.com/api/channel/:id/delete' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/channel/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "УДАЛИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/channel/:id/delete',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/channel/:id/delete"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/channel/:id/delete");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Канал успешно удален."
} https://urlkai.com/api/qr?limit=2&page=1
Per ottenere i tuoi codici QR tramite l'API, puoi utilizzare questo endpoint. Puoi anche filtrare i dati (vedi tabella per maggiori informazioni).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/qr?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/qr?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/qr?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/qr?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/qr?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"QRS": [
{
"id": 2,
"link": "https:\/\/urlkai.com\/qr\/a2d5e",
"сканы": 0,
"name": "Google",
"Дата": "2020-11-10 18:01:43"
},
{
"id": 1,
"link": "https:\/\/urlkai.com\/qr\/b9edfe",
"сканы": 5,
"name": "Google Canada,"
"Дата": "2020-11-10 18:00:25"
}
]
}
} https://urlkai.com/api/qr/:id
Per ottenere i dettagli per un singolo codice QR tramite l'API, puoi utilizzare questo endpoint.
curl --location --request GET 'https://urlkai.com/api/qr/:id' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/qr/:id",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/qr/:id',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/qr/:id"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/qr/:id");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"подробности": {
"id": 1,
"link": "https:\/\/urlkai.com\/qr\/b9edfe",
"сканы": 5,
"name": "Google Canada,"
"Дата": "2020-11-10 18:00:25"
},
"data": {
"клики": 1,
"uniqueClicks": 1,
"topCountries": {
"Неизвестный": "1"
},
"topReferrers": {
"Директ, электронная почта и другое": "1"
},
"topBrowsers": {
"Хром": "1"
},
"topOs": {
"Windows 10": "1"
},
"socialCount": {
"фейсбук": 0,
"Твиттер": 0,
"Инстаграм": 0
}
}
} https://urlkai.com/api/qr/add
Чтобы создать QR-код, вам нужно отправить действительные данные в формате JSON через POST-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| тип | (обязательный) текст | VCARD | ссылка | Электронная почта | Телефон | смс | Wi-Fi |
| данные | (обязательно) Данные должны быть встроены в QR-код. Данные могут быть строковыми или массивными в зависимости от типа |
| фон | (необязательно) Цвет RGB, например, rgb (255,255,255) |
| передний план | (необязательно) Цвет RGB, например, rgb(0,0,0) |
| лого | (необязательно) Путь к логотипу либо png, либо jpg |
| имя | (необязательно) Название QR-кода |
curl --location --request POST 'https://urlkai.com/api/qr/add' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API QR-кода"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/qr/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API QR-кода"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/qr/add',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API QR-кода"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/qr/add"
полезная нагрузка = {
"type": "ссылка",
"data": "https://google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"логотип": "https://site.com/logo.png",
"name": "API QR-кода"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/qr/add");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API QR-кода"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 3,
"link": "https:\/\/urlkai.com\/qr\/a58f79"
} https://urlkai.com/api/qr/:id/update
Per aggiornare un codice QR, devi inviare un dato valido in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non è necessario inviarli tutti (vedi tabella per maggiori informazioni).
| Параметро | Описание |
|---|---|
| данные | (обязательно) Данные должны быть встроены в QR-код. Данные могут быть строковыми или массивными в зависимости от типа |
| фон | (необязательно) Цвет RGB, например, rgb (255,255,255) |
| передний план | (необязательно) Цвет RGB, например, rgb(0,0,0) |
| лого | (необязательно) Путь к логотипу либо png, либо jpg |
curl --location --request PUT 'https://urlkai.com/api/qr/:id/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/qr/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/qr/:id/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/qr/:id/update"
полезная нагрузка = {
"type": "ссылка",
"data": "https://google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https://site.com/logo.png"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/qr/:id/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"type": "ссылка",
"data": "https:\/\/google.com",
"background": "rgb(255,255,255),"
"передний план": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "QR успешно обновлен."
} https://urlkai.com/api/qr/:id/delete
Per eliminare un codice QR, è necessario inviare una richiesta DELETE.
curl --location --request DELETE 'https://urlkai.com/api/qr/:id/delete' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/qr/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "УДАЛИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/qr/:id/delete',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/qr/:id/delete"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/qr/:id/delete");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "QR-код был успешно удален."
} https://urlkai.com/api/domains?limit=2&page=1
Чтобы получить свои брендированные домены через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/domains?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/domains?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/domains?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/domains?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/domains?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"домены": [
{
"id": 1,
"domain": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
},
{
"id": 2,
"domain": "https:\/\/domain2.com",
"redirectroot": "https:\/\/rootdomain2.com",
"redirect404": "https:\/\/rootdomain2.com\/404"
}
]
}
} https://urlkai.com/api/domain/add
Домен может быть добавлен с помощью этой конечной точки. Пожалуйста, убедитесь, что домен правильно указан на наш сервер.
| Параметро | Описание |
|---|---|
| домен | (обязательно) Брендированный домен, включающий http или https |
| redirectroot | (необязательно) Корневая переадресация при посещении вашего домена |
| редирект404 | (необязательно) Пользовательский редирект 404 |
curl --location --request POST 'https://urlkai.com/api/domain/add' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"domain": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/domain/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"domain": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/domain/add',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"domain": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/domain/add"
полезная нагрузка = {
"домен": "https://domain1.com",
"redirectroot": "https://rootdomain.com",
"redirect404": "https://rootdomain.com/404"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/domain/add");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"domain": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"ID": 1
} https://urlkai.com/api/domain/:id/update
Чтобы обновить брендированный домен, нужно отправить валидные данные в формате JSON через PUT-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| redirectroot | (необязательно) Корневая переадресация при посещении вашего домена |
| редирект404 | (необязательно) Пользовательский редирект 404 |
curl --location --request PUT 'https://urlkai.com/api/domain/:id/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/domain/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/domain/:id/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/domain/:id/update"
полезная нагрузка = {
"redirectroot": "https://rootdomain-new.com",
"redirect404": "https://rootdomain-new.com/404"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/domain/:id/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Домен успешно обновлен."
} https://urlkai.com/api/domain/:id/delete
Чтобы удалить домен, необходимо отправить запрос DELETE.
curl --location --request DELETE 'https://urlkai.com/api/domain/:id/delete' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/domain/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "УДАЛИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/domain/:id/delete',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/domain/:id/delete"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/domain/:id/delete");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Домен успешно удален."
} https://urlkai.com/api/urls?limit=2&page=1o=date
Per ottenere i tuoi collegamenti tramite l'API, puoi utilizzare questo endpoint. Puoi anche filtrare i dati (vedi tabella per maggiori informazioni).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
| порядок | (необязательно) Сортировка данных по дате или клику |
| короткий | (необязательно) Поиск по короткому URL. Обратите внимание, что при использовании параметра short все остальные параметры игнорируются, и в случае совпадения будет возвращен ответ Single Link. |
| q | (необязательно) Поиск ссылок по ключевому слову |
curl --location --request GET 'https://urlkai.com/api/urls?limit=2&page=1o=date' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/urls?limit=2&page=1o=date",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/urls?limit=2&page=1o=date',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/urls?limit=2&page=1o=date"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/urls?limit=2&page=1o=date");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"URL-адреса": [
{
"id": 2,
"alias": "google",
"shorturl": "https:\/\/urlkai.com\/google",
"longurl": "https:\/\/google.com",
"клики": 0,
"title": "Google",
"description": "",
"Дата": "2020-11-10 18:01:43"
},
{
"id": 1,
"alias": "googlecanada",
"shorturl": "https:\/\/urlkai.com\/googlecanada",
"longurl": "https:\/\/google.ca",
"клики": 0,
"title": "Google Canada,"
"description": "",
"Дата": "2020-11-10 18:00:25"
}
]
}
} https://urlkai.com/api/url/:id
Per ottenere i dettagli per un singolo collegamento tramite l'API, puoi utilizzare questo endpoint.
curl --location --request GET 'https://urlkai.com/api/url/:id' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/url/:id",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/url/:id',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/url/:id"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/url/:id");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 1,
"подробности": {
"id": 1,
"shorturl": "https:\/\/urlkai.com\/googlecanada",
"longurl": "https:\/\/google.com",
"title": "Google",
"description": "",
"местоположение": {
"Канада": "https:\/\/google.ca",
"Соединенные Штаты": "https:\/\/google.us"
},
"устройство": {
"iphone": "https:\/\/google.com",
"Android": "https:\/\/google.com"
},
"expiry": null,
"Дата": "2020-11-10 18:01:43"
},
"data": {
"клики": 0,
"uniqueClicks": 0,
"topCountries": 0,
"topReferrers": 0,
"topBrowsers": 0,
"topOs": 0,
"socialCount": {
"фейсбук": 0,
"Твиттер": 0,
"Google": 0
}
}
} https://urlkai.com/api/url/add
Per abbreviare un collegamento, devi inviare un dato valido in JSON tramite una richiesta POST. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non è necessario inviarli tutti (vedi tabella per maggiori informazioni).
| Параметро | Описание |
|---|---|
| URL-адрес | (обязательно) Длинный URL для сокращения. |
| обычай | (необязательно) Пользовательский псевдоним вместо случайного псевдонима. |
| тип | (необязательно) Тип перенаправления [direct, frame, splash], только идентификатор для пользовательской заставки или Оверлей-ID для CTA страниц |
| пароль | (необязательно) Защита паролем |
| домен | (необязательно) Пользовательский домен |
| истечение | (необязательно) Срок действия для примера ссылки: 2021-09-28 23:11:16 |
| геотаргет | (необязательно) Данные геотаргетинга |
| DeviceTarget | (необязательно) Данные таргетинга на устройства |
| languagetarget | (необязательно) Данные языкового таргетинга |
| Метазаголовок | (необязательно) Мета-титул |
| метаописание | (необязательно) Мета-описание |
| Метаобраз | (необязательно) Ссылка на изображение в формате jpg или png |
| описание | (необязательно) Примечание или описание |
| Пикселей | (необязательно) Массив идентификаторов пикселей |
| канал | (необязательно) Идентификатор канала |
| кампания | (необязательно) Идентификатор кампании |
| Deeplink | (необязательно) Объект, содержащий ссылки на магазин приложений. При использовании этого параметра важно также настроить таргетинг на устройство. (Новый) Теперь вы можете установить параметр "auto" в значение true, чтобы автоматически генерировать диплинки из предоставленной длинной ссылки. |
| статус | (необязательно) общественный или Приватный (по умолчанию) |
curl --location --request POST 'https://urlkai.com/api/url/add' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"URL": "https:\/\/google.com",
"status": "частный",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"metatitle": "Не Google",
"metadescription": "Не описание Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Для facebook",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"кампания": 1,
"deeplink": {
"auto": верно,
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"languagetarget": [
{
"language": "en",
"link": "https:\/\/google.com"
},
{
"language": "fr",
"link": "https:\/\/google.ca"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/url/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"URL": "https:\/\/google.com",
"status": "частный",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"metatitle": "Не Google",
"metadescription": "Не описание Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Для facebook",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"кампания": 1,
"deeplink": {
"auto": верно,
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"languagetarget": [
{
"language": "en",
"link": "https:\/\/google.com"
},
{
"language": "fr",
"link": "https:\/\/google.ca"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/url/add',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"URL": "https:\/\/google.com",
"status": "частный",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"metatitle": "Не Google",
"metadescription": "Не описание Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Для facebook",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"кампания": 1,
"deeplink": {
"auto": верно,
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"languagetarget": [
{
"language": "en",
"link": "https:\/\/google.com"
},
{
"language": "fr",
"link": "https:\/\/google.ca"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/url/add"
полезная нагрузка = {
"url": "https://google.com",
"status": "частный",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"metatitle": "Не Google",
"metadescription": "Не описание Google",
"metaimage": "https://www.mozilla.org/media/protocol/img/logos/firefox/browser/og.4ad05d4125a5.png",
"description": "Для facebook",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"кампания": 1,
"deeplink": {
"auto": верно,
"яблоко": "https://apps.apple.com/us/app/google/id284815942",
"google": "https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https://google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https://google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https://google.com"
},
{
"устройство": "Android",
"link": "https://google.com"
}
],
"languagetarget": [
{
"language": "en",
"link": "https://google.com"
},
{
"language": "fr",
"link": "https://google.ca"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/url/add");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"URL": "https:\/\/google.com",
"status": "частный",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"metatitle": "Не Google",
"metadescription": "Не описание Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Для facebook",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"кампания": 1,
"deeplink": {
"auto": верно,
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"languagetarget": [
{
"language": "en",
"link": "https:\/\/google.com"
},
{
"language": "fr",
"link": "https:\/\/google.ca"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 3,
"shorturl": "https:\/\/urlkai.com\/google"
} https://urlkai.com/api/url/:id/update
Per aggiornare un collegamento, devi inviare un dato valido in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non è necessario inviarli tutti (vedi tabella per maggiori informazioni).
| Параметро | Описание |
|---|---|
| URL-адрес | (обязательно) Длинный URL для сокращения. |
| обычай | (необязательно) Пользовательский псевдоним вместо случайного псевдонима. |
| тип | (необязательно) Тип перенаправления [прямой, кадровый, заставка] |
| пароль | (необязательно) Защита паролем |
| домен | (необязательно) Пользовательский домен |
| истечение | (необязательно) Срок действия для примера ссылки: 2021-09-28 23:11:16 |
| геотаргет | (необязательно) Данные геотаргетинга |
| DeviceTarget | (необязательно) Данные таргетинга на устройства |
| languagetarget | (необязательно) Данные языкового таргетинга |
| Метазаголовок | (необязательно) Мета-титул |
| метаописание | (необязательно) Мета-описание |
| Метаобраз | (необязательно) Ссылка на изображение в формате jpg или png |
| Пикселей | (необязательно) Массив идентификаторов пикселей |
| канал | (необязательно) Идентификатор канала |
| кампания | (необязательно) Идентификатор кампании |
| Deeplink | (необязательно) Объект, содержащий ссылки на магазин приложений. При использовании этого параметра важно также настроить таргетинг на устройство. |
curl --location --request PUT 'https://urlkai.com/api/url/:id/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"URL": "https:\/\/google.com",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"deeplink": {
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/url/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"URL": "https:\/\/google.com",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"deeplink": {
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/url/:id/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"URL": "https:\/\/google.com",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"deeplink": {
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/url/:id/update"
полезная нагрузка = {
"url": "https://google.com",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"deeplink": {
"яблоко": "https://apps.apple.com/us/app/google/id284815942",
"google": "https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https://google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https://google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https://google.com"
},
{
"устройство": "Android",
"link": "https://google.com"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/url/:id/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"URL": "https:\/\/google.com",
"custom": "google",
"password": "mypass",
"Срок действия": "2020-11-11 12:00:00",
"type": "всплеск",
"пиксели": [
1,
2,
3,
4
],
"канал": 1,
"deeplink": {
"Apple": "https:\/\/apps.apple.com\/us\/app\/google\/id284815942",
"google": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.googlequicksearchbox&hl=en_CA≷=US"
},
"Геомишень": [
{
"location": "Канада",
"link": "https:\/\/google.ca"
},
{
"location": "Соединенные Штаты",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https:\/\/google.com"
},
{
"устройство": "Android",
"link": "https:\/\/google.com"
}
],
"параметры": [
{
"name": "aff",
"value": "3"
},
{
"устройство": "gtm_source",
"link": "api"
}
]
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"id": 3,
"короткий": "https:\/\/urlkai.com\/google"
} https://urlkai.com/api/url/:id/delete
Per eliminare un collegamento, è necessario inviare una richiesta DELETE.
curl --location --request DELETE 'https://urlkai.com/api/url/:id/delete' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/url/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "УДАЛИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/url/:id/delete',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/url/:id/delete"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/url/:id/delete");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Ссылка успешно удалена"
} https://urlkai.com/api/overlay?limit=2&page=1
Чтобы получить оверлеи cta через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/overlay?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/overlay?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/overlay?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/overlay?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/overlay?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"CTA": [
{
"id": 1,
"type": "сообщение",
"name": "Товар 1 Промо",
"Дата": "2020-11-10 18:00:00"
},
{
"id": 2,
"type": "контакт",
"name": "Контактная страница",
"Дата": "2020-11-10 18:10:00"
}
]
}
} https://urlkai.com/api/pixels?limit=2&page=1
Чтобы получить коды пикселей через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/pixels?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/pixels?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/pixels?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/pixels?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/pixels?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"пиксели": [
{
"id": 1,
"type": "gtmpixel",
"name": "GTM Pixel,"
"тег": "GA-123456789",
"Дата": "2020-11-10 18:00:00"
},
{
"id": 2,
"type": "twitterpixel",
"name": "Twitter Pixel,"
"tag": "1234567",
"Дата": "2020-11-10 18:10:00"
}
]
}
} https://urlkai.com/api/pixel/add
С помощью этой конечной точки можно создать пиксель. Вам нужно отправить тип пикселя и тег.
| Параметро | Описание |
|---|---|
| тип | (обязательно) gtmpixel | Гапиксель | FBPIXEL | adwordspixel | linkedinpixel | Твиттерпиксель | adrollpixel | Кворапиксель | Пинтерест | Бинг | Снэпчат | Реддит | Тикток |
| имя | (обязательно) Пользовательское имя для пикселя |
| ярлык | (обязательно) Тег для пикселя |
curl --location --request POST 'https://urlkai.com/api/pixel/add' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"type": "gtmpixel",
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/pixel/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЧТА",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"type": "gtmpixel",
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/pixel/add',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"type": "gtmpixel",
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/pixel/add"
полезная нагрузка = {
"type": "gtmpixel",
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/pixel/add");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"type": "gtmpixel",
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"ID": 1
} https://urlkai.com/api/pixel/:id/update
Чтобы обновить пиксель, нужно отправить валидные данные в формате JSON через PUT-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| имя | (необязательно) Пользовательское имя для пикселя |
| ярлык | (обязательно) Тег для пикселя |
curl --location --request PUT 'https://urlkai.com/api/pixel/:id/update' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \
--data-raw '{
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}' $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/pixel/:id/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПУТ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
CURLOPT_POSTFIELDS =>
'{
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}',
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'PUT',
'url': 'https://urlkai.com/api/pixel/:id/update',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
тело: JSON.stringify({
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}),
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/pixel/:id/update"
полезная нагрузка = {
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("PUT", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/pixel/:id/update");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{
"name": "Мой GTM",
"tag": "GTM-ABCDE"
}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Пиксель успешно обновился."
} https://urlkai.com/api/pixel/:id/delete
Чтобы удалить пиксель, нужно отправить запрос DELETE.
curl --location --request DELETE 'https://urlkai.com/api/pixel/:id/delete' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/pixel/:id/delete",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "УДАЛИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/pixel/:id/delete',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/pixel/:id/delete"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("DELETE", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/pixel/:id/delete");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": 0,
"message": "Пиксель был успешно удален."
} https://urlkai.com/api/splash?limit=2&page=1
Чтобы получить кастомные заставки через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
| Параметро | Описание |
|---|---|
| предел | (необязательно) Постраничный результат данных |
| страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/splash?limit=2&page=1' \
--заголовок 'Авторизация: Bearer YOURAPIKEY' \
--заголовок 'Content-Type: application/json' \ $curl = curl_init();
curl_setopt_array($curl, массив(
CURLOPT_URL => "https://urlkai.com/api/splash?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS = > 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "ПОЛУЧИТЬ",
CURLOPT_HTTPHEADER => [
"Авторизация: Предъявитель YOURAPIKEY",
"Content-Type: application/json,"
],
));
$response = curl_exec($curl);
curl_close($curl);
эхо $response; var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/splash?limit=2&page=1',
'headers': {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (ошибка, ответ) {
if (error) throw new Error(error);
console.log(response.body);
}); Запросы на импорт
URL = "https://urlkai.com/api/splash?limit=2&page=1"
полезная нагрузка = {}
заголовки = {
'Авторизация': 'Предъявитель YOURAPIKEY',
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, json=payload)
print(response.text) var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/splash?limit=2&page=1");
просьба. Headers.Add("Авторизация", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
просьба. Content = содержимое;
var response = ожидать клиента. SendAsync(запрос);
ответ. EnsureSuccessStatusCode();
Console.WriteLine(ожидание ответа. Content.ReadAsStringAsync()); {
"ошибка": "0",
"data": {
"результат": 2,
"perpage": 2,
"текущая страница": 1,
"Следующая страница": 1,
"maxpage": 1,
"Всплеск": [
{
"id": 1,
"name": "Товар 1 Промо",
"Дата": "2020-11-10 18:00:00"
},
{
"id": 2,
"name": "Товар 2 Промо",
"Дата": "2020-11-10 18:10:00"
}
]
}
}