Tapjoy Reporting API快速指南

快速指南

1. 身份驗(yàn)證

請(qǐng)求使用標(biāo)準(zhǔn)的兩層OAuth2身份驗(yàn)證流程：使用publisher reporting api 密鑰請(qǐng)求access_token, 并使用生成的access_token對(duì)后續(xù)的請(qǐng)求進(jìn)行身份驗(yàn)證。Access token的生命周期為1個(gè)小時(shí)，一旦access token過(guò)期，只需使用publisher reporting api 密鑰重新請(qǐng)求新access token即可。

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

A. 請(qǐng)求示例

POST /v1/oauth2/token

Host: api.tapjoy.com

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

Accept: application/json; */*

B. 成功響應(yīng)

status 200

{

  “access_token”: “token_string”,

  “token_type”: “bearer”,

  “expires_in”: 3600,

  “refresh_token”: null

}

C. 無(wú)效憑證響應(yīng)

status 401

{

  “error”: “Bad or missing authentication token”

}

2. 請(qǐng)求數(shù)據(jù)

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

請(qǐng)求示例

GET /v2/publisher/reports?

Host: api.tapjoy.com

Authorization: Bearer [Access token]

Accept: application/json; */*