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 に従います。
この内容に誤りや不足があれば、お知らせください。