Reporting API介绍，API接入流程介绍

API是一种应用程序接口，通过API可提供传输数据和服务功能。快手海外商业平台提供Reporting API开放能力，可为广告主/代理商在自有平台本地完成获取广告数据的功能。通过Reporting API功能客户可以获取广告平台的报表查询功能，包括但不限campaign、ad sets、ads层级下的消耗、曝光、点击、转化等数据。

API接入流程：您（开发者）可以通过以下流程，进入账号注册平台，创建开发者账号、管理员为您添加开发者权限、申请应用并向客户申请授权后，才可以通过API方式获取相关数据。具体操作步骤如下：

Step 1: 开发者申请开发者账号进入注册页面，点击注册，可创建开发者账号。

Tips:

1、建议使用公司邮箱注册，并妥善保管账号及密码

2、如当前已有kwai账号，且非开发者角色（如当前账号是优化师角色），暂时无法新增开发者角色

Step 2:

 管理员为开发者创建角色第一步完成后，管理员进入Business Center后，选择添加人员，完善人员信息，选择开发者角色后，即完成了开发者身份注册

Tips：

1、绑定的邮箱需与第一步中开发者申请的邮箱保持一致。

2、管理员为开发者选择的团队需与管理员所在团队保持一致。

3、开发者角色和其他角色无法互换，也就是说开发者无法变更为其他角色，其他角色也无法表更为开发者角色，因此管理员在分配时需注意。

Step 3：开发者申请成为开发者第二步完成，即获得开发者角色，进入business center申请成为开发者，需填写以下信息。

● API Role：指开发者身份，广告主or 代理商。

● Access Level：权限范围。系统会根据开发者Role鉴权判定所拥有的API账户范围。

● APP Name：开发者自定义

● Callback URL：回调地址，开发者自定义，用于授权成功后将授权码回调给开发者，本期不支持更改，请务必填写正确。

Tips：

1、开发者需要确保回调地址能够成功接收回调信息。

2、本期仅支持一个开发者创建一个APP ID。

Step 4: 获得应用（APP ID）平台审核通过后，会返回APP ID信息：

● APP ID：开发者应用ID。每个开发者只允许创建一个APP ID，利用APPID和其他参数组合成授权URL，您就可以向广告主发起授权申请了。

● Secret ID：应用密钥。每个APPID都对应唯一密钥，secret用于获取access token以及获取授权账户。

● Authorization URL：授权URL，授权链接的回调地址。

Step 5：获得授权

● 复制授权url，在同一个浏览器打开新的tag 页，将授权url（包含自定义参数）在地址栏中执行

● 浏览器按预留【回调地址】进行跳转，并在跳转后的url上拼接上【授权码】和透传的【自定义参数】

Step 6：获取Acces Token

● 使用上一步获得的授权码，拼接获取token请求：https://developers.kwai.com/oauth/token?grant_type=authorization_code&code={your auth code}&client_id={your client id}&client_secret={your secret key}&redirect_uri={your redirect url}

● 代码中使用http client或类似http工具以GET请求方式触发

● 如果所有参数参数正确，认证服务会返回一组token信息，

Step 7：获取数据万事俱备，接下来就通过API接口获取数据吧

Step 8：刷新token

● refresh_token有效期默认半年

● 需要开发者自行判断token过期时间，提前使用refresh_token换取新的token，才能继续请求海外开放平台接口，注意:请求里的参数必须和app 详情里的内容一致，否则请求失败

● refresh_token没有失效的情况下，拼接刷新token请求，使用refresh_token重新获取一组token即可

● refresh_token如果过期，只能重新走Step5 - 6获取新的token、refresh_token

相关文章推荐：什么是Pixel，怎么创建Pixel

（来源：出海记事本）

以上内容属作者个人观点，不代表雨果跨境立场！如有侵权，请联系我们。