検出を送信(配列)

POST/v1/detect

電話番号の配列を検出のために送信します。非同期で処理されます。コストは事前控除され、未チェック番号は自動返金されます。

HTTP 202 Accepted

パラメータ

フィールド	タイプ	必須	説明
product	string	はい	製品 slug — 製品リスト
country	string	電話では必須	電話プロダクト: ISO 3166-1 alpha-2 コード（例: CN、US）。メールプロダクト: このフィールドは完全に省略します。 — 国コード一覧
phones	array	はい	単一シリーズの電話番号またはメールアドレスの配列。

ノート

送信数は、選択したプロダクトの最小件数（プロダクトによって 500、1,000、2,000 のいずれかで、一括プロダクト一覧に記載されています）を満たし、かつプラットフォームの上限である 2,000,000 未満に収める必要があります。最小件数を下回る送信は too_few_numbers として拒否されます。

country は電話プロダクト専用のフィールドです

メールには国の次元がありません。メールプロダクトと一緒に country を送ると検証に失敗します。これはリアルタイムエンドポイントと表裏の関係で、そちらでは country は任意ですが、メールでは省略しなければなりません。

レスポンス例

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "idempotent_replay": false,
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

レスポンスフィールド

フィールド	タイプ	説明
mode	string	一括送信では常に async。
task_id	string	ポーリングとダウンロードに使用するトークン。これはタスクエンドポイントの {token} パスパラメータです。
idempotent_replay	boolean	新しいタスクを作成せず、以前のタスクを再利用した場合は true。
recovery_pending	boolean	タスクがキューに入っているが、その課金処理がまだ照合中の場合は true。
message	string	人が読める形式の次のステップ。
summary.total	integer	受け付けた行数。
summary.cost_deducted	number	送信時に事前に差し引かれた金額。

次のページ

• 配列ではなくファイルを送信する
• 処理が終わるまでタスクステータスをポーリングする