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

사용자 콘텐츠 데이터 목록 조회

세션 유저가 콘텐츠를 이용하며 저장한 K/V 데이터 목록을 조회합니다. 토큰의 (user, content) 스코프로 본인 데이터만 반환하며 value 는 임의 JSON 입니다.

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

스코프 — 세션 유저 본인

데이터는 세션 토큰의 user_id × content_id 로 스코프됩니다. 다른 유저나 다른 콘텐츠의 데이터는 조회되지 않으며, 별도의 매체 구분(publisher_id)이나 namespace 화이트리스트는 없습니다 — 유저 본인 소유 데이터이기 때문입니다.

요청 파라미터

content_id (path, uuid, required) — 조회할 콘텐츠 ID. 세션 토큰의 콘텐츠와 일치해야 합니다.
namespace (query, string, optional) — 분류 키로 추가 필터링 (예: save, settings).
limit (query, int, optional) — 1–200, 기본 50.
offset (query, int, optional) — 기본 0.

요청예시

shell

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

응답 필드

200 OK — 데이터 항목 배열.

items (array) — 데이터 항목.
- content_id (uuid)
- namespace (string) — 분류 키.
- key (string) — 항목 키.
- value (any) — 저장된 JSON 값.
- created_at / updated_at (ISO 8601)
total (int) — 필터 조건의 전체 항목 수.

응답예시

json

{
  "items": [
    {
      "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"
    }
  ],
  "total": 1
}

에러처리

400 INVALID_PARAM — content_id 형식 오류, namespace/limit/offset 형식 오류.
401 UNAUTHORIZED — 인증 실패.
404 NOT_FOUND — 세션 토큰의 콘텐츠와content_id 불일치(404 은닉).
500 INTERNAL_ERROR — 서버 오류.