오류
모든 거부는 형태가 같습니다. code를 기준으로 처리하세요. 이 값은 절대 바뀌지 않습니다. message는 사람이 읽기 위한 것이며 바뀔 수 있습니다.
오류의 형태
{
"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"
}
}고객 지원팀에 문의할 때 request_id를 알려 주세요. 모든 응답에는 Request-Id 헤더로도 포함됩니다.
모든 코드
API가 이해할 수 없는 요청입니다. 메시지에 이유가 표시됩니다. 수정한 후 다시 보내세요.
POST /orders에는 유효한 Idempotency-Key 헤더가 필요합니다. 공백 없는 200자 이하의 ASCII 문자열입니다.목록의 어떤 줄이 체커가 받는 형식이 아닙니다. 메시지에 예시가 표시됩니다.
이 체커는 파일당 더 많은 항목이 필요합니다.
목록이 너무 깁니다. 요청은 100,000건, 업로드는 10,000,000건까지입니다.
파일이 200 MB를 초과합니다.
보낸
country가 목록의 번호와 일치하지 않습니다.한 파일에는 한 국가의 번호만 있어야 합니다. 국가별로 파일 하나씩 나누세요.
해당
upload_id가 고객님의 것이 아니거나, 파일 업로드가 끝나지 않았거나, 파일이 없어졌습니다(업로드는 24시간 동안 주문을 기다립니다). 이 업로드로 이미 주문했는데 응답을 받지 못했다면 원래 멱등 키로 그 요청을 반복하세요. 그렇지 않다면 파일을 다시 업로드하고 새 멱등 키로 주문하세요. 이전 멱등 키로는 주문이 접수되지 않았습니다.가격이 책정된 후 파일이 변경되었습니다. 주문이 접수되지 않았습니다. 다시 업로드하고 새 멱등 키로 주문하세요.
가격이 너무 오래되어 사용할 수 없습니다. 같은
Idempotency-Key로 요청을 반복하세요.invalid_key
401API 키가 없거나, 잘못되었거나, 당사의 키가 아닙니다.
revoked_key
401이 API 키는 폐기되었습니다. 다른 API 키를 사용하세요.
expired_key
401이 API 키는 만료되었습니다. 새 API 키를 만드세요.
이 주문에 필요한 잔액이 부족합니다. 충전한 다음 같은 멱등 키로 주문을 반복하세요.
key_blocked
403이 API 키는 차단되었습니다. 고객 지원팀에 문의하세요.
이 API 키는 다른 IP 주소로 제한되어 있습니다.
이 계정은 API를 사용할 수 없습니다. 고객 지원팀에 문의하세요.
이 계정의 API 접근이 꺼져 있습니다. 웹사이트는 계속 사용할 수 있습니다. 고객 지원팀에 문의하세요.
이 API 키는 읽기 전용이며, 이 호출에는 주문 가능한 API 키가 필요합니다.
이 체커는 현재 고객님의 계정에 열려 있지 않습니다.
GET /checkers를 참고하세요.고객님의 주소가 차단되었습니다. 고객 지원팀에 문의하세요.
not_found
404이 계정에 해당 주문이나 엔드포인트가 없습니다.
이 멱등 키는 다른 요청에 사용되었습니다. 새 주문에는 새 멱등 키를 사용하세요.
가격이 예상한 가격과 다르거나, 이 멱등 키를 처음 보낸 후 변경되었습니다. 주문이 접수되지 않았습니다. 새 가격으로 주문하려면 새 멱등 키를 사용하세요.
요청이 4 MB를 초과합니다. 큰 목록에는
POST /uploads를 사용하세요.대기 중인 업로드가 너무 많거나(20개 파일 또는 100 MB), 오늘 업로드를 너무 많이 했습니다(500회). 그중 하나로 주문하거나 나중에 다시 시도하세요. 업로드는 24시간 후 삭제됩니다.
rate_limited
429속도 제한을 초과했습니다.
Retry-After의 초만큼 기다리세요. 주문인 경우 같은 멱등 키로 반복하세요. 속도 제한을 참고하세요.완료되지 않은 주문이 너무 많습니다.
Retry-After의 초만큼 기다린 다음 같은 멱등 키로 주문을 반복하세요.당사 측에서 문제가 발생했습니다.
POST /orders의 경우 주문이 접수되었을 수 있으므로 같은 Idempotency-Key로 요청을 반복하세요. 절대 두 번 청구되지 않습니다. 다른 호출의 경우 다시 시도하거나 request_id와 함께 고객 지원팀에 문의하세요.api_disabled
503API가 현재 꺼져 있습니다. 나중에 다시 시도하세요. 주문인 경우 같은 멱등 키로 반복하세요.
API가 지금 응답할 수 없습니다. 1분 기다린 후 같은 멱등 키로 요청을 반복하세요.
주문을 확인할 수 없었습니다. 같은
Idempotency-Key로 요청을 반복해 실제 상태를 확인하세요. 절대 두 번 청구되지 않습니다. 몇 분 넘게 이 응답이 계속되면 중단하고 request_id와 함께 고객 지원팀에 문의하세요. 새 멱등 키를 만들지 마세요.