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) — 세션이 속한 캠페인. 세션 발급 시점에 고정되는 스냅샷입니다.
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",
  "nickname": "초코나라",
  "expired_at": "2026-05-02T12:00:00.000Z"
}

에러처리

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