API Reference · 영어 퀴즈

출석 보너스 받기

지연 지급(claim: deferred)으로 판정된 월 출석 보너스 단계를 사용자가 지급 안내를 확인한 시점에 지급합니다.

POST/api/v1/contents/{content_id}/quiz/attendance/{month}/tiers/{days}/claim

요청

Authorization: Bearer sess_* — 콘텐츠 세션 토큰.
content_id (path) — 토큰의 콘텐츠와 일치해야 합니다.
month (path) — 출석 월 YYYY-MM(KST, 서빙일 기준).
days (path) — 보너스 단계의 기준 일수(1~31). 답안 제출의 attendance.rewards[].days 또는 오늘의 퀴즈 조회의 unclaimed.attendance[].

본문은 없습니다. 단계 한 개당 지급은 한 번만 일어나며 지난 달 단계도 받을 수 있습니다(수령 기한 없음).

shell

curl -X POST \
  -H "Authorization: Bearer <session_token>" \
  "https://added-dev.blomics.net/api/v1/contents/<content_id>/quiz/attendance/2026-10/tiers/20/claim"

성공 응답

200 — 세트 보상 받기와 같은 규칙입니다. claim_status 는 지급했으면 claimed, 즉시 지급이었거나 지급할 것이 없으면 null 입니다.

json

{
  "month": "2026-10",
  "days": 20,
  "claim_status": "claimed",
  "reward": {
    "summary": { "matched": 1, "granted": 1, "rejected": 0, "skipped": 0 },
    "legs": [
      { "campaign_id": "0193…", "event_type": "quiz_attendance_bonus",
        "outcome": "granted", "event_log_id": "0193…", "point": 100,
        "postback_id": "0193…", "delivery": "delivered" }
    ]
  }
}

세트 보상과 따로 받습니다

출석 20일째 세트를 완료하면 세트 보상과 출석 보너스가 함께 판정됩니다. 둘은 따로 받으므로 세트 보상을 받은 뒤 출석 보너스 안내를 이어서 보여 주고, 확인하면 이 API 를 호출하세요. 중복 호출·재시도 규칙은 세트 보상 받기와 같습니다.

오류 처리

400 INVALID_PARAM — month 가 YYYY-MM 이 아니거나 days 가 1~31 정수가 아님.
401 UNAUTHORIZED / SESSION_EXPIRED — 세션 인증 실패·만료.
404 NOT_FOUND — 퀴즈 콘텐츠가 아니거나, 그 달·단계가 아직 판정되지 않았습니다.