API Reference · 컨텐츠

콘텐츠 목록 조회

현재 매체사·콘텐츠사 계정으로 접근 가능한 콘텐츠 목록을 조회합니다. 페이징을 지원하며, 등록·노출 가능한 컨텐츠만 반환합니다.

GET/api/v1/contents

요청 파라미터

limit (query, int, default 50, max 200) — 한 페이지에 반환할 항목 수.
offset (query, int, default 0) — 건너뛸 항목 수.
status (query, string, optional) — ACTIVE / INACTIVE 필터.
content_type (query, string, optional) — GAME / QUIZ 등 콘텐츠 유형 필터.

요청예시

shell

curl -H "Authorization: Bearer {publisher_secret}" \
     "https://added.blomics.net/api/v1/contents?limit=50&offset=0"

응답 필드

200 OK — items 배열과 total 총 개수를 반환합니다.

items (array) — 콘텐츠 객체 배열.
- content_id (uuid) — 콘텐츠 식별자.
- name (string) — 콘텐츠명.
- subtitle (string, nullable) — 부제.
- content_type (string) — GAME / QUIZ 등.
- description (string, nullable) — 설명.
- content_url (string) — 콘텐츠 진입 URL.
- thumbnail_url (string, nullable) — 썸네일 이미지.
- status (string) — ACTIVE / INACTIVE.
- created_at (ISO 8601 datetime) — 생성 시각.
- updated_at (ISO 8601 datetime) — 수정 시각.
total (int) — 필터 조건에 매치되는 전체 개수.

응답예시

json

{
  "items": [
    {
      "content_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
      "name": "퀴즈 챔피언",
      "subtitle": "매일 새로운 문제",
      "content_type": "QUIZ",
      "description": "5문제를 맞히면 보상이 지급됩니다.",
      "content_url": "https://example-provider.com/contents/quiz-champion",
      "thumbnail_url": "https://cdn.example.com/thumbs/quiz-champion.png",
      "status": "ACTIVE",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-04-15T12:34:56.000Z"
    }
  ],
  "total": 1
}

에러처리

400 INVALID_PARAM — limit / offset 형식 오류.
401 UNAUTHORIZED — 인증 실패 (만료·무효 secret).
500 INTERNAL_ERROR — 서버 오류.