跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

【热】如何通过API获取统计数据? ⭐️

友盟+ 提供 OpenAPI 接口服务,帮助开发者通过程序化方式获取统计数据。申请和使用 OpenAPI 是免费的,但需经过认证与审核流程。

一、OpenAPI 使用流程:

  1. 申请权限

    请使用已接入产品的账号登录友盟官网,前往【开发者中心】→【OpenAPI】页面,申请开通 OpenAPI 使用权限。

    OpenAPI 权限一经开通,无需重复判断。

  2. 了解调用规则

    开通后,请根据官方提供的 [OpenAPI 调用文档] 进行接口调用,确保参数、签名及请求格式符合规范。

  3. 获取身份凭证(apikey 与 apiSecurity)

    登录友盟官网 → 顶部导航栏点击【开发者中心】→【OpenAPI】→【如何使用 OpenAPI】→【获得身份认证信息】,即可查看您的 apikey 和 apiSecurity。

    查看地址:[已开通的Open API]

二、流控限制说明:

为保障系统稳定性,OpenAPI 接口设有流控规则,若调用频率超出限制,将返回如 403 等错误提示。

  • 账号级接口:基于账号进行流控:

    • 单个 API 全局每分钟最多 1000 次;

    • 每个账号每分钟最多 30 次。

  • 应用级接口:基于 Appkey 进行流控:

    • 单个 API 全局每分钟最多 1000 次;

    • 每个 Appkey 每分钟最多 30 次。

建议合理安排调用频率,避免短时间内高频请求。

三、常见问题排查:

  1. OpenAPI 未开通?

    • 主要原因可能是当前申请账号不是主账号,请确认使用的是主账号操作。

  2. 调用提示 “ApiKey is not allowed”?

    可能原因如下,请逐一排查:

    • 尚未开通 OpenAPI 权限;

    • 未申请单个 Appkey 的接口权限;

    • 调用接口的账号不是主账号,也未被授权对应 Appkey 的查询权限;

    • 若使用自定义权限,请确认是否勾选了“客户端访问”选项;

    • 请求时缺少关键参数,如 apikey、apiSecurity、appkey 等。

  3. 如何申请单个 Appkey 的 OpenAPI 接口权限?|

    • 仅主账号可为 Appkey 开通接口权限,请前往【开发者中心】→【OpenAPI】页面申请开通。

如您在使用过程中仍有疑问或遇到其他异常情况,欢迎查阅 OpenAPI 官方文档或联系我们在线客服团队,我们将为您提供详细指导。