典型的なワークフロー
電話番号の配列を検出のために送信します。非同期で処理されます。コストは事前控除され、未チェック番号は自動返金されます。
エンドポイント一覧
Section titled “エンドポイント一覧”| エンドポイント | 説明 |
|---|---|
GET /v1/balance | 認証されたアカウントの現在の USD 残高を返します。 |
POST /v1/detect | 電話番号の配列を検出のために送信します。非同期で処理されます。コストは事前控除され、未チェック番号は自動返金されます。 |
POST /v1/detect/file | 1 行 1 番号の TXT または CSV ファイルをアップロード、最大 50 MB。 |
GET /v1/tasks/{token} | ステータスが completed または failed になるまでタスクをポーリングしてください。推奨間隔: 3〜5 秒。 |
GET /v1/tasks/{token}/result | 完了後、結果ファイルのダウンロード URL を取得します。ファイルはデフォルトで 7 日間保存されます(システム設定 result_retention_days で制御)。 |
GET /v1/tasks/{token}/download | 完成した結果ファイルを添付ファイルとして直接ストリーミングします。結果エンドポイントが返す download_url を開くか、同じタスクトークンでこのエンドポイントを呼び出してください。 |
HTTP 202 Accepted
送信する前に
Section titled “送信する前に”- 送信数は、選択したプロダクトの最小件数（プロダクトによって 500、1,000、2,000 のいずれかで、一括プロダクト一覧に記載されています）を満たし、かつプラットフォームの上限である 2,000,000 未満に収める必要があります。最小件数を下回る送信は
too_few_numbersとして拒否されます。 - 電話プロダクト: ISO 3166-1 alpha-2 コード（例:
CN、US）。メールプロダクト: このフィールドは完全に省略します。 — 国コード一覧