고객센터어드민

API Reference · 세션

세션 조회

콘텐츠사가 게이트웨이로부터 리다이렉트로 받은 session_id 를 검증하고, 어떤 매체사·사용자·콘텐츠로 발행된 세션인지 확인합니다.

GET/api/v1/sessions/{session_id}

요청 파라미터

  • session_id (path, uuid, required) — 검증할 세션 식별자 (게이트웨이가 콘텐츠 URL 의 query 로 전달).

요청예시

shell
curl -H "Authorization: Bearer sess_prod_0192a1b2-3c4d-7e8f-9012-3456789abcde" \
     "https://added.blomics.net/api/v1/sessions/0192a1b2-3c4d-5e6f-7890-abcdef012345"

응답 필드

  • session_id (uuid)
  • user_id (uuid) — Blomics 내부 사용자 식별자.
  • publisher_id (uuid) — 발행 매체사.
  • content_id (uuid) — 진입한 콘텐츠.
  • campaign_id (uuid) — 세션이 속한 캠페인. 세션 발급 시점에 고정되는 스냅샷입니다. 플레이로그 등 기록/보상 경로는 이 값을 사용합니다.
  • ranking_campaign_id (uuid) — 랭킹 조회에 사용할 캠페인. 진행 중이면서 랭킹을 제공하는 캠페인 중 가장 최근에 시작한 것을 요청 시점에 골라 반환합니다(진행 중인 프로모션이 있으면 그것). 후보가 없으면 campaign_id 와 같은 값이므로 이 필드만 그대로 사용하면 됩니다. 프로모션 랭킹은 부모 상시 캠페인의 기록을 프로모션 기간으로 잘라 집계한 결과입니다.
  • nickname (string | null) — 매체사가 게이트웨이로 전달한 사용자 닉네임. 전달하지 않은 경우 user_id 값으로 대체됩니다.
  • expired_at (ISO 8601) — 세션 만료 시각. 이 시각 이후 이벤트는 거부됩니다.

응답예시

json
{
  "session_id": "0192a1b2-3c4d-5e6f-7890-abcdef012345",
  "user_id": "0195d4e5-6f78-90ab-cdef-012345678901",
  "publisher_id": "0194c3d4-5e6f-7890-abcd-ef0123456789",
  "content_id": "0193b2c3-4d5e-6f78-90ab-cdef01234567",
  "campaign_id": "0196e5f6-7890-abcd-ef01-234567890123",
  "ranking_campaign_id": "0197f607-8901-bcde-f012-3456789abcde",
  "nickname": "초코나라",
  "expired_at": "2026-05-02T12:00:00.000Z"
}

에러처리

  • 400 INVALID_PARAM — session_id 형식 오류.
  • 401 UNAUTHORIZED — 인증 실패.
  • 404 NOT_FOUND — 세션 없음, 만료, 또는 다른 콘텐츠사 소속.
  • 500 INTERNAL_ERROR — 서버 오류.