跳转到主要内容
# Dry run (recommended)
curl -X DELETE "https://api.poixe.com/v1/recoveries?all=true&dry_run=true" \
  -H "Authorization: Bearer $POIXE_API_KEY" \
  -H "Content-Type: application/json"

# Real delete
curl -X DELETE "https://api.poixe.com/v1/recoveries?all=true" \
  -H "Authorization: Bearer $POIXE_API_KEY" \
  -H "Content-Type: application/json"
{
  "deleted": 2,
  "message": "All recovery records deleted successfully.",
  "reason": "OK"
}
DELETE https://api.poixe.com/v1/recoveries?all=true
删除当前用户的全部暂存记录。该操作为破坏性操作,必须显式携带 all=true 作为确认参数(防误触)。 你也可以先使用 dry_run=true 进行预演:仅返回预计删除数量,不执行真实删除。

鉴权与请求头

所有 API 请求都必须在 HTTP Header 中包含您的 API 密钥。
Authorization
string
必填
Bearer Token。格式为 Bearer YOUR_API_KEY
Content-Type
string
必填
必须设置为 application/json

Query 参数

all
string
必填
必须为 true。用于确认执行“删除全部”。
dry_run
string
可选:为 true 时仅预演,不执行删除;响应会返回 would_delete

响应结构

deleted
integer
实际删除数量(dry_run 时通常为 0)。
would_delete
integer
仅在 dry_run 返回:预计将删除数量。
message
string
结果描述。
reason
string
结果原因(如 OK / DRY_RUN / CONFIRMATION_REQUIRED)。
建议先调用 DELETE /v1/recoveries?all=true&dry_run=true 确认数量,再执行真实删除: DELETE /v1/recoveries?all=true