長時間処理APIの設計
収録 2026-10
長時間処理APIの設計（中国語の原文）
这个接口要跑 [耗时范围]，经常被网关超时掐断。请把它改成提交任务返回任务标识、由客户端轮询或等回调的方式，并处理重复提交与结果过期。输出：接口时序、任务状态机、轮询建议间隔与退避、结果文件的保留时长、以及客户端拿到失败后该如何重试。
当サイトオリジナル
中国語の原文
使用例
入力例
这个导出接口要跑两分钟，常被网关超时掐断，改成提交任务再轮询查询结果。
出力に含まれるもの
- 交代接口时序与任务状态机
- 处理重复提交与结果过期问题
- 给轮询间隔退避与失败重试
置き換えるプレースホルダー 1
括弧の中をご自身の情報に置き換えてから送ってください。
[耗时范围]
使い方
轮询接口要能区分「还在跑」和「查不到这个任务」，否则客户端会无限重试。
こう変えてみる
- コードを書く前に要件と制約を復唱させる。
- 全体書き換えではなく、最小の変更とロールバック方法を出させる。
得られる成果物
- そのまま使える最小変更（コピー可能なコード）
- 影響範囲：変更ファイルと追従が必要な呼び出し元
よくある失敗
- 一度に十ファイル変更させ、何が原因か分からなくなる。
- エラーだけ貼ってコードとバージョンを省くと、使えない修正が返る。
出力のチェック
- 変更は動いて戻せて、無関係なコードに手を入れていない。
- 境界条件（空・巨大・同時実行）が説明かテストで押さえられている。
使いどころと注意
- 向いている用途：要件と制約を復唱させてから、最小限の動く変更を出させる。
- 注意：エラーにはバージョンと最小再現を添える。無いと一見もっともらしいが合わない修正が返る。