常见问题
常见问题与解答。
可靠性
1. 数据会丢失吗?
一旦 API 返回 202 Accepted,系统通过3级自动恢复系统保证处理,覆盖约56小时。请求先加入队列,即使数据库故障也不会丢失数据。
2. API 返回 5xx 错误怎么办?
5xx 错误意味着请求未到达我们的系统。您应该在代码中实现指数退避重试逻辑。一旦 API 返回 202,我们保证处理。
定价
1. 有免费试用吗?
有,Free套餐每月包含1,000次请求,永不过期。功能与付费套餐完全相同。包含沙盒和生产环境。随时升级以获得更高限额。
2. 如何变更套餐?
您可以在仪表盘即时升级。降级也立即生效并按比例发放抵扣额度。每个计费周期最多变更一次。
3. 可以退款吗?
30天内未使用可全额退款。30天后或产生任何 API 调用后不可退款,但可继续使用至计费周期结束。
4. Webhook 调用是否计入请求限额?
不计入。即使每次 API 调用触发多个 Webhook,也只算一次请求。
服务
1. 可以创建多少个端点?
无限制。所有套餐均允许创建无限数量的端点。
2. 有每秒速率限制吗?
没有每秒限制。仅限制月度总请求数。
3. 修改配置后现有数据会怎样?
更改仅应用于新请求。现有数据不受影响。
4. Webhook 发送失败怎么办?
会从队列重试——生产环境约 5 小时内共 6 次尝试,沙箱环境约 12 分钟内共 4 次尝试(首次投递算第 1 次)。除 429 外的 4xx 视为永久失败,不再重试。可在日志中查看 Webhook 状态。
5. 可以通过 API 查询存储的数据吗?
可以,您可以使用记录 ID 通过 GET 请求查询单条记录。仪表盘也提供日志搜索功能。
6. 协作密钥和协作者是怎么工作的?
创建协作密钥会发放独立的 API 密钥,您可以邀请多个协作者到每个密钥中进行分组管理。您也可以共享默认 API 密钥,但创建协作密钥并邀请协作者可以按组分离日志和统计数据,便于管理。可以创建多个协作密钥。
7. 我的数据会保留多久?
生产记录至少保留 60 天,之后按月整批删除。沙盒用于测试,记录 30 天后删除;免费套餐的端点本身在创建 7 天后删除。使用统计单独保存,不随记录删除,因此仪表盘图表保持完整。若要在保留期之后仍保有数据,请为端点设置 Webhook,或通过 GET /api/v1/data/<your-slug>/poll 轮询,让记录到达时就进入您自己的系统。
8. 什么是生产控制台?
生产控制台是仅限所有者使用的功能,可从仪表盘直接管理生产数据(创建、读取、更新、删除),无需通过外部 API 调用。在端点详情页的生产标签页中访问。
数据
1. 取消订阅后数据会怎样?
取消后,您的账户将在计费周期结束时切换为Free套餐。此后将无例外地适用Free套餐数据策略:创建超过 7 天的端点会在下一个清理周期被删除,其沙箱与生产数据一并删除。请在取消前下载需要保留的数据。