API 인증

탭조이 오퍼월 API를 사용하여 API 요청을 인증해 사용자 참여와 수익화 데이터를 관리할 수 있는 인증된 액세스를 확보합니다.

읽는 시간 1분

최근 업데이트: 2달 전

액세스 요청

요청은 표준 2단계의 OAuth2 플로를 사용하여 인증됩니다. 인코딩된 API 키를 사용하여

access_token

을 요청하고 그에 따른

access_token

을 사용하여 향후 요청을 인증합니다. App > Settings > App Settings를 선택하고 화면을 스크롤한 후 API Keys를 선택하여 LTV 대시보드에서 API 키를 확인할 수 있습니다.

액세스 토큰의 수명은 1시간이며 새로 고침할 수 없습니다. 토큰이 만료되면 리포트 API 키나, 마케팅 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

산업 분야

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월

API 인증

액세스 요청

액세스 토큰 사용