개발자 콘솔 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 문서 위키: /docs/api

---

레거시 API 키와의 차이

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