APIGET /v1/batch/{id}

GET /v1/batch/{id}

バッチの進捗と結果を取得します。作成したキーの持ち主だけが読めます。結果は 1 時間で破棄されます。

更新: 2026年10月12日

POST /v1/batch で受け付けたバッチの、進捗と結果を返します。

curl -s https://api.zorynto.com/v1/batch/$BATCH_ID \
  -H "Authorization: Bearer $KITEN_API_KEY"

仕様

  • 持ち主の確認:バッチを作成したキーだけが読めます。他のキーで ID を指定しても、取得できません。
  • 保持期間:結果は 1時間 で破棄されます。期限を過ぎた ID は 404 になります(バッチの保持を 24時間に延ばすことは、Business 向けに計画中です)。
  • 部分的な結果:処理が終わっていない間は、できた分までが返ります。

要確認 応答の項目名(状態・進捗・結果の並び)は、公開前に確定します。

ポーリングの目安

1〜2秒の間隔で始め、完了しない間は少しずつ間隔を延ばしてください。429 が返ったら、Retry-After に従います。

この内容に誤りや不足があれば、お知らせください。