API Reference · 영어 퀴즈

세트 보상 받기

지연 지급(claim: deferred)으로 완료한 슬롯의 보상을 사용자가 지급 안내를 확인한 시점에 지급합니다.

POST/api/v1/contents/{content_id}/quiz/slots/{slot_key}/claim

요청

Authorization: Bearer sess_* — 콘텐츠 세션 토큰.
content_id (path) — 토큰의 콘텐츠와 일치해야 합니다.
slot_key (path) — 완료한 슬롯 키 YYYYMMDD-N. 답안 제출 또는 오늘의 퀴즈 조회의 unclaimed.slots[].slot_key.

본문은 없습니다. 슬롯 한 개당 지급은 한 번만 일어납니다. 지난 날짜·지난 달 슬롯도 받을 수 있습니다(수령 기한 없음).

shell

curl -X POST \
  -H "Authorization: Bearer <session_token>" \
  "https://added-dev.blomics.net/api/v1/contents/<content_id>/quiz/slots/20261001-2/claim"

성공 응답

200 — reward 는 답안 제출 응답의 reward 와 같은 모양입니다. 이때 포스트백(또는 내부 적립)이 만들어지므로 승인 leg 의 payout 이 빠지고 postback_id·delivery·delivery_code·user_message·balance_after 가 채워집니다.

json

{
  "slot_key": "20261001-2",
  "claim_status": "claimed",
  "reward": {
    "summary": { "matched": 1, "granted": 1, "rejected": 0, "skipped": 0 },
    "legs": [
      { "campaign_id": "0193…", "campaign_type": "always_on", "parent_campaign_id": null,
        "event_id": "0193…", "event_type": "quiz_slot_completed",
        "outcome": "granted", "event_log_id": "0193…", "point": 10,
        "postback_id": "0193…", "delivery": "delivered" }
    ]
  }
}

필드

claim_status — claimed(지급함). 즉시 지급(claim 생략)으로 완료했거나 지급할 것이 없는 슬롯(전부 거절 등)이면 null 이고, 이때는 지급 없이 현재 상태를 돌려줍니다.
reward.legs[].delivery — 매체 포스트백 상태. delivered 는 매체가 적립을 확인했고, pending 은 발송 대기·결과 확인 중이며, failed 는 매체가 거절했습니다. 포스트백이 없는 매체(내부 적립)에는 없습니다.
reward.legs[].user_message — 매체가 적립을 거절했을 때 그 매체 설정의 사용자 안내 문구. 있으면 그대로 표시하세요.
reward.legs[].balance_after — 내부 적립 매체의 적립 후 잔액.

중복 호출과 재시도

슬롯 한 개당 지급은 한 번입니다. 이미 받은 슬롯에 다시 호출하면 새로 지급하지 않고 같은 결과를 돌려줍니다(동시에 여러 번 호출해도 지급은 한 건). 네트워크 오류·시간 초과·서버 오류 뒤에는 같은 slot_key 로 안전하게 다시 호출할 수 있습니다. 서버 오류로 끝나면 미수령으로 남아 unclaimed 에 계속 나옵니다.

오류 처리

400 INVALID_PARAM — slot_key 형식 오류.
401 UNAUTHORIZED / SESSION_EXPIRED — 세션 인증 실패·만료.
404 NOT_FOUND — 퀴즈 콘텐츠가 아니거나 세션 콘텐츠 불일치.
499 QUIZ_SLOT_NOT_STARTED — 시작하지 않은 슬롯.
499 QUIZ_SLOT_NOT_COMPLETED — 아직 완료하지 않은 슬롯.

한도·기간 등 지급 조건 판정은 완료 시점에 끝났으므로 받을 때 지급 조건 거부는 나오지 않습니다. 매체의 적립 거절은 오류가 아니라 200 응답의 delivery: "failed" 로 전달됩니다.