API Reference · 세션

세션 조회

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

GET/api/v1/sessions/{session_id}

요청 파라미터

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

요청예시

shell

curl -H "Authorization: Bearer {provider_secret}" \
     "https://added.blomics.net/api/v1/sessions/0192a1b2-3c4d-5e6f-7890-abcdef012345"

응답 필드

session_id (uuid)
publisher_user_id (string) — 매체사 사용자 식별자.
content_id (uuid) — 진입한 콘텐츠.
publisher_id (uuid) — 발행 매체사.
expires_at (ISO 8601) — 세션 만료 시각. 이 시각 이후 이벤트는 거부됩니다.

응답예시

json

{
  "session_id": "0192a1b2-3c4d-5e6f-7890-abcdef012345",
  "publisher_user_id": "user_12345",
  "content_id": "0193b2c3-4d5e-6f78-90ab-cdef01234567",
  "publisher_id": "0194c3d4-5e6f-7890-abcd-ef0123456789",
  "expires_at": "2026-05-02T12:00:00.000Z"
}

에러처리

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