manifest 스펙 (clack-app.json)
번들 zip 루트에 clack-app.json 포함이 필수입니다. 서버가 manifest ↔ 포털 등록 정보 ↔ 번들 실제 내용의 일치를 검증하며, 불일치는 제출 반려 사유가 됩니다.
{
"app_id": "death-gacha",
"name": "괴담출근 사망가챠",
"version": "1.2.0",
"entry": "index.html",
"sdk_version": "^0.1.0",
"scopes": ["mini-app:events", "mini-app:user:read"],
"external_domains": ["api.example.com"],
"orientation": "portrait"
}| 필드 | 필수 | 설명 |
|---|---|---|
| app_id | 필수 | 포털 등록값과 일치해야 합니다 (서버가 검증). |
| name | 필수 | 미니앱 이름. |
| version | 필수 | semver. 같은 앱 안에서 버전별로 유니크해야 합니다. |
| entry | 필수 | 진입 HTML 파일명 (예: index.html). |
| sdk_version | 필수 | 탑재한 클랙 미니앱 SDK 버전 선언 (semver range, 예: ^0.1.0). |
| scopes | 필수 | 포털에 등록한 scope와 일치해야 합니다 (배열). |
| external_domains | 선택 | 자체 API 서버 등 외부 통신 도메인. CSP connect-src 근거가 됩니다. |
| orientation | 선택 | 화면 방향 힌트. 예: 'portrait'. |