개발자 콘솔 API¶

ZUKU Developer Console — 앱 등록, API 키, 웹훅 관리.

Base URL¶

/api/v1/devconsole

모든 요청에 Authorization: Bearer <session_token> 필요.

앱 (Apps)¶

앱 목록¶

GET /api/v1/devconsole/apps

앱 등록¶

POST /api/v1/devconsole/apps
Content-Type: application/json

{
  "app_name": "My Game Tool",
  "app_type": "game",
  "description": "Jump 게임 연동 도구",
  "redirect_uris": ["https://example.com/callback"],
  "scopes": ["contents:read", "jump:write"]
}

app_type: web · mobile · server · cli · game

앱 상세¶

GET /api/v1/devconsole/apps/{app_id}

API 키¶

앱별 키. 원문은 생성 응답 1회만 반환.

키 목록¶

GET /api/v1/devconsole/apps/{app_id}/keys

키 발급¶

POST /api/v1/devconsole/apps/{app_id}/keys
Content-Type: application/json

{
  "key_name": "Production",
  "environment": "live"
}

키 폐기¶

DELETE /api/v1/devconsole/keys/{key_id}

웹훅¶

웹훅 목록¶

GET /api/v1/devconsole/apps/{app_id}/webhooks

웹훅 등록¶

POST /api/v1/devconsole/apps/{app_id}/webhooks
Content-Type: application/json

{
  "endpoint_url": "https://example.com/webhook",
  "events": ["content.published", "jump.play"]
}

등록 시 secret이 발급됩니다. 수신 측은 X-Shizuku-Secret 헤더로 검증.

웹훅 테스트¶

POST /api/v1/devconsole/webhooks/{webhook_id}/test

전달 로그¶

GET /api/v1/devconsole/webhooks/{webhook_id}/deliveries

UI 접근¶

Studio 개발자 콘솔: /studio/developer
API 문서: 문서 홈

레거시 API 키와의 차이¶

	`/developer/keys` (0012)	`/devconsole/apps/.../keys`
단위	사용자	앱
용도	간단 S2S (콘텐츠 생성)	앱별 키·웹훅 관리
스코프	없음	JSON scopes 배열

두 체계는 병행 운영됩니다.