Offers API. 디자인은 내 것, 오퍼는 Moonetix가.

각 사용자의 오퍼를 이미지, 단계, 내 화폐로 계산된 리워드와 함께 JSON으로 받아, 자체 카드에 담아 내 콘텐츠 옆에 표시하세요. 리워드는 오퍼월과 마찬가지로 postback으로 전달됩니다.

  • JSONHTTPS 기반 REST
  • 600분당 요청 수
  • OpenAPI사양 포함
Offers APIREST, JSON
터미널
curl -G "https://api.moonetix.com/v1/offers" \
  -d user_id=user_1234 -d country=US -d device=android \
  -H "Authorization: Bearer $MOONETIX_API_KEY"

세 단계로 시작하세요.

코드를 복사하고, 자리 표시자를 대시보드의 오퍼월, 해당 오퍼월, 연동에 있는 값으로 바꾼 다음 출시 전에 테스트하세요.

  1. 사용자 한 명의 오퍼 요청

    앱의 API 키, 사용자 ID, 사용자가 있는 국가, 기기 또는 user agent를 담아 서버에서 API를 호출하세요. 목록에서는 사용자가 이미 완료했거나 아직 다시 할 수 없는 오퍼가 제외됩니다.

    터미널
    curl -G "https://api.moonetix.com/v1/offers" \
      -d user_id=user_1234 -d country=US -d device=android \
      -H "Authorization: Bearer $MOONETIX_API_KEY"
  2. 자체 디자인으로 표시

    각 오퍼에는 제목, 이미지, 단계, 내 화폐로 표시된 리워드가 포함됩니다. 원하는 방식으로 표시하고, 사용자가 오퍼를 고르면 해당 오퍼의 start_url로 보내세요. 오퍼 페이지가 Moonetix에서 열리고, 그곳에서 광고주에게 연결됩니다.

    JSON
    {
      "ok": true,
      "currency": "Coins",
      "offers": [
        {
          "id": 58,
          "title": "Nova Quest: reach level 10",
          "reward": 975,
          "payout_usd": 1.5,
          "start_url": "https://wall.moonetix.com/..."
        }
      ]
    }
  3. postback으로 리워드 적립

    모든 리워드는 서명된 postback으로 서버에 전달됩니다. 해시를 확인하고, 거래 ID당 한 번만 리워드를 추가하고, 이후 postback이 취소를 알리면 회수하세요. 실패한 postback은 최대 5회까지 재시도됩니다.

    Postback 매크로 및 재시도

    대시보드, Postback 탭
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
GET /v1/offers
{
  "title": "Nova Quest: reach level 10",
  "goals": [
    { "name": "Create an account", "reward": 325 },
    { "name": "Reach level 10", "reward": 650 }
  ],
  "reward": 975,
  "start_url": "https://wall.moonetix.com/..."
}
내 디자인
Nova Quest레벨 10 달성
  1. 계정 만들기+325
  2. 레벨 10 달성+650
합계975 코인오퍼 시작

JSON에서 내 디자인으로

각 오퍼는 단계와 리워드가 이미 내 화폐로 계산된 상태로 전달되어 바로 표시할 수 있습니다.

API가 제공하는 것

  • 사용자별 오퍼

    오퍼는 전송한 국가와 기기에 맞춰지며, 사용자가 이미 완료한 오퍼는 제외됩니다.

  • 내 화폐로 지급되는 리워드

    모든 리워드는 환율, 사용자 배분율, 반올림, 진행 중인 보너스까지 반영해 미리 계산됩니다.

  • 단계와 이미지

    다단계 오퍼는 단계마다 리워드를 따로 표시하므로, 무엇이 얼마를 지급하는지 정확히 보여 줄 수 있습니다.

  • Sub ID

    원하는 값을 최대 5개까지 보내세요. 모든 start_url에 추가되고 postback으로 다시 돌아옵니다.

  • 숨긴 오퍼는 계속 숨겨집니다

    오퍼 페이지에서 숨긴 오퍼는 API에서도 제외되므로 오퍼월과 일치합니다.

  • OpenAPI 사양

    기계가 읽을 수 있는 openapi.json이 모든 필드를 설명하므로 코드 생성기와 AI 코딩 에이전트에서 바로 사용할 수 있습니다.

테스트한 다음 출시하세요.

실제 사용자가 오퍼월을 보기 전에 확인해야 할 모든 것을 대시보드에 내장된 도구로 점검하세요.

  1. 테스트 사용자로 열기

    연동 탭의 연동 상태에서 owner-test 사용자로 오퍼월을 여세요. 테스트 방문은 사용자로 집계되지 않습니다.

  2. curl로 API 호출하기

    테스트 사용자 ID와 오퍼가 운영되는 국가로 목록을 요청하고, start_url 하나를 브라우저에서 열어 보세요.

  3. 테스트 postback 보내기

    사용자, 상태, 지급액을 선택하고 서버가 어떻게 응답했는지 응답 코드와 시간까지 정확히 확인하세요. 테스트 거래 ID는 test_로 시작합니다.

  4. 일반 연결에서 테스트

    VPN, 프록시, Tor, 클라우드 네트워크는 차단되므로, 오퍼가 운영되는 국가에서 가정용 Wi-Fi나 모바일 데이터로 테스트하세요.

