Errori
Ogni rifiuto ha la stessa forma. Basati su code: non cambia mai. message è per le persone, e può cambiare.
La forma di un errore
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}Indica il request_id se contatti l’assistenza. Ogni risposta lo riporta anche nell’intestazione Request-Id.
Tutti i codici
L’API non comprende la richiesta: il messaggio spiega perché. Correggila prima di inviarla di nuovo.
POST /orders richiede un’intestazione Idempotency-Key valida: fino a 200 caratteri ASCII senza spazi.Una riga della lista non è ciò che il verificatore accetta. Il messaggio mostra degli esempi.
Questo verificatore richiede più voci per file.
La lista è troppo lunga: fino a 100.000 voci in una richiesta, o 10.000.000 in un caricamento.
Il file supera i 200 MB.
Il
country che hai inviato non corrisponde ai numeri della lista.Un file deve contenere numeri di un solo paese. Dividilo in un file per paese.
Quell’
upload_id non è tuo, il suo file non ha finito di caricarsi oppure il suo file non c’è più (un caricamento attende un ordine per 24 ore). Se hai già effettuato un ordine da questo caricamento e hai perso la risposta, ripeti quella richiesta con la sua chiave di idempotenza originale. Altrimenti carica di nuovo il file ed effettua l’ordine con una nuova chiave di idempotenza: con quella vecchia non è stato effettuato nulla.Il file è cambiato dopo il calcolo del prezzo. Non è stato effettuato alcun ordine. Caricalo di nuovo ed effettua l’ordine con una nuova chiave di idempotenza.
Il prezzo è troppo vecchio per essere usato. Ripeti la richiesta con la stessa
Idempotency-Key.invalid_key
401La chiave API è mancante, errata o non è una delle nostre.
revoked_key
401Questa chiave API è stata revocata. Usane un’altra.
expired_key
401Questa chiave API è scaduta. Creane una nuova.
Il tuo saldo è troppo basso per questo ordine. Ricarica, poi ripetilo con la stessa chiave di idempotenza.
key_blocked
403Questa chiave API è stata bloccata. Contatta l’assistenza.
Questa chiave API è limitata ad altri indirizzi IP.
Questo account non può usare l’API. Contatta l’assistenza.
L’accesso all’API è disattivato per questo account. Il sito funziona ancora. Contatta l’assistenza.
Questa chiave API è di sola lettura, e questa chiamata richiede una chiave che possa effettuare ordini.
Questo verificatore non è disponibile per il tuo account al momento. Vedi
GET /checkers.Il tuo indirizzo IP è stato bloccato. Contatta l’assistenza.
not_found
404Non esiste un ordine o un endpoint simile su questo account.
Questa chiave di idempotenza è stata usata con una richiesta diversa. Usa una nuova chiave di idempotenza per un nuovo ordine.
Il prezzo non è quello che ti aspettavi, oppure è cambiato dal primo invio della chiave di idempotenza. Non è stato effettuato alcun ordine. Usa una nuova chiave di idempotenza per ordinare al nuovo prezzo.
La richiesta supera i 4 MB. Usa
POST /uploads per una lista grande.Hai troppi caricamenti in attesa (20 file o 100 MB), oppure ne hai fatti troppi oggi (500). Effettua un ordine da uno di essi o riprova più tardi: un caricamento viene rimosso dopo 24 ore.
rate_limited
429Hai superato un limite di frequenza. Attendi i secondi indicati in
Retry-After. Per un ordine, ripetilo con la stessa chiave di idempotenza. Vedi Limiti di frequenza.Hai troppi ordini non terminati. Attendi i secondi indicati in
Retry-After, poi ripeti l’ordine con la stessa chiave di idempotenza.Si è verificato un problema da parte nostra. Su
POST /orders l’ordine potrebbe essere andato a buon fine, quindi ripeti la richiesta con la stessa Idempotency-Key: non addebita mai due volte. Su qualsiasi altra chiamata, riprova oppure contatta l’assistenza indicando il request_id.api_disabled
503L’API è disattivata per il momento. Riprova più tardi. Per un ordine, ripetilo con la stessa chiave di idempotenza.
L’API non può rispondere in questo momento. Attendi un minuto e ripeti la richiesta con la stessa chiave di idempotenza.
Non è stato possibile confermare l’ordine. Ripeti la richiesta con la stessa
Idempotency-Key per conoscerne lo stato reale: non addebita mai due volte. Se continua a rispondere così per più di qualche minuto, fermati e contatta l’assistenza indicando il request_id. Non creare una nuova chiave di idempotenza.