エラー
拒否はすべて同じ形式です。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 がリスト内の番号と一致しません。1 つのファイルには 1 つの国の番号を含める必要があります。国ごとに 1 ファイルに分割してください。
その
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 回）。そのうちの 1 つで注文するか、後でもう一度お試しください。アップロードは 24 時間後に削除されます。
rate_limited
429レート制限を超えています。
Retry-After の秒数だけ待ってください。注文の場合は、同じ冪等キーで繰り返してください。レート制限をご覧ください。未完了の注文が多すぎます。
Retry-After の秒数だけ待ってから、同じ冪等キーで注文を繰り返してください。当社側で問題が発生しました。
POST /orders の場合は注文が通っている可能性があるため、同じ Idempotency-Key でリクエストを繰り返してください。二重に請求されることは決してありません。その他の呼び出しの場合は、再試行するか、request_id を添えてサポートにお問い合わせください。api_disabled
503API は現在オフになっています。後でもう一度お試しください。注文の場合は、同じ冪等キーで繰り返してください。
API は現在応答できません。1 分待ってから、同じ冪等キーでリクエストを繰り返してください。
注文を確認できませんでした。同じ
Idempotency-Key でリクエストを繰り返して実際の状態を確認してください。二重に請求されることは決してありません。数分以上このレスポンスが続く場合は、繰り返しを止めて request_id を添えてサポートにお問い合わせください。新しい冪等キーを作成しないでください。