Unity Offerwall Offerwall の収益化 API の認証 Tapjoy Offerwall API で API リクエストを認証し、ユーザーエンゲージメントと収益化データを管理するための承認済みアクセスを取得します。
読み終わるまでの所要時間 1 分
最終更新 2ヶ月前 アクセスのリクエスト
リクエストは、標準の two-legged OAuth2 フローを使用して認証されます。つまり、エンコードされた API キーを使用して がリクエストされ、その結果の を使用して今後のリクエストに対して認証が行われます。
API キーは、LTV ダッシュボード で App (アプリ) > Settings (設定) > App Settings (アプリ設定) を選択し、下にスクロールして API Keys (API キー) を選択することで確認できます。
アクセストークンの生存期間は 1 時間であり、更新することはできません。トークンが期限切れになった場合は、Reporting API キー/Marketing API キーを使用して新しいトークンをリクエストする必要があります。
アクセストークンをリクエストするには、API キーを使用して承認ヘッダーを含む POST リクエストを送信する必要があります。認証情報が有効な場合、そのレスポンスにはアクセストークンと、トークンが期限切れになるまでの秒数が含まれます。
リクエストの例
POST /v1/oauth2/token Host: api.tapjoy.com Authorization: Basic <API Key> Accept: application/json
curl -H "Authorization: Basic <API Key>" -X POST https://api.tapjoy.com/v1/oauth2/token
require 'json' require 'net/https' access_token = "<OAuth Token>" query = <<~END query { user { firstName } } END json = JSON.dump({query: query}) http = Net::HTTP.new('api.tapjoy.com', 443) http.use_ssl = true request = Net::HTTP::Post.new('/graphql') request['Authorization'] = "Bearer #{access_token}" request.body = json response = http.request(request) result = JSON.parse(response.body) data = result['data'] errors = result['errors']
成功のレスポンス
status 200 { “access_token”: “token_string”, “token_type”: “bearer”, “expires_in”: 3600, “refresh_token”: null }
失敗のレスポンス
status 401 { “error”: “Unauthorized” }
アクセストークンの使用
を取得したら、API にリクエストできます。 は、承認ヘッダー内の "Bearer" タイプのすべてのリクエストとともに送信する必要があります。 が期限切れであるか存在しない場合、レスポンスの状態は 401 Unauthorized になります。
リクエストの例
POST /v4/audiences Host: api.tapjoy.com Authorization: Bearer <token_string> Accept: application/json
トークンがない/無効なトークンのレスポンス
status 401 { “error”: “Unauthorized” }