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

授权

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

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

请求格式

Headers

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

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

请求体

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

频率限制

每个 API 密钥每秒最多发送 2 个请求。超出此限制将返回 429 Too Many Requests 错误。

轮换 API 密钥

如需轮换私密 API 密钥：

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

下一步：请求：