È necessaria una chiave API affinché le richieste vengano elaborate dal sistema. Una volta che un utente si registra, viene generata automaticamente una chiave API per questo utente. La chiave API deve essere inviata con ogni richiesta (vedi esempio completo di seguito). Se la chiave API non viene inviata o è scaduta, si verificherà un errore. Assicurati di mantenere segreta la tua chiave API per prevenire abusi.
Per autenticarti con il sistema API, devi inviare la tua chiave API come token di autorizzazione con ogni richiesta. Puoi vedere il codice di esempio di seguito.
curl --location --request POST 'https://urlkai.com/api/account' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/account",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl); var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'URL': 'https://urlkai.com/api/account',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: ''
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/account"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/account");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); La nostra API ha un limitatore di velocità per salvaguardare da picchi di richieste per massimizzarne la stabilità. Il nostro limitatore di velocità è attualmente limitato a 30 richieste al 1 minuto. Si prega di notare che la tariffa potrebbe cambiare in base al piano sottoscritto.
Insieme alla risposta verranno inviate diverse intestazioni che possono essere esaminate per determinare varie informazioni sulla richiesta.
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: TIMESTAMP
Tutte le risposte API vengono restituite in formato JSON per impostazione predefinita. Per convertirli in dati utilizzabili, sarà necessario utilizzare la funzione appropriata in base alla lingua. In PHP, la funzione json_decode() può essere utilizzata per convertire i dati in un oggetto (predefinito) o in un array (impostare il secondo parametro su true). È molto importante controllare la chiave di errore in quanto fornisce informazioni sull'eventuale presenza di un errore. Puoi anche controllare il codice dell'intestazione.
{
"error": 1,
"message": "An error occurred"
}https://urlkai.com/api/account
Per ottenere informazioni sull'account, puoi inviare una richiesta a questo endpoint che restituirà i dati sull'account.
curl --location --request GET 'https://urlkai.com/api/account' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/account",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/account',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/account"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/account");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"dati": {
"id": 1,
"e-mail": " [email protected] ",
"username": "utente campione",
"avatar": "https:\/\/domain.com\/content\/avatar.png",
"status": "pro",
"scade": "2022-11-15 15:00:00",
"registrato": "2020-11-10 18:01:43"
}
} https://urlkai.com/api/account/update
Per aggiornare le informazioni sull'account, puoi inviare una richiesta a questo endpoint che aggiornerà i dati sull'account.
curl --location --request PUT 'https://urlkai.com/api/account/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"e-mail": " [email protected] ",
"password": "newpassword"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/account/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"e-mail": " [email protected] ",
"password": "newpassword"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'URL': 'https://urlkai.com/api/account/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"e-mail": " [email protected] ",
"password": "newpassword"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/account/update"
carico utile = {
"e-mail": " [email protected] ",
"password": "newpassword"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/account/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"e-mail": " [email protected] ",
"password": "newpassword"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "L'account è stato aggiornato con successo."
} https://urlkai.com/api/campaigns?limit=2&page=1
Per ottenere le tue campagne tramite l'API, puoi utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/campaigns?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/campaigns?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'url': 'https://urlkai.com/api/campaigns?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/campaigns?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/campaigns?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"campagne": [
{
"id": 1,
"name": "Campagna campione",
"pubblico": falso,
"rotatore": falso,
"list": "https:\/\/domain.com\/u\/admin\/list-1"
},
{
"id": 2,
"domain": "Campagna Facebook",
"pubblico": vero,
"rotator": "https:\/\/domain.com\/r\/test",
"list": "https:\/\/domain.com\/u\/admin\/test-2"
}
]
}
} https://urlkai.com/api/campaign/add
È possibile aggiungere una campagna utilizzando questo endpoint.
| Parametro | Descrizione |
|---|---|
| nome | (Facoltativo) Nome della campagna |
| Lumaca | (Facoltativo) Lumaca rotatore |
| pubblico | (Facoltativo) Accesso |
curl --location --request POST 'https://urlkai.com/api/campaign/add' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"name": "Nuova campagna",
"slug": "nuova-campagna",
"pubblico": vero
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/campaign/add",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"name": "Nuova campagna",
"slug": "nuova-campagna",
"pubblico": vero
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'url': 'https://urlkai.com/api/campaign/add',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"name": "Nuova campagna",
"slug": "nuova-campagna",
"pubblico": vero
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/campaign/add"
carico utile = {
"name": "Nuova campagna",
"slug": "nuova-campagna",
"pubblico": vero
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = nuovo HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/campaign/add");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"name": "Nuova campagna",
"slug": "nuova-campagna",
"pubblico": vero
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 3,
"domain": "Nuova campagna",
"pubblico": vero,
"rotator": "https:\/\/domain.com\/r\/new-campaign",
"list": "https:\/\/domain.com\/u\/admin\/new-campaign-3"
} https://urlkai.com/api/campaign/:campaignid/assign/:linkid
Un collegamento breve può essere assegnato a una campagna utilizzando questo endpoint. L'endpoint richiede l'ID campagna e l'ID collegamento breve.
curl --location --request POST 'https://urlkai.com/api/campaign/:campaignid/assign/:linkid' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/campaign/:campaignid/assign/:linkid",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'URL': 'https://urlkai.com/api/campaign/:campaignid/assign/:linkid',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/campaign/:campaignid/assign/:linkid"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/campaign/:campaignid/assign/:linkid");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Link aggiunto alla campagna."
} https://urlkai.com/api/campaign/:id/update
Per aggiornare una campagna, è necessario inviare dati validi in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non sei obbligato a inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| nome | (obbligatorio) Nome della campagna |
| Lumaca | (Facoltativo) Lumaca rotatore |
| pubblico | (Facoltativo) Accesso |
curl --location --request PUT 'https://urlkai.com/api/campaign/:id/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"name": "Campagna Twitter",
"slug": "campagna su Twitter",
"pubblico": vero
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/campaign/:id/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"name": "Campagna Twitter",
"slug": "campagna su Twitter",
"pubblico": vero
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'url': 'https://urlkai.com/api/campaign/:id/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"name": "Campagna Twitter",
"slug": "campagna su Twitter",
"pubblico": vero
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/campaign/:id/update"
carico utile = {
"name": "Campagna Twitter",
"slug": "campagna su Twitter",
"pubblico": vero
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/campaign/:id/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"name": "Campagna Twitter",
"slug": "campagna su Twitter",
"pubblico": vero
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 3,
"domain": "Campagna Twitter",
"pubblico": vero,
"rotator": "https:\/\/domain.com\/r\/twitter-campaign",
"list": "https:\/\/domain.com\/u\/admin\/twitter-campaign-3"
} https://urlkai.com/api/campaign/:id/delete
Per eliminare una campagna, è necessario inviare una richiesta di ELIMINAZIONE.
curl --location --request DELETE 'https://urlkai.com/api/campaign/:id/delete' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/campaign/:id/delete",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "ELIMINA",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
'method': 'DELETE',
'URL': 'https://urlkai.com/api/campaign/:id/delete',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/campaign/:id/delete"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("DELETE", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/campaign/:id/delete");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "La campagna è stata eliminata con successo."
} https://urlkai.com/api/channels?limit=2&page=1
Per ottenere i tuoi canali tramite l'API, puoi utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/channels?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/channels?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/channels?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/channels?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/channels?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"canali": [
{
"id": 1,
"name": "Canale 1",
"description": "Descrizione del canale 1",
"colore": "#000000",
"Stellato": vero
},
{
"id": 2,
"name": "Canale 2",
"description": "Descrizione del canale 2",
"color": "#FF0000",
"stellato": falso
}
]
}
} https://urlkai.com/api/channel/:id?limit=1&page=1
Per ottenere elementi in un canale selezionato tramite l'API, è possibile utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/channel/:id?limit=1&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/channel/:id?limit=1&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/channel/:id?limit=1&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/channel/:id?limit=1&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/channel/:id?limit=1&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"articoli": [
{
"type": "collegamenti",
"id": 1,
"title": "Il mio link di esempio",
"anteprima": "https:\/\/google.com",
"link": "https:\/\/urlkai.com\/google",
"data": "2022-05-12"
},
{
"tipo": "bio",
"id": 1,
"title": "Il mio esempio di biografia",
"anteprima": "https:\/\/urlkai.com\/mybio",
"link": "https:\/\/urlkai.com\/mybio",
"data": "2022-06-01"
}
]
}
} https://urlkai.com/api/channel/add
È possibile aggiungere un canale utilizzando questo endpoint.
| Parametro | Descrizione |
|---|---|
| nome | (obbligatorio) Nome del canale |
| descrizione | (Facoltativo) Descrizione del canale |
| Colore | (Facoltativo) Colore del badge del canale (HEX) |
| Recitato | (Facoltativo) Contrassegnare il canale con o meno (vero o falso) |
curl --location --request POST 'https://urlkai.com/api/channel/add' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"name": "Nuovo canale",
"description": "il mio nuovo canale",
"colore": "#000000",
"Stellato": vero
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/channel/add",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"name": "Nuovo canale",
"description": "il mio nuovo canale",
"colore": "#000000",
"Stellato": vero
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'URL': 'https://urlkai.com/api/channel/add',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"name": "Nuovo canale",
"description": "il mio nuovo canale",
"colore": "#000000",
"Stellato": vero
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/channel/add"
carico utile = {
"name": "Nuovo canale",
"description": "il mio nuovo canale",
"colore": "#000000",
"Stellato": vero
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/channel/add");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"name": "Nuovo canale",
"description": "il mio nuovo canale",
"colore": "#000000",
"Stellato": vero
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 3,
"name": "Nuovo canale",
"description": "il mio nuovo canale",
"colore": "#000000",
"Stellato": vero
} https://urlkai.com/api/channel/:channelid/assign/:type/:itemid
Un articolo può essere assegnato a qualsiasi canale inviando una richiesta con l'ID del canale, il tipo di articolo (link, bio o qr) e l'ID dell'articolo.
| Parametro | Descrizione |
|---|---|
| :ID canale | (obbligatorio) ID canale |
| :digitare | (obbligatorio) link o bio o qr |
| :iditemida | (obbligatorio) ID articolo |
curl --location --request POST 'https://urlkai.com/api/channel/:channelid/assign/:type/:itemid' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/channel/:channelid/assign/:type/:itemid",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'url': 'https://urlkai.com/api/channel/:channelid/assign/:type/:itemid',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/channel/:channelid/assign/:type/:itemid"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/channel/:channelid/assign/:type/:itemid");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Elemento aggiunto al canale con successo."
} https://urlkai.com/api/channel/:id/update
Per aggiornare un canale, è necessario inviare dati validi in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non sei obbligato a inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| nome | (Facoltativo) Nome del canale |
| descrizione | (Facoltativo) Descrizione del canale |
| Colore | (Facoltativo) Colore del badge del canale (HEX) |
| Recitato | (Facoltativo) Contrassegnare il canale con o meno (vero o falso) |
curl --location --request PUT 'https://urlkai.com/api/channel/:id/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"name": "Acme Corp",
"description": "canale per gli articoli per Acme Corp",
"color": "#FFFFFF",
"stellato": falso
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/channel/:id/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"name": "Acme Corp",
"description": "canale per gli articoli per Acme Corp",
"color": "#FFFFFF",
"stellato": falso
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'URL': 'https://urlkai.com/api/channel/:id/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"name": "Acme Corp",
"description": "canale per gli articoli per Acme Corp",
"color": "#FFFFFF",
"stellato": falso
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/channel/:id/update"
carico utile = {
"name": "Acme Corp",
"description": "canale per gli articoli per Acme Corp",
"color": "#FFFFFF",
"stellato": falso
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/channel/:id/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"name": "Acme Corp",
"description": "canale per gli articoli per Acme Corp",
"color": "#FFFFFF",
"stellato": falso
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il canale è stato aggiornato con successo."
} https://urlkai.com/api/channel/:id/delete
Per eliminare un canale, è necessario inviare una richiesta di ELIMINAZIONE. Anche tutti gli articoli non saranno assegnati.
curl --location --request DELETE 'https://urlkai.com/api/channel/:id/delete' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/channel/:id/delete",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "ELIMINA",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
'method': 'DELETE',
'url': 'https://urlkai.com/api/channel/:id/delete',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/channel/:id/delete"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("DELETE", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/channel/:id/delete");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il canale è stato eliminato con successo."
} https://urlkai.com/api/qr?limit=2&page=1
Per ottenere i tuoi codici QR tramite l'API, puoi utilizzare questo endpoint. Puoi anche filtrare i dati (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/qr?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/qr?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/qr?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/qr?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/qr?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"QRS": [
{
"id": 2,
"link": "https:\/\/urlkai.com\/qr\/a2d5e",
"scansioni": 0,
"name": "Google",
"data": "2020-11-10 18:01:43"
},
{
"id": 1,
"link": "https:\/\/urlkai.com\/qr\/b9edfe",
"scansioni": 5,
"name": "Google Canada",
"data": "2020-11-10 18:00:25"
}
]
}
} https://urlkai.com/api/qr/:id
Per ottenere i dettagli per un singolo codice QR tramite l'API, puoi utilizzare questo endpoint.
curl --location --request GET 'https://urlkai.com/api/qr/:id' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/qr/:id",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'url': 'https://urlkai.com/api/qr/:id',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/qr/:id"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/qr/:id");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"dettagli": {
"id": 1,
"link": "https:\/\/urlkai.com\/qr\/b9edfe",
"scansioni": 5,
"name": "Google Canada",
"data": "2020-11-10 18:00:25"
},
"dati": {
"clic": 1,
"uniqueClicks": 1,
"topCountries": {
"Sconosciuto": "1"
},
"topReferrers": {
"Diretto, email e altro": "1"
},
"topBrowsers": {
"Chrome": "1"
},
"topOs": {
"Windows 10": "1"
},
"socialCount": {
"facebook": 0,
"twitter": 0,
"instagram": 0
}
}
} https://urlkai.com/api/qr/add
Per creare un codice QR, è necessario inviare dati validi in JSON tramite una richiesta POST. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non sei obbligato a inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| digitare | testo (obbligatorio) | vcard | collegamento | e-mail | telefono | sms | Connessione Wi-Fi |
| dati | (obbligatorio) Dati da incorporare all'interno del codice QR. I dati possono essere stringa o matrice a seconda del tipo |
| sfondo | (Facoltativo) Colore RGB, ad esempio rgb(255,255,255) |
| primo piano | (Facoltativo) Colore RGB, ad esempio rgb(0,0,0) |
| logo | (Facoltativo) Percorso del logo png o jpg |
| nome | (Facoltativo) Nome del codice QR |
curl --location --request POST 'https://urlkai.com/api/qr/add' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API del codice QR"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/qr/add",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API del codice QR"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'URL': 'https://urlkai.com/api/qr/add',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API del codice QR"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/qr/add"
carico utile = {
"type": "link",
"dati": "https://google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https://site.com/logo.png",
"name": "API del codice QR"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/qr/add");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png",
"name": "API del codice QR"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 3,
"collegamento": "https:\/\/urlkai.com\/qr\/a58f79"
} https://urlkai.com/api/qr/:id/update
Per aggiornare un codice QR, devi inviare un dato valido in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare, ma non è necessario inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| dati | (obbligatorio) Dati da incorporare all'interno del codice QR. I dati possono essere stringa o matrice a seconda del tipo |
| sfondo | (Facoltativo) Colore RGB, ad esempio rgb(255,255,255) |
| primo piano | (Facoltativo) Colore RGB, ad esempio rgb(0,0,0) |
| logo | (Facoltativo) Percorso del logo png o jpg |
curl --location --request PUT 'https://urlkai.com/api/qr/:id/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/qr/:id/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'url': 'https://urlkai.com/api/qr/:id/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/qr/:id/update"
carico utile = {
"type": "link",
"dati": "https://google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https://site.com/logo.png"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/qr/:id/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"type": "link",
"dati": "https:\/\/google.com",
"sfondo": "rgb(255,255,255)",
"primo piano": "rgb(0,0,0)",
"logo": "https:\/\/site.com\/logo.png"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il codice QR è stato aggiornato correttamente."
} https://urlkai.com/api/qr/:id/delete
Per eliminare un codice QR, è necessario inviare una richiesta DELETE.
curl --location --request DELETE 'https://urlkai.com/api/qr/:id/delete' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/qr/:id/delete",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "ELIMINA",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
'method': 'DELETE',
'URL': 'https://urlkai.com/api/qr/:id/delete',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/qr/:id/delete"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("DELETE", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/qr/:id/delete");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il codice QR è stato eliminato con successo."
} https://urlkai.com/api/domains?limit=2&page=1
Per ottenere i domini con il tuo marchio tramite l'API, puoi utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/domains?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/domains?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/domains?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/domains?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/domains?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"domini": [
{
"id": 1,
"dominio": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
},
{
"id": 2,
"dominio": "https:\/\/domain2.com",
"redirectroot": "https:\/\/rootdomain2.com",
"redirect404": "https:\/\/rootdomain2.com\/404"
}
]
}
} https://urlkai.com/api/domain/add
È possibile aggiungere un dominio utilizzando questo endpoint. Assicurati che il dominio sia puntato correttamente al nostro server.
| Parametro | Descrizione |
|---|---|
| dominio | (obbligatorio) Dominio con marchio che include http o https |
| radice di reindirizzamento | (Facoltativo) Reindirizzamento root quando qualcuno visita il tuo dominio |
| reindirizzamento404 | (Facoltativo) Reindirizzamento 404 personalizzato |
curl --location --request POST 'https://urlkai.com/api/domain/add' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"dominio": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/domain/add",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"dominio": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'URL': 'https://urlkai.com/api/domain/add',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"dominio": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/domain/add"
carico utile = {
"dominio": "https://domain1.com",
"redirectroot": "https://rootdomain.com",
"redirect404": "https://rootdomain.com/404"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = nuovo HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/domain/add");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"dominio": "https:\/\/domain1.com",
"redirectroot": "https:\/\/rootdomain.com",
"redirect404": "https:\/\/rootdomain.com\/404"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 1
} https://urlkai.com/api/domain/:id/update
Per aggiornare un dominio brandizzato, è necessario inviare dati validi in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non sei obbligato a inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| radice di reindirizzamento | (Facoltativo) Reindirizzamento root quando qualcuno visita il tuo dominio |
| reindirizzamento404 | (Facoltativo) Reindirizzamento 404 personalizzato |
curl --location --request PUT 'https://urlkai.com/api/domain/:id/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/domain/:id/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'URL': 'https://urlkai.com/api/domain/:id/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/domain/:id/update"
carico utile = {
"redirectroot": "https://rootdomain-new.com",
"redirect404": "https://rootdomain-new.com/404"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/domain/:id/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"redirectroot": "https:\/\/rootdomain-new.com",
"redirect404": "https:\/\/rootdomain-new.com\/404"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il dominio è stato aggiornato correttamente."
} https://urlkai.com/api/domain/:id/delete
Per eliminare un dominio, è necessario inviare una richiesta di DELETE.
curl --location --request DELETE 'https://urlkai.com/api/domain/:id/delete' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/domain/:id/delete",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "ELIMINA",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
'method': 'DELETE',
'URL': 'https://urlkai.com/api/domain/:id/delete',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/domain/:id/delete"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("DELETE", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/domain/:id/delete");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il dominio è stato eliminato con successo."
} https://urlkai.com/api/urls?limit=2&page=1o=date
Per ottenere i tuoi collegamenti tramite l'API, puoi utilizzare questo endpoint. Puoi anche filtrare i dati (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
| ordine | (Facoltativo) Ordina i dati tra data o clic |
| corto | (Facoltativo) Cerca utilizzando l'URL breve. Si noti che quando si utilizza il parametro short, tutti gli altri parametri vengono ignorati e se c'è una corrispondenza verrà restituita una risposta Single Link. |
| q | (Facoltativo) Cercare link utilizzando una parola chiave |
curl --location --request GET 'https://urlkai.com/api/urls?limit=2&page=1o=date' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/urls?limit=2&page=1o=date",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/urls?limit=2&page=1o=date',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/urls?limit=2&page=1o=date"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/urls?limit=2&page=1o=date");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"URL": [
{
"id": 2,
"alias": "google",
"shorturl": "https:\/\/urlkai.com\/google",
"longurl": "https:\/\/google.com",
"clic": 0,
"title": "Google",
"description": ","
"data": "2020-11-10 18:01:43"
},
{
"id": 1,
"alias": "googlecanada",
"shorturl": "https:\/\/urlkai.com\/googlecanada",
"longurl": "https:\/\/google.ca",
"clic": 0,
"title": "Google Canada",
"description": ","
"data": "2020-11-10 18:00:25"
}
]
}
} https://urlkai.com/api/url/:id
Per ottenere i dettagli per un singolo collegamento tramite l'API, puoi utilizzare questo endpoint.
curl --location --request GET 'https://urlkai.com/api/url/:id' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/url/:id",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/url/:id',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/url/:id"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/url/:id");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 1,
"dettagli": {
"id": 1,
"shorturl": "https:\/\/urlkai.com\/googlecanada",
"longurl": "https:\/\/google.com",
"title": "Google",
"description": ","
"posizione": {
"Canada": "https:\/\/google.ca",
"Stati Uniti": "https:\/\/google.us"
},
"dispositivo": {
"iphone": "https:\/\/google.com",
"android": "https:\/\/google.com"
},
"scadenza": nullo,
"data": "2020-11-10 18:01:43"
},
"dati": {
"clic": 0,
"uniqueClicks": 0,
"topCountries": 0,
"topReferrers": 0,
"topBrowsers": 0,
"topOs": 0,
"socialCount": {
"facebook": 0,
"twitter": 0,
"google": 0
}
}
} https://urlkai.com/api/url/add
Per abbreviare un collegamento, devi inviare un dato valido in JSON tramite una richiesta POST. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare, ma non è necessario inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| URL | (obbligatorio) URL lungo da accorciare. |
| costume | (Facoltativo) Alias personalizzato invece di alias casuali. |
| digitare | (Facoltativo) Solo tipo di reindirizzamento [diretto, frame, splash] Id per una pagina iniziale personalizzata o ID sovrapposizione per le pagine CTA |
| parola d’ordine | (Facoltativo) Protezione con password |
| dominio | (Facoltativo) Dominio personalizzato |
| scadenza | (Facoltativo) Scadenza per l'esempio di collegamento 2021-09-28 23:11:16 |
| Obiettivo geografico | (Facoltativo) Dati di targeting geografico |
| DeviceTarget | (Facoltativo) Dati di targeting per dispositivo |
| languagetarget | (Facoltativo) Dati di targeting per lingua |
| metatitolo | (Facoltativo) Meta titolo |
| metadescrizione | (Facoltativo) Meta descrizione |
| metaimmagine | (Facoltativo) Collegamento a un'immagine jpg o png |
| descrizione | (Facoltativo) Nota o descrizione |
| Pixel | (Facoltativo) Matrice di ID pixel |
| canale | (Facoltativo) ID canale |
| campagna | (Facoltativo) ID campagna |
| collegamento diretto | (Facoltativo) Oggetto contenente collegamenti all'app store. Quando si utilizza questa opzione, è importante impostare anche il targeting per dispositivo. (Nuovo) Ora è possibile impostare il parametro "auto" su true per generare automaticamente i collegamenti profondi dal collegamento lungo fornito. |
| stato | (Facoltativo) pubblico o privato (impostazione predefinita) |
curl --location --request POST 'https://urlkai.com/api/url/add' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"url": "https:\/\/google.com",
"status": "privato",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"metatitle": "Non Google",
"metadescription": "Non descrizione di Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Per facebook",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"campagna": 1,
"collegamento profondo": {
"auto": vero,
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"Destinazione della lingua": [
{
"lingua": "en",
"collegamento": "https:\/\/google.com"
},
{
"lingua": "fr",
"link": "https:\/\/google.ca"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/url/add",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"url": "https:\/\/google.com",
"status": "privato",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"metatitle": "Non Google",
"metadescription": "Non descrizione di Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Per facebook",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"campagna": 1,
"collegamento profondo": {
"auto": vero,
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"Destinazione della lingua": [
{
"lingua": "en",
"collegamento": "https:\/\/google.com"
},
{
"lingua": "fr",
"link": "https:\/\/google.ca"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'URL': 'https://urlkai.com/api/url/add',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"url": "https:\/\/google.com",
"status": "privato",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"metatitle": "Non Google",
"metadescription": "Non descrizione di Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Per facebook",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"campagna": 1,
"collegamento profondo": {
"auto": vero,
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"Destinazione della lingua": [
{
"lingua": "en",
"collegamento": "https:\/\/google.com"
},
{
"lingua": "fr",
"link": "https:\/\/google.ca"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/url/add"
carico utile = {
"url": "https://google.com",
"status": "privato",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"metatitle": "Non Google",
"metadescription": "Non descrizione di Google",
"metaimage": "https://www.mozilla.org/media/protocol/img/logos/firefox/browser/og.4ad05d4125a5.png",
"description": "Per facebook",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"campagna": 1,
"collegamento profondo": {
"auto": vero,
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https://google.ca"
},
{
"location": "Stati Uniti",
"link": "https://google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https://google.com"
},
{
"device": "Android",
"link": "https://google.com"
}
],
"Destinazione della lingua": [
{
"lingua": "en",
"link": "https://google.com"
},
{
"lingua": "fr",
"link": "https://google.ca"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/url/add");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"url": "https:\/\/google.com",
"status": "privato",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"metatitle": "Non Google",
"metadescription": "Non descrizione di Google",
"metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
"description": "Per facebook",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"campagna": 1,
"collegamento profondo": {
"auto": vero,
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"Destinazione della lingua": [
{
"lingua": "en",
"collegamento": "https:\/\/google.com"
},
{
"lingua": "fr",
"link": "https:\/\/google.ca"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 3,
"shorturl": "https:\/\/urlkai.com\/google"
} https://urlkai.com/api/url/:id/update
Per aggiornare un collegamento, devi inviare un dato valido in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare, ma non è necessario inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| URL | (obbligatorio) URL lungo da accorciare. |
| costume | (Facoltativo) Alias personalizzato invece di alias casuali. |
| digitare | (Facoltativo) Tipo di reindirizzamento [diretto, fotogramma, splash] |
| parola d’ordine | (Facoltativo) Protezione con password |
| dominio | (Facoltativo) Dominio personalizzato |
| scadenza | (Facoltativo) Scadenza per l'esempio di collegamento 2021-09-28 23:11:16 |
| Obiettivo geografico | (Facoltativo) Dati di targeting geografico |
| DeviceTarget | (Facoltativo) Dati di targeting per dispositivo |
| languagetarget | (Facoltativo) Dati di targeting per lingua |
| metatitolo | (Facoltativo) Meta titolo |
| metadescrizione | (Facoltativo) Meta descrizione |
| metaimmagine | (Facoltativo) Collegamento a un'immagine jpg o png |
| Pixel | (Facoltativo) Matrice di ID pixel |
| canale | (Facoltativo) ID canale |
| campagna | (Facoltativo) ID campagna |
| collegamento diretto | (Facoltativo) Oggetto contenente collegamenti all'app store. Quando si utilizza questa opzione, è importante impostare anche il targeting per dispositivo. |
curl --location --request PUT 'https://urlkai.com/api/url/:id/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"url": "https:\/\/google.com",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"collegamento profondo": {
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/url/:id/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"url": "https:\/\/google.com",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"collegamento profondo": {
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'URL': 'https://urlkai.com/api/url/:id/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"url": "https:\/\/google.com",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"collegamento profondo": {
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/url/:id/update"
carico utile = {
"url": "https://google.com",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"collegamento profondo": {
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https://google.ca"
},
{
"location": "Stati Uniti",
"link": "https://google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"link": "https://google.com"
},
{
"device": "Android",
"link": "https://google.com"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/url/:id/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"url": "https:\/\/google.com",
"personalizzato": "google",
"password": "mypass",
"scadenza": "2020-11-11 12:00:00",
"type": "splash",
"pixel": [
1,
2,
3,
4
],
"canale": 1,
"collegamento profondo": {
"mela": "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"
},
"Bersaglio geografico": [
{
"location": "Canada",
"link": "https:\/\/google.ca"
},
{
"location": "Stati Uniti",
"link": "https:\/\/google.us"
}
],
"devicetarget": [
{
"device": "iPhone",
"collegamento": "https:\/\/google.com"
},
{
"device": "Android",
"collegamento": "https:\/\/google.com"
}
],
"parametri": [
{
"name": "aff",
"valore": "3"
},
{
"dispositivo": "gtm_source",
"link": "api"
}
]
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 3,
"short": "https:\/\/urlkai.com\/google"
} https://urlkai.com/api/url/:id/delete
Per eliminare un collegamento, è necessario inviare una richiesta DELETE.
curl --location --request DELETE 'https://urlkai.com/api/url/:id/delete' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/url/:id/delete",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "ELIMINA",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
'method': 'DELETE',
'URL': 'https://urlkai.com/api/url/:id/delete',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/url/:id/delete"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("DELETE", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/url/:id/delete");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il link è stato eliminato con successo"
} https://urlkai.com/api/overlay?limit=2&page=1
Per ottenere sovrapposizioni cta tramite l'API, è possibile utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/overlay?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/overlay?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'URL': 'https://urlkai.com/api/overlay?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/overlay?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/overlay?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"CTA": [
{
"id": 1,
"type": "messaggio",
"name": "Prodotto 1 Promo",
"data": "2020-11-10 18:00:00"
},
{
"id": 2,
"type": "contatto",
"name": "Pagina dei contatti",
"data": "2020-11-10 18:10:00"
}
]
}
} https://urlkai.com/api/pixels?limit=2&page=1
Per ottenere i codici dei pixel tramite l'API, puoi utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/pixels?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/pixels?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'url': 'https://urlkai.com/api/pixels?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/pixels?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/pixels?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"pixel": [
{
"id": 1,
"tipo": "gtmpixel",
"name": "GTM Pixel",
"tag": "GA-123456789",
"data": "2020-11-10 18:00:00"
},
{
"id": 2,
"tipo": "TwitterPixel",
"name": "Pixel di Twitter",
"tag": "1234567",
"data": "2020-11-10 18:10:00"
}
]
}
} https://urlkai.com/api/pixel/add
È possibile creare un pixel utilizzando questo endpoint. È necessario inviare il tipo di pixel e il tag.
| Parametro | Descrizione |
|---|---|
| digitare | (obbligatorio) gtmpixel | gapixel | fbpixel | AdwordsPixel | Linkedinpixel | Pixel di Twitter | AdrollPixel | quorapixel | Pinterest | Bing | Snapchat | Reddit | tiktok |
| nome | (obbligatorio) Nome personalizzato per il tuo pixel |
| cartellino | (obbligatorio) Il tag per il pixel |
curl --location --request POST 'https://urlkai.com/api/pixel/add' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"tipo": "gtmpixel",
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/pixel/add",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"tipo": "gtmpixel",
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «POST»,
'url': 'https://urlkai.com/api/pixel/add',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"tipo": "gtmpixel",
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/pixel/add"
carico utile = {
"tipo": "gtmpixel",
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("POST", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = nuovo HttpRequestMessage(HttpMethod.Post, "https://urlkai.com/api/pixel/add");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"tipo": "gtmpixel",
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"id": 1
} https://urlkai.com/api/pixel/:id/update
Per aggiornare un pixel, è necessario inviare dati validi in JSON tramite una richiesta PUT. I dati devono essere inviati come corpo grezzo della tua richiesta come mostrato di seguito. L'esempio seguente mostra tutti i parametri che puoi inviare ma non sei obbligato a inviarli tutti (vedi tabella per maggiori informazioni).
| Parametro | Descrizione |
|---|---|
| nome | (Facoltativo) Nome personalizzato per il tuo pixel |
| cartellino | (obbligatorio) Il tag per il pixel |
curl --location --request PUT 'https://urlkai.com/api/pixel/:id/update' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \
--dati-grezzi '{
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/pixel/:id/update",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
CURLOPT_POSTFIELDS =>
'{
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}',
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «PUT»,
'URL': 'https://urlkai.com/api/pixel/:id/update',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
corpo: JSON.stringify({
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}),
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/pixel/:id/update"
carico utile = {
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("PUT", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
richiesta var = new HttpRequestMessage(HttpMethod.Put, "https://urlkai.com/api/pixel/:id/update");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{
"name": "Il mio GTM",
"tag": "GTM-ABCDE"
}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il pixel è stato aggiornato correttamente".
} https://urlkai.com/api/pixel/:id/delete
Per eliminare un pixel, è necessario inviare una richiesta di ELIMINAZIONE.
curl --location --request DELETE 'https://urlkai.com/api/pixel/:id/delete' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/pixel/:id/delete",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "ELIMINA",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
'method': 'DELETE',
'URL': 'https://urlkai.com/api/pixel/:id/delete',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/pixel/:id/delete"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("DELETE", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://urlkai.com/api/pixel/:id/delete");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": 0,
"message": "Il pixel è stato eliminato con successo."
} https://urlkai.com/api/splash?limit=2&page=1
Per ottenere pagine iniziali personalizzate tramite l'API, è possibile utilizzare questo endpoint. È inoltre possibile filtrare i dati (vedere la tabella per ulteriori informazioni).
| Parametro | Descrizione |
|---|---|
| limite | (Facoltativo) Risultato dei dati per pagina |
| pagina | (Facoltativo) Richiesta pagina corrente |
curl --location --request GET 'https://urlkai.com/api/splash?limit=2&page=1' \
--header 'Autorizzazione: Portatore YOURAPIKEY' \
--header 'Tipo di contenuto: application/json' \ $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://urlkai.com/api/splash?limit=2&page=1",
CURLOPT_RETURNTRANSFER => vero,
CURLOPT_MAXREDIRS => 2,
CURLOPT_TIMEOUT => 10,
CURLOPT_FOLLOWLOCATION => vero,
CURLOPT_CUSTOMREQUEST => "OTTIENI",
CURLOPT_HTTPHEADER => [
"Autorizzazione: Portatore YOURAPIKEY",
"Tipo di contenuto: applicazione/json",
],
));
$response = curl_exec($curl);
curl_close($curl);
eco $response; var request = require('richiesta');
opzioni var = {
«metodo»: «GET»,
'url': 'https://urlkai.com/api/splash?limit=2&page=1',
'intestazioni': {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
},
};
request(opzioni, funzione (errore, risposta) {
if (error) throw new Error(error);
console.log(response.body);
}); Richieste di importazione
url = "https://urlkai.com/api/splash?limit=2&page=1"
payload = {}
intestazioni = {
«Autorizzazione»: «Bearer YOURAPIKEY»,
'Tipo di contenuto': 'applicazione/json'
}
risposta = requests.request("GET", url, headers=headers, json=payload)
print(risposta.testo) var client = nuovo HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://urlkai.com/api/splash?limit=2&page=1");
richiesta. Headers.Add("Autorizzazione", "Portatore YOURAPIKEY");
var content = new StringContent("{}", System.Text.Encoding.UTF8, "application/json");
richiesta. Contenuto = contenuto;
risposta var = attendere il client. SendAsync(richiesta);
risposta. EnsureSuccessStatusCode();
Console.WriteLine(await response. Content.ReadAsStringAsync()); {
"errore": "0",
"dati": {
"risultato": 2,
"perpage": 2,
"currentpage": 1,
"pagina successiva": 1,
"maxpage": 1,
"spruzzo": [
{
"id": 1,
"name": "Prodotto 1 Promo",
"data": "2020-11-10 18:00:00"
},
{
"id": 2,
"name": "Prodotto 2 Promo",
"data": "2020-11-10 18:10:00"
}
]
}
}