Se requiere una clave API para que el sistema procese las solicitudes. Una vez que un usuario se registra, se genera automáticamente una clave API para este usuario. La clave API debe enviarse con cada solicitud (consulte el ejemplo completo a continuación). Si la clave API no se envía o está caducada, habrá un error. Asegúrese de mantener en secreto su clave API para evitar abusos.
Para autenticarse con el sistema API, debe enviar su clave API como un token de autorización con cada solicitud. Puede ver el código de muestra a continuación.
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());
Nuestra API tiene un limitador de velocidad para protegerse contra picos en las solicitudes para maximizar su estabilidad. Nuestro limitador de frecuencia actualmente tiene un límite de 30 solicitudes por 1 minuto. Please note that the rate might change according to the subscribed plan.
Se enviarán varios encabezados junto con la respuesta y estos se pueden examinar para determinar información diversa sobre la solicitud.
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: TIMESTAMP
Todas las respuestas de la API se devuelven en formato JSON de forma predeterminada. Para convertir esto en datos utilizables, será necesario utilizar la función adecuada según el idioma. En PHP, la función json_decode() se puede usar para convertir los datos en un objeto (predeterminado) o en una matriz (establezca el segundo parámetro en verdadero). Es muy importante verificar la clave de error ya que proporciona información sobre si hubo un error o no. También puede consultar el código de cabecera.
{
"error": 1,
"message": "An error occurred"
}
https://urlkai.com/api/campaigns?limit=2&page=1
Чтобы получать свои рассылки через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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
С помощью этой конечной точки можно добавить кампанию.
Parámetro | Descripción |
---|---|
имя | (необязательно) Название кампании |
слизняк | (необязательно) Вращательный слаг |
общественный | (необязательно) Доступ |
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-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
имя | (обязательно) Название кампании |
слизняк | (необязательно) Вращательный слаг |
общественный | (необязательно) Доступ |
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, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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
С помощью этой конечной точки можно добавить канал.
Parámetro | Descripción |
---|---|
имя | (обязательно) Название канала |
описание | (необязательно) Описание канала |
Цвет | (необязательно) Цвет значка канала (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) и идентификатором элемента.
Parámetro | Descripción |
---|---|
: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-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
имя | (необязательно) Название канала |
описание | (необязательно) Описание канала |
Цвет | (необязательно) Цвет значка канала (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/account
Para obtener información sobre la cuenta, puede enviar una solicitud a este punto final y devolverá datos sobre la cuenta.
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
Para actualizar la información de la cuenta, puede enviar una solicitud a este punto final y actualizará los datos de la cuenta.
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/qr?limit=2&page=1
Para obtener sus códigos QR a través de la API, puede usar este punto final. También puede filtrar datos (Ver tabla para más información).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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
Para obtener detalles de un solo código QR a través de la API, puede usar este punto final.
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-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
тип | (обязательный) текст | 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
Para actualizar un código QR, debe enviar datos válidos en JSON a través de una solicitud PUT. Los datos deben enviarse como el cuerpo sin procesar de su solicitud, como se muestra a continuación. El siguiente ejemplo muestra todos los parámetros que puede enviar, pero no es necesario que los envíe todos (consulte la tabla para obtener más información).
Parámetro | Descripción |
---|---|
данные | (обязательно) Данные должны быть встроены в 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
Para eliminar un código QR, debe enviar una solicitud de ELIMINACIÓN.
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, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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
Домен может быть добавлен с помощью этой конечной точки. Пожалуйста, убедитесь, что домен правильно указан на наш сервер.
Parámetro | Descripción |
---|---|
домен | (обязательно) Брендированный домен, включающий 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-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
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=1ℴ=date
Para obtener sus enlaces a través de la API, puede usar este punto final. También puede filtrar datos (Ver tabla para más información).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
порядок | (необязательно) Сортировка данных по дате или клику |
короткий | (необязательно) Поиск по короткому 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
Para obtener detalles de un solo enlace a través de la API, puede usar este punto final.
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
Para acortar un enlace, debe enviar datos válidos en JSON a través de una solicitud POST. Los datos deben enviarse como el cuerpo sin procesar de su solicitud, como se muestra a continuación. El siguiente ejemplo muestra todos los parámetros que puede enviar, pero no es necesario que los envíe todos (consulte la tabla para obtener más información).
Parámetro | Descripción |
---|---|
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
Para actualizar un enlace, debe enviar datos válidos en JSON a través de una solicitud PUT. Los datos deben enviarse como el cuerpo sin procesar de su solicitud, como se muestra a continuación. El siguiente ejemplo muestra todos los parámetros que puede enviar, pero no es necesario que los envíe todos (consulte la tabla para obtener más información).
Parámetro | Descripción |
---|---|
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
Para eliminar un enlace, debe enviar una solicitud de ELIMINACIÓN.
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/files?limit=2&page=1
Получите все свои файлы. Вы также можете искать по имени.
Parámetro | Descripción |
---|---|
имя | (необязательно) Поиск файла по имени |
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
curl --location --request GET 'https://urlkai.com/api/files?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/files?limit=2&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer YOURAPIKEY",
"Content-Type: application/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://urlkai.com/api/files?limit=2&page=1',
'headers': {
'Authorization': 'Bearer YOURAPIKEY',
'Content-Type': 'application/json'
},
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://urlkai.com/api/files?limit=2&page=1"
payload = {}
headers = {
'Authorization': 'Bearer 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/files?limit=2&page=1");
request.Headers.Add("Authorization", "Bearer YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"error": 0,
"result": 3,
"perpage": 15,
"currentpage": 1,
"nextpage": null,
"maxpage": 1,
"list": [
{
"id": 1,
"name": "My Photo",
"downloads": 10,
"shorturl": "https:\/\/urlkai.com\/hIJUE",
"date": "2022-08-09 17:00:00"
},
{
"id": 2,
"name": "My Documents",
"downloads": 15,
"shorturl": "https:\/\/urlkai.com\/dpOON",
"date": "2022-08-10 17:01:00"
},
{
"id": 3,
"name": "My Files",
"downloads": 5,
"shorturl": "https:\/\/urlkai.com\/RdOit",
"date": "2022-08-11 19:01:00"
}
]
}
https://urlkai.com/api/files/upload/:filename?name=My+File
Загрузите файл, отправив двоичные данные в качестве тела сообщения. Вам нужно отправить имя файла с расширением вместо :filename в URL (например, brandkit.zip). Вы можете задать параметры, отправив следующие параметры.
Parámetro | Descripción |
---|---|
имя | (необязательно) Имя файла |
обычай | (необязательно) Пользовательский псевдоним вместо случайного псевдонима. |
домен | (необязательно) Пользовательский домен |
пароль | (необязательно) Защита паролем |
истечение | (необязательно) Срок действия примера для скачивания 2021-09-28 |
максзагрузок | (необязательно) Максимальное количество загрузок |
curl --location --request POST 'https://urlkai.com/api/files/upload/:filename?name=My+File' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '"BINARY DATA"'
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/files/upload/:filename?name=My+File",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer YOURAPIKEY",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS =>
'"BINARY DATA"',
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://urlkai.com/api/files/upload/:filename?name=My+File',
'headers': {
'Authorization': 'Bearer YOURAPIKEY',
'Content-Type': 'application/json'
},
body: JSON.stringify("BINARY DATA"),
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://urlkai.com/api/files/upload/:filename?name=My+File"
payload = "BINARY DATA"
headers = {
'Authorization': 'Bearer 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/files/upload/:filename?name=My+File");
request.Headers.Add("Authorization", "Bearer YOURAPIKEY");
var content = new StringContent(""BINARY DATA"", System.Text.Encoding.UTF8, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"error": 0,
"id": 1,
"shorturl": "https:\/\/urlkai.com\/rThxi"
}
https://urlkai.com/api/splash?limit=2&page=1
Чтобы получить кастомные заставки через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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"
}
]
}
}
https://urlkai.com/api/pixels?limit=2&page=1
Чтобы получить коды пикселей через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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
С помощью этой конечной точки можно создать пиксель. Вам нужно отправить тип пикселя и тег.
Parámetro | Descripción |
---|---|
тип | (обязательно) 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-запрос. Данные должны быть отправлены в виде исходного текста вашего запроса, как показано ниже. В приведенном ниже примере показаны все параметры, которые вы можете отправить, но не обязаны отправлять все (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
имя | (необязательно) Пользовательское имя для пикселя |
ярлык | (обязательно) Тег для пикселя |
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/overlay?limit=2&page=1
Чтобы получить оверлеи cta через API, вы можете использовать эту конечную точку. Вы также можете фильтровать данные (см. таблицу для получения дополнительной информации).
Parámetro | Descripción |
---|---|
предел | (необязательно) Постраничный результат данных |
страница | (необязательно) Запрос текущей страницы |
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"
}
]
}
}