API 인증

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

읽는 시간 2분

최근 업데이트: 9시간 전

액세스 요청

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

access_token

을 요청하고 그에 따른

access_token

을 사용하여 향후 요청을 인증합니다.

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

액세스 토큰의 수명은 1시간이며 새로 고침할 수 없습니다. 토큰이 만료되면 리포트 API 키나 마케팅 API 키를 사용하여 새 토큰을 요청해야 합니다.

액세스 토큰을 요청하려면 API 키를 사용하여 인증 헤더가 있는 POST 요청을 보내야 합니다. 자격 증명이 유효하면 응답에 액세스 토큰과 토큰 만료까지 남은 시간(초 단위)이 포함됩니다.

요청 예시

다음 예시는 원시 HTTP, curl, Ruby를 사용하여 액세스, 접근 토큰 요청하는 방법을 보여 줍니다.


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']

성공적인 대응

성공적으로 요청하면 액세스, 접근 토큰 포함된 200 상태와 만료 기간 초 단위로 반환됩니다.


status 200 { "access_token": "token_string", "token_type": "bearer", "expires_in": 3600, "refresh_token": null }

응답 실패

API 키가 유효하지 않거나 누락되면 요청에 401 상태가 반환됩니다.


status 401{ "error": "유효하지 않음" }

액세스 토큰 사용

access_token

이 있으면 API에 요청을 생성할 수 있습니다.

access_token

는 인증 헤더의 모든 요청과 함께 ‘Bearer’ 유형으로 전송되어야 합니다.

access_token

이 만료되었거나 존재하지 않으면 응답은 401 Unauthorized 상태가 됩니다.

요청 예시

다음 예제는 인증된 API 요청에 필요한 헤더를 보여줍니다.


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

누락/유효하지 않은 토큰 응답

액세스, 접근 토큰 누락되었거나 만료되면 요청에 401 상태가 반환됩니다.


status 401 { "error": "유효하지 않음" }

기술 자료

Development

User Acquisition

Monetization

산업 분야

기술 자료

Development

User Acquisition

Monetization

산업 분야

Unity 오퍼월

Offerwall Android SDK

Offerwall iOS SDK

Offerwall Unity SDK

Unity 오퍼월

API 인증

액세스 요청

요청 예시

성공적인 대응

응답 실패

액세스 토큰 사용

요청 예시

누락/유효하지 않은 토큰 응답