Fileverity API 文档
数据保留与安全
Fileverity API 存储哪些数据、保留多久：上传的文件、结果、文本、请求日志和 Webhook 投递记录，以及密钥和端点如何受到保护。
查看 Markdown更新于 2026-11-04
本页列出 API 保留的数据及保留时长。更全面的说明，参见信任与安全。
保留期
| 数据 | 保留期 | 说明 |
|---|---|---|
| 上传的文件 | 分析开始时删除，最迟 24 小时后删除 | 私密存储。DELETE /files/{id} 可更早删除文件。 |
您发送到 POST /text/detections 的文本 | 不存储 | 评估后即丢弃。从不存储，因此之后无法再取回。 |
| 文本检测结果（绝不含文本本身） | 7 天 | 判定、分数、段落偏移量和用量。显示在控制台的历史检测中。测试密钥不记录任何内容。 |
| 分析结果 | 7 天 | 之后结果会被删除。报告的核验记录仍可查看。 |
| 文档证据（页面图片、文本摘录） | 3 小时 | 请在此之前下载 PDF 报告，以保留其中的证据。 |
| 请求日志 | 30 天 | 方法、路径、状态、耗时、错误码和密钥。不含请求体或响应体。 |
| Webhook 投递记录 | 30 天 | 事件的请求内容、状态、响应时间，以及您的端点所返回响应的前 2 KB。控制台中显示最近 50 条。 |
| 幂等记录 | 24 小时 | 已保存的响应，用于重放重试的请求。对于文本检测，则是不含文本的结果。 |
保护措施
- 仅限 HTTPS：所有 API 流量均使用 HTTPS。
- 密钥：仅存储密钥的 SHA-256 哈希值和最后四个字符。密钥可随时撤销。参见身份验证与密钥。
- 工作区隔离：文件、分析、密钥、Webhook 和日志只属于一个工作区和一种模式；Live 密钥和测试密钥无法读取彼此的文件。
- 支出上限：按密钥设置的每月上限，限制了泄露的密钥所能产生的最大支出。
- Webhook：每次投递都使用各端点独立的密钥签名。端点必须使用 HTTPS 和公网地址；私有地址和内部地址会被拒绝。不会跟随重定向。
- 可核验的报告：图片和文档报告带有报告编号、SHA-256 指纹和 RFC 3161 时间戳，并设有公开核验页。
企业版
企业版客户可按需获得私有化部署。请联系我们洽谈。