导出分析 API 的授权与请求格式

授权

你需要使用私密 API 密钥作为 Authorization 请求头来验证 API 请求。你可以在 App Settings 中找到它。格式为 Api-Key {YOUR_SECRET_API_KEY},例如:Api-Key secret_live_...。

Important

API 密钥是按应用区分的。如果你有多个应用,请确保为每个应用使用不同的密钥。

请求格式

Headers

服务端 API 请求需要特定的请求头和 JSON 请求体。请参考以下说明构建请求:

请求头描述
Content-Type(必填)设置为 application/json,API 才能正常处理请求。
Adapty-Tz(可选)设置时区,以定义数据的分组和显示方式。请使用 IANA 时区数据库格式(例如 Europe/Berlin)。

请求体

API 需要一个 JSON 格式的请求体,其中包含请求所需的数据。

速率限制

每个应用每秒最多允许 2 次请求。同一应用的所有 API 密钥共享此限制,因此增加密钥并不会提升请求容量。超出限制时将返回 429 Too Many Requests 错误。

Adapty 还对所有应用的 API 总流量设有上限,因此即使您的应用未超出自身限制,请求偶尔也可能失败并返回 429。响应中不包含 Retry-After 标头。如需恢复,请等待最多一分钟,然后采用指数退避策略进行重试。

轮换 API 密钥

如需轮换私密 API 密钥:

  1. 在 Settings → General 中,点击 Generate new key,然后点击旧密钥旁边的垃圾桶图标。
  2. 更新应用中使用的密钥。

下一步:请求: