> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexiumbet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 幂等性 - 使用 clientOrderId 安全重试订单

> clientOrderId 如何让下单在超时或连接中断后可以安全重试，以及如何读取一个您从未收到响应的订单。

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

## 规则

每个订单都带有您自行选定的 `clientOrderId`：1 到 200 个字符，在您的账户内唯一。可以使用您自己系统中的标识符，或在首次尝试之前生成的 UUID。

| 您发送 | 您得到 |
| - | - |
| 从未使用过的 `clientOrderId` | 订单被下达：`201` |
| 相同的 `clientOrderId` 和相同的条款 | 返回已有订单，保持不变：`200`。不会下达任何新订单。 |
| 相同的 `clientOrderId` 但条款不同 | `409 CLIENT_ORDER_ID_REUSED`。不会下达任何新订单。 |

条款包括投注选项、博彩公司、投注额、`minPrice`、`acceptBetterOdds`、`acceptPartialStake` 和 `expiresAt`。这些都相同时，重发的请求视为匹配；两次的 `mode` 都必须是 `"place"`。

预览不存储任何内容，因此仅在预览中使用过的 `clientOrderId` 仍然可用。

## 重试

请使用**相同的请求体**重试，绝不要换新的 `clientOrderId`：

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

## 通过您的标识符读取订单

您也可以在不下单的情况下查询订单：

```bash theme={null}
curl https://api.apexiumbet.com/v1/orders/by-client-id/my-order-0002 \
  -H "x-api-key: apx_live_…"
```

如果没有以该标识符记录的订单，则返回 `404 NOT_FOUND`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.