跳转到主要内容
网络可能在订单已下达之后丢掉下单的响应。如果没有安全重试的办法,您只能在漏掉订单和重复下单之间二选一。clientOrderId 消除了这种取舍。

规则

每个订单都带有您自行选定的 clientOrderId:1 到 200 个字符,在您的账户内唯一。可以使用您自己系统中的标识符,或在首次尝试之前生成的 UUID。 条款包括投注选项、博彩公司、投注额、minPrice、acceptBetterOdds、acceptPartialStake 和 expiresAt。这些都相同时,重发的请求视为匹配;两次的 mode 都必须是 "place"。 预览不存储任何内容,因此仅在预览中使用过的 clientOrderId 仍然可用。

重试

请使用相同的请求体重试,绝不要换新的 clientOrderId:
  • 超时或连接中断。 重发请求。如果订单已下达,您会得到该订单;否则现在下达。
  • 502 UPSTREAM_UNAVAILABLE。 博彩公司网关没有响应,订单可能已存在。重发请求:如果订单已被记录,就会返回该订单。
  • 409 PREVIOUS_ATTEMPT_UNRESOLVED。 使用该 clientOrderId 的先前尝试仍在与博彩公司处理中。请等待几秒后重发。
  • 一般的 5xx。 使用退避重发。
  • 上述之外的 4xx。 请求本身有误:请先修正再重新发送。

通过您的标识符读取订单

您也可以在不下单的情况下查询订单:
如果没有以该标识符记录的订单,则返回 404 NOT_FOUND。