レート制限時のレスポンス規約
収録 2026-10
レート制限時のレスポンス規約（中国語の原文）
接口 [接口名] 被限流时目前只返回一个 429，没有告诉客户端等多久、额度还剩多少。请定一套限流响应约定：状态码与响应体、剩余额度与重置时间的响应头、不同限流维度（用户、IP、应用）的表达，以及客户端应有的退避行为。输出：约定文档、服务端实现要点、给接入方的示例与建议。
当サイトオリジナル
中国語の原文
使用例
入力例
下单接口被限流只返一个 429，没告诉客户端等多久，补齐响应头与语义约定。
出力に含まれるもの
- 给出状态码与响应体的结构
- 剩余额度与重置时间的响应头
- 说清不同限流维度与退避行为
置き換えるプレースホルダー 1
括弧の中をご自身の情報に置き換えてから送ってください。
[接口名]
使い方
响应头的重置时间基于服务端时钟，要一并返回当前时间或改用相对秒数。
こう変えてみる
- コードを書く前に要件と制約を復唱させる。
- 全体書き換えではなく、最小の変更とロールバック方法を出させる。
得られる成果物
- そのまま使える最小変更（コピー可能なコード）
- 影響範囲：変更ファイルと追従が必要な呼び出し元
よくある失敗
- 一度に十ファイル変更させ、何が原因か分からなくなる。
- エラーだけ貼ってコードとバージョンを省くと、使えない修正が返る。
出力のチェック
- 変更は動いて戻せて、無関係なコードに手を入れていない。
- 境界条件（空・巨大・同時実行）が説明かテストで押さえられている。
使いどころと注意
- 向いている用途：要件と制約を復唱させてから、最小限の動く変更を出させる。
- 注意：エラーにはバージョンと最小再現を添える。無いと一見もっともらしいが合わない修正が返る。