行为规则
- 首次请求
heartbeatId传空串;之后传上一次响应返回的heartbeatId。 - 每次响应返回新的
heartbeatId,旧 id 立即失效。 - 建议每 5s 一次。10s 内未收到有效心跳,撤掉全部挂单,订单
cancelReason记HEARTBEAT_TIMEOUT。 heartbeatId不匹配返回 409HEARTBEAT_ID_MISMATCH,响应带当前有效的 id。同一把 key 被两个进程使用时会触发此错误。
定期发送心跳。超时未收到时,服务端撤掉本人全部挂单。
请求头 X-PX-Key: pxk_…。本端点需要 cancel 作用域,作用域不足返回 403 而不是 401;这条线不用 Bearer 会话。申请与限额见 接入总览。
heartbeatId 传空串;之后传上一次响应返回的 heartbeatId。heartbeatId,旧 id 立即失效。cancelReason 记 HEARTBEAT_TIMEOUT。heartbeatId 不匹配返回 409 HEARTBEAT_ID_MISMATCH,响应带当前有效的 id。同一把 key 被两个进程使用时会触发此错误。