출시 체크리스트

10개 중 0개 준비됨

자주 발생하는 오류, 빠르게 해결.

Offers API를 연동하는 동안 볼 수 있는 오류와 그 원인, 해결 방법.

  • 400 invalid_country

    파라미터가 없거나 잘못되었습니다: invalid_user_id, invalid_country 또는 invalid_device.

    해결 방법오류 코드에 표시된 파라미터를 수정하세요.

  • 401 invalid_api_key

    키가 없거나, 잘못되었거나, 교체되었습니다.

    해결 방법Authorization 헤더에 Bearer로 보내고, 연동 탭에서 키를 다시 복사하세요.

  • 403 app_not_live

    앱이 일시 중지되었거나, 계정이 승인 또는 활성 상태가 아닙니다.

    해결 방법알림을 확인하세요. user_blocked인 경우 해당 사용자에게 오퍼를 표시하지 마세요.

  • 429 rate_limited

    이 앱에서 1분 동안 600건을 초과하는 요청이 발생했습니다.

    해결 방법Retry-After에 표시된 초만큼 기다리고, 사용자별 목록을 1분에서 5분 동안 캐시하세요.

  • Empty offers list

    정상적인 응답입니다. 지금 해당 사용자에게 제공할 수 있는 오퍼가 없습니다.

    해결 방법안내 문구가 있는 빈 화면을 보여 주고, 보내는 국가와 기기 정보를 확인하세요.

  • VPN detected on start_url

    오퍼 페이지가 열릴 때 사용자가 VPN, 프록시 또는 클라우드 네트워크를 사용하고 있습니다.

    해결 방법사용자에게 이를 꺼 달라고 요청하세요. 서버에서 보내는 API 요청은 검사하지 않습니다.

  • Postback log shows 403 or 404

    스크립트가 postback을 거부했거나 URL이 잘못되었습니다.

    해결 방법로그에 있는 URL을 브라우저에서 열고 해시 코드를 확인하세요.

  • Postback log shows a timeout

    스크립트가 응답하는 데 6초보다 오래 걸립니다.

    해결 방법먼저 200으로 응답하고, 오래 걸리는 작업은 백그라운드에서 실행하세요.

  • Postback log shows 301 or 302

    URL이 리디렉션됩니다. 예를 들어 http에서 https로 이동합니다.

    해결 방법최종 URL을 사용하세요. Postback은 리디렉션을 따라가지 않습니다.

한눈에 보기

엔드포인트
GET https://api.moonetix.com/v1/offers
인증
Bearer API 키, 앱당 하나, 서버에서만 사용
필수 파라미터
user_id, country, device 또는 ua
요청 한도
앱당 분당 최대 600건 요청
형식
OpenAPI 설명이 포함된 JSON
가격
승인된 퍼블리셔는 무료

다른 연동 방식

Offers API 자주 묻는 질문

Offers API를 추가하기 전에 개발자들이 묻는 질문.

막히는 부분이 있나요? 문의하기

오퍼월 대신 Offers API를 사용해야 하는 경우는 언제인가요?

가장 빠르게 시작하려면 오퍼월 링크를 사용하세요. 다른 소스의 오퍼 옆이나 자체 리워드 스토어처럼, 사이트나 앱 안에 자체 디자인으로 오퍼를 넣고 싶다면 Offers API를 사용하세요.

브라우저나 모바일 앱에서 Offers API를 호출할 수 있나요?

아니요. 요청에 API 키가 담기므로 서버에서만 호출하세요. 키가 유출되면 연동 탭에서 새 키를 만드세요. 이전 키는 즉시 작동을 멈춥니다.

어떤 국가를 보내야 하나요?

사용자가 실제로 있는 국가를 US처럼 두 글자 코드로 보냅니다. 오퍼와 리워드가 이 값에 따라 달라지며, 사용자가 오퍼를 시작할 때 국가와 기기를 다시 확인합니다.

리워드는 오퍼월과 다른가요?

아니요. API는 오퍼월과 같은 오퍼를 같은 리워드로 반환하며, 완료된 모든 단계는 같은 서명된 postback으로 서버에 전달됩니다.

요청 한도가 있나요?

네, 앱당 분당 최대 600건까지 요청할 수 있습니다. 목록을 자주 표시한다면 사용자별로 잠시 캐시하세요.

같은 키를 다른 곳에도 사용할 수 있나요?

네. 앱의 API 키는 Reporting API와 모바일 SDK 세션에도 사용할 수 있습니다.

트래픽을 수익으로 바꾸세요.

무료 퍼블리셔 계정을 만들고, 사용자가 웹사이트, 앱, 게임, 커뮤니티에서 완료하는 모든 오퍼로 수익을 올리세요.

전 세계 타기팅
더 보기
로그인