ZUKU 개발자 문서

인터랙티브 UGC 미디어 플랫폼 ZUKU 의 REST API 개발자 가이드입니다.
인증부터 작품 게시, 게임 패키지, 커뮤니티 연동까지 실제 REST API 사용법을 안내합니다.

공식 문서: docs.zuzunza.com
기준일: 2026-09-12 · API v1
기존 /docs/api 주소는 이 문서로 연결됩니다.

Base URL

환경	URL
프로덕션	https://zuzunza.com/api/v1
로컬 백엔드	http://localhost:3001/api/v1 (또는 게이트 리라이트 /api/v1)

버전 접두사 v1은 URL에 항상 포함합니다. 응답 헤더 X-API-Version: v1 · 봉투 meta.version과 동일 세대입니다.

문서 목차

문서	설명
Getting Started	봉투, 헤더, 빠른 시작, Rate Limits, Versioning
Authentication	가입·로그인·세션·Captcha·개발자 API 키
Captcha	PoW 챌린지·검증·가입/로그인 게이트
Contents	HYPE / SWIPE / JUMP / VIVE / VINE 콘텐츠·게시
Feeds	미디어 피드 · 커뮤니티 feed · posts
Social	좋아요·북마크·팔로우·댓글·알림·DM
Media	업로드 · Jump play/stream/swf
Game Cloud	Economy · Vars · Saves · Pay · Functions
Developer Console	앱 · API 키 · 웹훅
Examples	curl · JS/TS 실전 시나리오
Errors	에러 봉투 · HTTP · 코드 표
Changelog	v1 변경 이력 · 호환 정책

공통 응답 봉투

{
  "success": true,
  "data": { },
  "meta": {
    "request_id": "…",
    "timestamp": "2026-08-22T00:00:00Z",
    "version": "v1"
  }
}

실패 시 success: false와 error: { code, message, details? }입니다. 상세는 Errors.

인증 한줄 요약

방식	헤더	대표 용도
Bearer 세션	Authorization: Bearer <access_token>	대부분의 쓰기·프로필·소셜
API 키	X-API-Key: sk_live_…	서버-투-서버 콘텐츠 생성 등

엔드포인트 맵 (요약)

/auth/*          가입·로그인·me·sessions
/captcha/*       PoW 챌린지·검증
/developer/keys  API 키 발급·목록·폐기
/feeds[/*]       hype·swipe·jump 피드
/feed            커뮤니티 타임라인
/posts/*         커뮤니티 글·답글
/contents/*      미디어 콘텐츠·댓글·좋아요
/uploads         multipart 업로드
/jump/games/*    Jump 목록·재생·스트림
/cloud/*         Game Cloud (Economy·Vars·Saves·Pay·Functions)
/devconsole/*    개발자 콘솔 (앱·키·웹훅)
/notifications/* 알림
/dm/*            DM
/users/me/*      내 좋아요 컬렉션
/admin/users/*   관리자

먼저 시작하기

빠른 시작에서 응답 형식을 확인하고, 인증 후 파일 업로드와 콘텐츠 게시를 연결하세요. JUMP 게임은 초안으로 저장한 뒤 별도 게시 요청으로 공개합니다.

게임 클라우드의 결제·서버 함수는 구현 범위에 제한이 있습니다. 게임 클라우드의 현재 지원 범위를 먼저 확인하세요.