ダウンロード URL

GET/v1/tasks/{token}/result

完了後、結果ファイルのダウンロード URL を取得します。ファイルはデフォルトで 7 日間保存されます(システム設定 result_retention_days で制御)。

レスポンス例

{
  "task_id": "xKj9aP3qLm7v",
  "download_url": "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download",
  "expires_at": "2026-05-02T10:00:00+00:00",
  "summary": {
    "submitted": 5000,
    "prefiltered": 0,
    "deduped": 0,
    "total": 5000,
    "valid": 3800,
    "invalid": 1200,
    "unknown": 0,
    "unknown_processed": 0,
    "unknown_unprocessed": 0
  }
}

レスポンスフィールド

フィールド	タイプ	説明
task_id	string	ポーリングとダウンロードに使用するトークン。これはタスクエンドポイントの {token} パスパラメータです。
download_url	string (URL)	結果ファイルの URL。他のすべての呼び出しと同じ API キーが必要です。
expires_at	string (ISO 8601) | null	ファイルがダウンロードできなくなる時刻。
summary.submitted	integer	送信で受信した行数。
summary.prefiltered	integer	検出前に除外された行（例: 形式が不正な行）。
summary.deduped	integer	削除された重複行。
summary.total	integer	プレフィルタと重複排除の後に、実際に検出用のキューに入った行数。
summary.valid	integer	登録済みと確認された行数。
summary.invalid	integer	未登録と確認された行数。
summary.unknown	integer	プロバイダーが解決できなかった行数。
summary.unknown_processed	integer	再試行して確定した不明行。
summary.unknown_unprocessed	integer	まだ解決していない不明行。これらは返金されます。

注意

expires_at までにダウンロードしてください。期限切れの結果ファイルは完全に削除され、復元できません。

結果ファイルのダウンロード

GET/v1/tasks/{token}/download

curl -X GET "https://api.zelnum.com/api/v1/tasks/xKj9aP3qLm7v/download" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -o result.zip

完成した結果ファイルを添付ファイルとして直接ストリーミングします。結果エンドポイントが返す download_url を開くか、同じタスクトークンでこのエンドポイントを呼び出してください。

保持期間を過ぎるとファイルは削除され、このエンドポイントは 404 を返します。再生成するにはタスクを再送信してください。

• 404 — task_id が存在しないか、別のアカウントに属しています。
• 404 — 結果ファイルが期限切れ、存在しない、または利用できません。
• 422 — タスクが完了していないか、結果ファイルがまだ生成されていません。

次のページ

• 一括の例 — 送信 → ポーリング → ダウンロードの一連の流れを1つのスクリプトで