API Reference · 사용자 콘텐츠 데이터

사용자 콘텐츠 데이터 조회

세션 유저의 콘텐츠 K/V 데이터 단건을 조회합니다. 스코프는 토큰의 (user, content) 로 강제되며 본인 데이터만 접근할 수 있습니다.

GET/api/v1/contents/{content_id}/data/{namespace}/{key}

요청 파라미터

content_id (path, uuid, required) — 콘텐츠 ID. 세션 토큰의 콘텐츠와 일치해야 합니다.
namespace (path, string, required) — 분류 키 (예: save, settings).
key (path, string, required) — 항목 키.

요청예시

shell

curl -H "Authorization: Bearer sess_prod_0192a1b2-3c4d-7e8f-9012-3456789abcde" \
  "https://added.blomics.net/api/v1/contents/{content_id}/data/save/level"

응답 필드

200 OK — 데이터 항목 단건.

content_id (uuid)
namespace (string) — 분류 키.
key (string) — 항목 키.
value (any) — 저장된 JSON 값.
created_at / updated_at (ISO 8601)

응답예시

json

{
  "content_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
  "namespace": "save",
  "key": "level",
  "value": { "stage": 7, "coins": 1280 },
  "created_at": "2026-05-19T09:00:00.000Z",
  "updated_at": "2026-05-19T09:00:00.000Z"
}

에러처리

400 INVALID_PARAM — content_id 형식 오류, namespace/key 규칙 위반.
401 UNAUTHORIZED — 인증 실패.
404 NOT_FOUND — 세션 토큰의 콘텐츠와 불일치(404 은닉), 또는 본인 스코프에 해당 키 없음.
500 INTERNAL_ERROR — 서버 오류.