API の認証

Tapjoy Offerwall API で API リクエストを認証し、ユーザーエンゲージメントと収益化データを管理するための承認済みアクセスを取得します。

読み終わるまでの所要時間 1 分

最終更新 5日前

アクセスのリクエスト

リクエストは、標準の two-legged OAuth2 フローを使用して認証されます。つまり、エンコードされた API キーを使用して

access_token

がリクエストされ、その結果の

access_token

を使用して今後のリクエストに対して認証が行われます。 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 = <<~ENDquery {  user {    firstName  }}ENDjson = JSON.dump({query: query})http = Net::HTTP.new('api.tapjoy.com', 443)http.use_ssl = truerequest = Net::HTTP::Post.new('/graphql')request['Authorization'] = "Bearer #{access_token}"request.body = jsonresponse = 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” }

アクセストークンの使用

access_token

を取得したら、API にリクエストできます。

access_token

は、承認ヘッダー内の "Bearer" タイプのすべてのリクエストとともに送信する必要があります。

access_token

が期限切れであるか存在しない場合、レスポンスの状態は 401 Unauthorized になります。 リクエストの例


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

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


status 401 { “error”: “Unauthorized” }

ドキュメント

エンジン

サービス

Grow

産業

サポート

Offerwall

収益化の開始

ユーザー獲得の開始

Unity SDK の統合

Offerwall

API の認証

アクセスのリクエスト

アクセストークンの使用