API認証

1. アクセス要求

標準的な2-legged OAuth2によりリクエストは認証されます: エンコードされたAPI Key を使用して access_token を要求し、取得した access_token がそれ以降のリクエストの認証に使用されます。

広告主の場合、このキーは Ad dashboard から取得できます。

image_title

アクセストークンの有効期間は一時間で、リフレッシュはできません。トークンの有効期限が切れた場合には、 Publisher Reporting API Key/Marketing API Key を使用して新しいトークンを取得してください。

アクセストークンをリクエストするには、APIキーを使用して Authorization ヘッダーを含む POST リクエストを送信する必要があります。資格情報が有効な場合、レスポンスにはアクセストークンとトークンの有効期限が切れるまでの秒数が含まれます。

リクエスト例

Raw

Curl

Ruby

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” 
}

2. アクセストークンの使用

access_token を取得すれば、目的のAPIへのリクエストができるようになります。 access_token はAPIリクエストのすべての Authorization ヘッダに "Bearer" タイプとして含める必要があります。 access_token の有効期限が切れていた場合やヘッダが含まれなかった場合、レスポンスのステータスは 401 Unauthorized となります。

リクエスト例

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

トークンがない/無効な場合のレスポンス例

status 401 
{ 
“error”: “Unauthorized” 
}

API認証

1. アクセス要求

2. アクセストークンの使用

Contents