归档

概述

归档是可以按日期下载超过 30 天的生产环境数据的页面。适用于分析、备份以及将数据迁移至外部系统。

归档策略

• 仅限生产环境。 沙盒环境数据不会被归档，并会在 30 天后自动删除
• 生产环境数据在您的账户有效期内永久保留，可随时在日志页面查看
• 超过 30 天的生产环境数据会自动归档，并可从本页按日期下载
• 归档文件以每日为单位创建
• 提供两种下载格式：JSONL（.jsonl.gz） 或 CSV
• 可直接用于 pandas、DuckDB、jq、Jupyter 等工具进行分析

如何进入

• 顶部菜单 归档 → 从列表中选择要下载的端点

---

端点列表

页面顶部显示一张信息卡片，汇总保留策略和文件格式。其下方的 查看数据结构 折叠面板可展开，预览归档文件的字段结构（与下方"归档文件结构"章节内容一致）。

再往下是一个表格，列出有归档数据的端点。

列	说明
端点	端点名称
文件数	归档文件数量（每日）
总大小	所有归档文件的合计大小
日期范围	最早到最新的归档日期
最新	最近一次归档文件的日期

点击某个端点即可进入归档文件列表页面。

归档文件列表

选择某个端点后，会显示其每日归档文件。

列	说明
日期	归档目标日（UTC）
记录数	当日记录的 API 调用次数
文件大小	压缩后的 JSONL.gz 文件大小
下载	JSONL / CSV 按钮

两种下载格式

JSONL（.jsonl.gz）

• 单日生产环境记录使用 gzip 压缩
• 每行包含一条 JSON 格式的记录
• 保留原始格式 — 适用于程序化分析、备份和再处理
• 示例：

  {"id":"rec_...","payload":{"order_id":"ORD-001"},"status":"success","created_at":"..."}
  {"id":"rec_...","payload":{"order_id":"ORD-002"},"status":"success","created_at":"..."}
  

CSV（.csv）

• 适合电子表格的格式
• 系统字段排在前面，其后是带 payload_ 前缀的扁平化业务字段
• 示例：payload.customer.name → payload_customer_name
• 可直接在 Excel、Google Sheets 等中打开
• 注意：CSV 转换根据文件大小可能需要一些时间，且仅在 PC 浏览器中可用（因需要处理大文件）

归档文件结构

下载的归档文件中每条记录的字段结构。JSONL 中每行为一条记录。CSV 中系统字段在前，其后是带 payload_ 前缀的扁平化业务字段。

字段	说明
id	记录 ID
payload	业务数据（JSON）
config_version	配置版本
status	处理结果（success / failed）
error_details	错误详情（失败时）
created_at	创建时间
updated_at	更新时间
endpoint_name	端点名称
endpoint_slug	端点 URL 路径
collaboration_key_name	调用方密钥名称
gateway_processing_time_ms	处理时间（毫秒）

---

常见问题

• 归档列表为空：生产环境数据必须超过 30 天才会被归档。更新的数据请在日志页面查看
• 移动端无法下载 CSV：CSV 转换需要大量处理，仅支持 PC 浏览器。JSONL 可在移动端下载
• 在电子表格中打开 CSV 时非英文字符乱码：CSV 文件为 UTF-8 编码。在电子表格中打开时请将字符编码指定为 UTF-8 以避免乱码
• 免费套餐可以下载归档吗？：归档是付费套餐的功能。免费套餐端点在创建后 7 天自动清理，因此无需归档