client_request_id 10分钟去重:计时、作用域、异载荷及超时后的只读恢复
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 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分钟后仍无法确定首次是否受理。没有对真实或模拟账户实际发单,也没有账户、凭据或私人账本。
请明确:
- 10分钟从服务器收到请求、受理、创建订单还是写入缓存响应开始?同ID重试会续期吗?
- 去重作用域按账户、App/授权、endpoint或业务操作区分吗?AP/HK与US DC、模拟与真实有无差异?
- R1+同载荷A 与 R1+不同载荷B(仅数量不同)分别返回原响应、明确拒绝,还是其他结果?是否保证不创建第二单?
- 4xx/业务拒绝、5xx以及响应中断分别是否缓存?哪些失败可以明确认定没有订单被创建?
- 没拿到order_id时,有无按client_request_id只读查找原订单的方法?当前订单详情需要order_id,能否提供索引等待上限、终局否定状态或错误码?
- 窗口外及查无结果如何安全恢复?请区分“不在缓存”“尚未可查询”与“最终未受理”,不要把单次查无当作可重发依据。当前各SDK支持透传该字段的最低版本是什么?
参考:
- https://open.longbridge.com/zh-CN/docs/trade/order/submit
- https://open.longbridge.com/zh-CN/docs/trade/order/order_detail
- https://longbridge.github.io/openapi/python/reference_all/
仅咨询接口契约,希望提供正式文档或合成示例;不请求任何账户操作。
Tasks
- 请补充与现行 REST v1 一致的正式契约或合成示例。
- 主要语言
- TypeScript
- 星标
- 61
- 派生
- 30
- 平均合并
- 7 小时 27 分钟
- 30 天内合并 PR
- 19
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
longbridge/developers 的其他 Issue
-
最新版的Python 4.3.2 sdk 根本跑不通这个代码啊可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭
难度 2/5 1-3 小时 新手友好度 65/100
longbridge/developers#1109 ·
维护者通常 1 天内回复
-
难度 4/5 1-2 天 新手友好度 35/100
longbridge/developers#1310 · 3 条评论 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 25/100
longbridge/developers#1309 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 35/100
longbridge/developers#1308 · 3 条评论 ·
维护者通常 1 天内回复
-
SDK5.2.2: clarify HK candle endpoints, daily trading-date labels and revision/adjustment semantics未关闭
难度 4/5 3-5 天 新手友好度 48/100
longbridge/developers#1302 · 1 条评论 ·
维护者通常 1 天内回复
查看 longbridge/developers 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 78/100
home-assistant/frontend#55841 ·
维护者通常 1 天内回复
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
难度 1/5 1 小时以内 新手友好度 76/100
lingdojo/kana-dojo#33905 · 1 条评论 · 5 个 reaction ·
维护者通常 1 天内回复
-
bug(semester-planning): the edit application dialog cannot save with an empty «Annet fra bedriften»未关闭
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
blocklist removal
难度 2/5 1-3 小时 新手友好度 66/100
MetaMask/eth-phishing-detect#311215 ·
维护者通常 1 天内回复
-
Explore filter: multi-select value list with allowNewOptions stops accepting values and drops earlier ones可能已有人在做 @isaac-jaynes-imperva 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
apache/superset#46146 · 1 条评论 ·
维护者通常 2 天内回复