client_request_id 10分钟去重:计时、作用域、异载荷及超时后的只读恢复

オープン
#1,282 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
30/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
openapi, typescript

調査の方向性

Start with the REST v1 order submission and order detail documentation linked in the issue, then compare the Python SDK reference and locate the corresponding docs source in the developers website. Map the documented behavior for deduplication, failures, and read-only recovery against each question in the issue. Done means publishing a formal contract or synthetic example consistent with current REST v1 that answers the listed edge cases; the issue provides no source file or test to run.

索引モデルが issue の本文から書いたものです。

説明

Description

已阅读 POST /v1/trade/order 的 client_request_id 文档:服务端缓存10分钟,窗口内同ID返回原响应;缺失或空值跳过去重。这次不重复问是否存在幂等,而是请补齐边界。

合成场景:请求R1、载荷A,首次POST在返回响应前断线,没有拿到order_id。3分钟后可能读取或重试;12分钟后仍无法确定首次是否受理。没有对真实或模拟账户实际发单,也没有账户、凭据或私人账本。

请明确:

  1. 10分钟从服务器收到请求、受理、创建订单还是写入缓存响应开始?同ID重试会续期吗?
  2. 去重作用域按账户、App/授权、endpoint或业务操作区分吗?AP/HK与US DC、模拟与真实有无差异?
  3. R1+同载荷A 与 R1+不同载荷B(仅数量不同)分别返回原响应、明确拒绝,还是其他结果?是否保证不创建第二单?
  4. 4xx/业务拒绝、5xx以及响应中断分别是否缓存?哪些失败可以明确认定没有订单被创建?
  5. 没拿到order_id时,有无按client_request_id只读查找原订单的方法?当前订单详情需要order_id,能否提供索引等待上限、终局否定状态或错误码?
  6. 窗口外及查无结果如何安全恢复?请区分“不在缓存”“尚未可查询”与“最终未受理”,不要把单次查无当作可重发依据。当前各SDK支持透传该字段的最低版本是什么?

参考:

仅咨询接口契约,希望提供正式文档或合成示例;不请求任何账户操作。

Tasks

  • 请补充与现行 REST v1 一致的正式契约或合成示例。
主要言語
TypeScript
スター
61
フォーク
30
平均マージ
7時間 45分
マージ済み PR(30日)
17

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

longbridge/developers のほかの issue

longbridge/developers の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。