文档

支持

API 身份验证

使用 Tapjoy Offerwall API 时对 API 请求进行身份验证,从而获得授权访问权限来管理用户参与度和变现数据。
阅读时间1 分钟最后更新于 4 天前

请求访问权限

这些请求通过标准的双边 OAuth2 流程完成身份验证:先用编码后的 API 密钥来请求
access_token
,然后用获得的
access_token
对后续请求进行身份验证。
您可以在 LTV 后台中选择 App(应用)> Settings(设置)> App Settings(应用设置)> 向下滚动 > API Keys(API 密钥)找到 API 密钥。
后台中显示的 Marketing API 密钥
访问令牌的有效生命周期为 1 小时,无法刷新。当令牌到期后,必须使用 Reporting API 密钥/Marketing API 密钥来请求新的令牌。 要请求访问令牌,必须使用 API 密钥发送带有 Authorization 标头的 POST 请求。如果凭据有效,则响应中将包含一个访问令牌以及令牌到期时间(以秒为单位)。 请求示例
POST /v1/oauth2/token Host: api.tapjoy.com Authorization: Basic <API Key> Accept: application/json
成功响应
status 200 { “access_token”: “token_string”,“token_type”: “bearer”,“expires_in”: 3600,“refresh_token”: null }
失败响应
status 401{ “error”: “Unauthorized” }

使用访问令牌

获得
access_token
后,即可向 API 发出请求。每个请求都需要在 Authorization 标头中包含“Bearer”类型的
access_token
。如果
access_token
已过期或不存在,则响应的状态将是 401 Unauthorized(未经授权)。
请求示例
POST /v4/audiences Host: api.tapjoy.com Authorization: Bearer <token_string> Accept: application/json
令牌缺失/无效令牌响应
status 401 { “error”: “Unauthorized” }