Fouten
Elke weigering heeft dezelfde vorm. Baseer je op code: die verandert nooit. message is bedoeld voor mensen, en kan veranderen.
De vorm van een fout
{
"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"
}
}Vermeld de request_id als je contact opneemt met support. Elk antwoord bevat die ook als Request-Id-header.
Alle codes
De API begrijpt het verzoek niet: het bericht zegt waarom. Corrigeer het voordat je het opnieuw verstuurt.
POST /orders vereist een geldige Idempotency-Key-header: maximaal 200 ASCII-tekens zonder spaties.Een regel in de lijst is niet wat de checker accepteert. Het bericht toont voorbeelden.
Deze checker heeft meer items per bestand nodig.
De lijst is te lang: maximaal 100.000 items in een verzoek, of 10.000.000 in een upload.
Het bestand is groter dan 200 MB.
De
country die je hebt gestuurd, komt niet overeen met de nummers in de lijst.Een bestand moet nummers uit één land bevatten. Splits het in één bestand per land.
Die
upload_id is niet van jou, het bestand is nog niet helemaal geüpload, of het bestand is weg (een upload wacht 24 uur op een bestelling). Als je al een bestelling hebt geplaatst met deze upload en het antwoord kwijt bent, herhaal dat verzoek dan met de oorspronkelijke idempotentiesleutel. Upload anders het bestand opnieuw en bestel met een nieuwe idempotentiesleutel: met de oude is niets geplaatst.Het bestand is gewijzigd nadat de prijs was berekend. Er is niets geplaatst. Upload het opnieuw en bestel met een nieuwe idempotentiesleutel.
De prijs is te oud om te gebruiken. Herhaal het verzoek met dezelfde
Idempotency-Key.invalid_key
401De API-sleutel ontbreekt, is onjuist of is niet van ons.
revoked_key
401Deze API-sleutel is ingetrokken. Gebruik een andere.
expired_key
401Deze API-sleutel is verlopen. Maak een nieuwe aan.
Je saldo is te laag voor deze bestelling. Waardeer op en herhaal hem dan met dezelfde idempotentiesleutel.
key_blocked
403Deze API-sleutel is geblokkeerd. Neem contact op met support.
Deze API-sleutel is beperkt tot andere IP-adressen.
Dit account kan de API niet gebruiken. Neem contact op met support.
API-toegang is uitgeschakeld voor dit account. De website werkt nog gewoon. Neem contact op met support.
Deze API-sleutel is alleen-lezen, en voor deze aanroep is een sleutel nodig die bestellingen kan plaatsen.
Deze checker is op dit moment niet beschikbaar voor je account. Zie
GET /checkers.Je IP-adres is geblokkeerd. Neem contact op met support.
not_found
404Die bestelling of dat endpoint bestaat niet op dit account.
Deze idempotentiesleutel is gebruikt met een ander verzoek. Gebruik een nieuwe idempotentiesleutel voor een nieuwe bestelling.
De prijs is niet wat je verwachtte, of is gewijzigd sinds de idempotentiesleutel voor het eerst is verstuurd. Er is niets geplaatst. Gebruik een nieuwe idempotentiesleutel om tegen de nieuwe prijs te bestellen.
Het verzoek is groter dan 4 MB. Gebruik
POST /uploads voor een grote lijst.Je hebt te veel wachtende uploads (20 bestanden of 100 MB), of je hebt er vandaag te veel gedaan (500). Bestel met een ervan of probeer het later opnieuw: een upload wordt na 24 uur verwijderd.
rate_limited
429Je zit boven een rate limit. Wacht het aantal seconden in
Retry-After. Herhaal een bestelling met dezelfde idempotentiesleutel. Zie Rate limits.Je hebt te veel onvoltooide bestellingen. Wacht het aantal seconden in
Retry-After en herhaal de bestelling dan met dezelfde idempotentiesleutel.Er is aan onze kant iets misgegaan. Bij
POST /orders kan de bestelling zijn doorgekomen, dus herhaal het verzoek met dezelfde Idempotency-Key: dat schrijft nooit twee keer af. Probeer het bij elke andere aanroep opnieuw, of neem contact op met support met de request_id.api_disabled
503De API staat voorlopig uit. Probeer het later opnieuw. Herhaal een bestelling met dezelfde idempotentiesleutel.
De API kan nu niet antwoorden. Wacht een minuut en herhaal het verzoek met dezelfde idempotentiesleutel.
We konden de bestelling niet bevestigen. Herhaal het verzoek met dezelfde
Idempotency-Key om de werkelijke status te weten te komen: dat schrijft nooit twee keer af. Als je dit antwoord langer dan een paar minuten blijft krijgen, stop dan en neem contact op met support met de request_id. Maak geen nieuwe idempotentiesleutel.