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

# 中断响应找回

Base URL
`https://api.poixe.com/v1/recoveries`

Recoveries（中断响应找回）用于解决一种常见情况：你发起了 **非流式请求（stream=false）**，上游模型实际上已经成功生成了结果，但由于连接中断，你在客户端侧没有收到响应。

在这种情况下，请求通常仍会被上游完成并产生计费。为避免因重复请求造成不必要的资源与费用浪费，Poixe 会将该次请求的关键数据与响应结果 **暂存**，你可以在请求失败后尝试把结果找回。

**提示：** Recoveries 接口不会额外收费，仅在请求发生中断时才会产生暂存记录。

## 适用场景

当非流式请求在客户端表现为失败/超时，但你怀疑上游可能已经完成处理时，优先使用 Recoveries：

* 客户端网络断开或波动导致连接中断
* CDN / 代理层强制超时或断开连接
* 服务端短暂波动导致连接被关闭
* 请求耗时较长，客户端超时先于上游完成

## 场景演示：请求中断后如何找回（核心步骤）

**1. 发起一次非流式请求（stream=false）**

例如调用 Chat Completions / Responses 等接口，并使用 `stream=false`（非流式响应）。

**2. 连接中断：客户端显示失败，但上游可能已完成**

常见原因包括：客户端网络断开、CDN 强制超时、服务端短暂波动导致断开连接。

**提示：** 非流式请求可能已经被上游正常处理并完成计费，只是结果没能回传到客户端。
建议先尝试找回，再决定是否重试，避免重复扣费。

**3. 系统自动暂存这次请求的结果**

Poixe 会将本次请求与响应结果暂存为一条 recovery 记录，供后续找回使用。

**提示：** 这一步由系统自动完成，你无需进行任何额外操作。

**4. 获取 request\_id（任选其一）**

你可以通过以下任意方式获取 `request_id`：

* **方式 A：控制台** [日志页面](https://poixe.com/log) 查看对应请求日志，直接拿到 `request_id`
* **方式 B：调用** [列出暂存响应](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/list.md) 获取列表中的 `request_id`
* **方式 C：调用** [lookup 反查](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/lookup.md)，提交原始请求 JSON，返回候选记录并拿到 `request_id`

**5. 通过 request\_id 找回完整内容**

使用 
[获取暂存响应详情](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/get.md)：
`GET /v1/recoveries/{request_id}`，即可获取原始请求与完整响应体。

**6. 可选：清理暂存记录**

找回完成后，你可以选择：

* 删除单条：[删除一条暂存响应](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/delete.md)
* 删除全部：[删除所有暂存响应](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/delete-all.md)（支持 `dry_run` 预演）

## 接口一览（推荐顺序）

> **[列出暂存列表](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/list.md)**
>
> GET /v1/recoveries

> **[获取详情（找回响应）](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/get.md)**
>
> GET /v1/recoveries/{request_id}

> **[lookup 反查（无 request\_id）](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/lookup.md)**
>
> POST /v1/recoveries/lookup

> **[删除单条暂存](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/delete.md)**
>
> DELETE /v1/recoveries/{request_id}

> **[删除全部暂存（支持 dry\_run）](https://docs.poixe.com/cn/api-reference/extension-api/recoveries/delete-all.md)**
>
> DELETE /v1/recoveries?all=true

## 暂存保留时间与清理策略

Recoveries 暂存记录默认保留 **3 天**，超过保留期将自动清理删除。

如果你希望立即清理，可主动调用删除接口（单条或全部）。

## 数据安全与合规

Poixe 遵守严格的数据与安全规范。Recoveries 暂存数据仅用于帮助你找回中断请求的响应结果，并受鉴权控制（仅当前用户可访问自身记录）。

我们不会对这些数据进行任何使用、处理或分析，也不会用于任何目的；数据仅按保留期策略临时保存，并在到期后自动清理。

## 长耗时请求建议：使用裸接口规避 CDN 强制超时

主接口经过 CDN 转发，存在固定的连接超时策略。对于可能耗时较长的请求（例如长输出、复杂工具链或较长思考），连接可能在响应返回前被 CDN 提前关闭。

为避免这类中断，你可以将主接口替换为 **裸接口（无 CDN）**。Poixe 提供两个裸接口（dc8 / dc15），可直接作为主接口的替代地址使用，从而免受 CDN 强制超时的影响。

如果你对可用性有更高要求，建议在客户端同时配置 **dc8 与 dc15**，并在请求失败时自动切换，以提升稳定性。

相关背景与选择建议可参考：[接口地址（Base URL）](https://docs.poixe.com/cn/api-reference/introduction/base-url.md)


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