Tapjoy Reporting API快速指南

快速指南

1. 身份驗證

請求使用標準的兩層OAuth2身份驗證流程：使用publisher reporting api 密鑰請求access_token, 并使用生成的access_token對后續(xù)的請求進行身份驗證。Access token的生命周期為1個小時，一旦access token過期，只需使用publisher reporting api 密鑰重新請求新access token即可。

密鑰必須以管理員賬戶登錄時在控制面板（設置-應用設置）獲取。如果不是管理賬戶下獲取到的密鑰，即使數據可用，API也可能返回“空”。

A. 請求示例

POST /v1/oauth2/token

Host: api.tapjoy.com

Authorization: Basic [base_64(Publisher Reporting API Key)]

Accept: application/json; */*

B. 成功響應

status 200

{

  “access_token”: “token_string”,

  “token_type”: “bearer”,

  “expires_in”: 3600,

  “refresh_token”: null

}

C. 無效憑證響應

status 401

{

  “error”: “Bad or missing authentication token”

}

2. 請求數據

一旦得到access_token就可以開始后續(xù)的API請求。access_token需要在每個請求中以“Bearer”類型填入Authorization header。如果access_token已經過期或者不存在，將會返回401 Unauthorized。token生命周期是1小時。

請求示例

GET /v2/publisher/reports?

Host: api.tapjoy.com

Authorization: Bearer [Access token]

Accept: application/json; */*