POST /v1/batch

大量の住所を、1回のリクエストで受け付けます。処理は非同期で、応答は 202 Accepted と、結果を取りに行くための URL です。

要確認 本文の項目名（ここでは addresses）と応答の形は、公開前に確定します。

使えるプランと件数

ペイロードの大きさにも上限があります（Growth 2MB · Business 10MB · Enterprise 100MB）。

リクエスト

curl -s https://api.zorynto.com/v1/batch \
  -H "Authorization: Bearer $KITEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"addresses":["東京都品川区東品川2-2-20","大阪府大阪市北区梅田2-5-25"]}'

課金

1件ずつ数えます。 受付時に、月間の残りで足りない場合は拒否され、先に引かれた分は戻されます。

結果の取得

202 で返る URL（GET /v1/batch/{id}）を、一定の間隔でポーリングします。GET /v1/batch/{id} を参照してください。結果は 1時間 で破棄されます。

手順の例

バッチ処理のしかたに、Python のコード付きでまとめています。