기술 자료

지원

오퍼월

Monetization 시작하기

UA 시작하기

Unity SDK 연동

오퍼월

API 인증

탭조이 오퍼월 API로 API 요청을 인증하여 캠페인 데이터와 퍼포먼스를 관리합니다.
읽는 시간 1분최근 업데이트: 2일 전

액세스 요청

요청은 표준 2단계의 OAuth2 플로를 사용하여 인증됩니다. 인코딩된 API 키를 사용하여 
access_token
을 요청하고 그에 따른 
access_token
을 사용하여 향후 요청을 인증합니다. 광고주로서 이 키는 광고 대시보드에서 찾을 수 있습니다.
대시보드에 표시되는 광고주 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” }