API 授权

1. 请求访问

请求使用标准的两层OAuth2进行身份验证:使用API密钥请求access_token,生成的access_token用于针对未来的请求进行身份验证。访问token的有效期为 1 小时且无法刷新 - 一旦令牌过期,您只需使用您的发布者报告API密钥/Marketing API密钥请求一个新的。

请求示例

POST /v1/oauth2/token 
Host: api.tapjoy.com 
Authorization: Basic <Publisher Reporting API Key> 
Accept: application/json

正确响应

status 200 
{ 
“access_token”: “token_string”, 
“token_type”: “bearer”, 
“expires_in”: 3600, 
“refresh_token”: null 
} 

错误凭据响应

status 401
{ 
“error”: “Unauthorized” 
} 

2. 使用访问Token

一旦有了一个 access_token,就可以使用API发出请求。 在每个请求中把access_token在Authorization header使用,类型为“Bearer”。 如果“access_token”已过期或不存在,则响应的状态为 401 Unauthorized。

请求示例

POST /v4/audiences 
Host: api.tapjoy.com 
Authorization: Bearer <token_string> 
Accept: application/json

没有/无效Token响应

status 401 
{ 
“error”: “Unauthorized” 
}