Błędy
Każda odmowa ma jeden kształt. Kieruj się polem code: nigdy się nie zmienia. Pole message jest dla człowieka i może się zmienić.
Kształt błędu
{
"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"
}
}Podaj request_id, gdy kontaktujesz się z pomocą techniczną. Każda odpowiedź zawiera go też w nagłówku Request-Id.
Wszystkie kody
API nie rozumie tego żądania: komunikat wyjaśnia dlaczego. Popraw je przed ponownym wysłaniem.
POST /orders wymaga prawidłowego nagłówka Idempotency-Key: do 200 znaków ASCII bez spacji.Wiersz na liście nie jest tym, co przyjmuje weryfikator. Komunikat pokazuje przykłady.
Ten weryfikator wymaga większej liczby wpisów w pliku.
Lista jest za długa: do 100 000 wpisów w żądaniu lub 10 000 000 w przesłanym pliku.
Plik przekracza 200 MB.
Wysłany
country nie pasuje do numerów na liście.Plik musi zawierać numery z jednego kraju. Podziel go na osobne pliki dla każdego kraju.
Ten
upload_id nie należy do Ciebie, przesyłanie jego pliku jeszcze się nie zakończyło albo jego pliku już nie ma (przesłany plik czeka na zamówienie 24 godziny). Jeśli zamówienie z tego pliku zostało już złożone, a odpowiedź przepadła, powtórz to żądanie z jego pierwotnym kluczem Idempotency-Key. W przeciwnym razie prześlij plik ponownie i złóż zamówienie z nowym kluczem Idempotency-Key: pod starym nic nie zostało złożone.Plik zmienił się po wycenie. Żadne zamówienie nie zostało złożone. Prześlij go ponownie i złóż zamówienie z nowym kluczem Idempotency-Key.
Cena jest zbyt stara, aby jej użyć. Powtórz żądanie z tym samym
Idempotency-Key.invalid_key
401Klucza API brakuje, jest nieprawidłowy lub nie pochodzi od nas.
revoked_key
401Ten klucz API został unieważniony. Użyj innego.
expired_key
401Ten klucz API jest po terminie ważności. Utwórz nowy.
Twoje saldo jest za niskie na to zamówienie. Doładuj je, a następnie powtórz zamówienie z tym samym kluczem Idempotency-Key.
key_blocked
403Ten klucz API został zablokowany. Skontaktuj się z pomocą techniczną.
Ten klucz API jest ograniczony do innych adresów IP.
To konto nie może korzystać z API. Skontaktuj się z pomocą techniczną.
Dostęp do API jest wyłączony dla tego konta. Strona nadal działa. Skontaktuj się z pomocą techniczną.
Ten klucz API jest tylko do odczytu, a to wywołanie wymaga klucza, który może składać zamówienia.
Ten weryfikator nie jest obecnie dostępny dla Twojego konta. Zobacz
GET /checkers.Twój adres został zablokowany. Skontaktuj się z pomocą techniczną.
not_found
404Na tym koncie nie ma takiego zamówienia ani punktu końcowego.
Ten klucz Idempotency-Key został użyty z innym żądaniem. Do nowego zamówienia użyj nowego klucza Idempotency-Key.
Cena nie jest tą oczekiwaną albo zmieniła się od pierwszego wysłania klucza Idempotency-Key. Żadne zamówienie nie zostało złożone. Użyj nowego klucza Idempotency-Key, aby zamówić w nowej cenie.
Żądanie przekracza 4 MB. Dla dużej listy użyj
POST /uploads.Masz za dużo czekających przesłanych plików (20 plików lub 100 MB) albo wykonano dziś za dużo przesłań (500). Złóż zamówienie z jednego z nich lub spróbuj ponownie później: przesłany plik jest usuwany po 24 godzinach.
rate_limited
429Przekroczono limit żądań. Odczekaj liczbę sekund podaną w
Retry-After. W przypadku zamówienia powtórz je z tym samym kluczem Idempotency-Key. Zobacz Limity żądań.Masz za dużo niezakończonych zamówień. Odczekaj liczbę sekund podaną w
Retry-After, a następnie powtórz zamówienie z tym samym kluczem Idempotency-Key.Coś poszło nie tak po naszej stronie. W przypadku
POST /orders zamówienie mogło dotrzeć, więc powtórz żądanie z tym samym Idempotency-Key: to nigdy nie pobiera opłaty dwa razy. W przypadku każdego innego wywołania spróbuj ponownie lub skontaktuj się z pomocą techniczną, podając request_id.api_disabled
503API jest na razie wyłączone. Spróbuj ponownie później. W przypadku zamówienia powtórz je z tym samym kluczem Idempotency-Key.
API nie może teraz odpowiedzieć. Odczekaj minutę i powtórz żądanie z tym samym kluczem Idempotency-Key.
Nie mogliśmy potwierdzić zamówienia. Powtórz żądanie z tym samym
Idempotency-Key, aby poznać jego faktyczny stan: to nigdy nie pobiera opłaty dwa razy. Jeśli ta odpowiedź powtarza się dłużej niż kilka minut, przerwij i skontaktuj się z pomocą techniczną, podając request_id. Nie twórz nowego klucza Idempotency-Key.