엔드포인트
핵심 요약
이 페이지는 API 경로를 찾아보는 자료입니다. 기능별로 선택한 다음 인증 요건과 Worker·Axum 지원 여부를 확인하세요.
전체 구현 목록은 API 계약 지도에서 확인합니다. 경로 이름이 같다고 두 백엔드가 동일한 기능을 제공한다고 가정하지 마세요.
라우트별 인증과 패리티 노트가 있는 라우트 단위 인벤토리는 **api-contract-map**에 있습니다 — be-cloudflare/src/lib.rs의 디스패치 테이블이 진실 공급원이고 맵은 그것에 대해 유지됩니다. 이 페이지는 오리엔테이션 레이어입니다: 표면들과 대부분의 호출자가 실제로 필요로 하는 행들.
표면 맵
| 표면 | 베이스 | 인증 기본 | 문서 위치 |
|---|---|---|---|
| 플랫폼 REST | /api/v1/** | 역할 스코프(공개 경로 표시) | 계약 맵 §1 |
| 라이선스 PoP 플레인 | /api/v1/licenses/{activate,capability,execute,status} | entitlement + DPoP, LICENSE_SECURITY_ENABLED 게이트, Worker 전용 | 계약 맵 §1, 라이선싱 |
| 공개 임베드 | /api/v1/public/** | 없음 — 절대 자격 증명 전송 금지 | 아래, SDK |
| Health | /api/v1/health | 공개 | {ok, request_id}(ok = D1 바인딩 존재) |
Integration 표면 (d3 패리티 — 양쪽 백엔드)
| 메서드 | 경로 | 인증 | 노트 |
|---|---|---|---|
GET | /api/v1/public/integrations/:public_id | 공개 | IntegrationManifest — integration 레코드의 공개 프로젝션 |
POST | /api/v1/public/integrations/:public_id/donations | 공개 | {donor_name?, message?, amount_krw, idempotency_key?} → 201 SandboxDonation; amount_krw 양의 정수 |
POST | /api/v1/public/integrations/:public_id/feedbacks | 공개 | {author_name?, type?, message} → 201 Feedback |
GET | /api/v1/projects/:id/integration | seller | {integration, manifest} 또는 404 |
PUT | /api/v1/projects/:id/integration | seller | IntegrationInput; upsert |
GET | /api/v1/projects/:id/donations | seller | {items:[SandboxDonation]} |
호스티드 페이지 (FE): {site}/h/{public_id} (fe/pages/h/[publicId].vue).
라이선스 엔드포인트 — 요약 표
| 메서드 | 경로 | 인증 | 노트 |
|---|---|---|---|
POST | /licenses | seller | 발급(lic_ + NG-… 키) |
GET | /licenses | seller/admin | 스코프 목록 — 키 미노출 |
PATCH | /licenses/:id | seller(소유자) | status/expires_at |
POST/DELETE | /licenses/:id/activations[/:device] | seller(소유자) | 레거시 device_id 레코드, 표시 전용 |
POST | /licenses/verify | 공개 | 조회 판정; 슬롯 미소비 |
POST | /licenses/activate | key | PoP — Worker 전용 |
POST | /licenses/capability | entitlement+DPoP | Worker 전용 |
POST | /licenses/execute | entitlement+DPoP+capability | Worker 전용 |
GET | /licenses/status | entitlement+DPoP | Worker 전용 |
GET | /licenses/:id/bindings | seller | PoP 바인딩 (Worker) |
GET | /licenses/:id/usage | seller | 사용량 로그 + 카운터 (Worker) |
셀러 durable-read 및 ops 엔드포인트 (Worker)
GET /usage-counters[?lic_id=] · GET /security-events[?lic_id=] · GET /seller/events · GET /dashboard/stats — 모두 테넌트 스코프.
Admin 엔드포인트
GET /admin/users · PATCH /admin/users/:id/status · GET /admin/overview · GET /admin/sellers · GET /admin/verifications · GET /admin/audit · GET /metrics · GET /ledger/verify · GET /audit/verify · POST /admin/reconciliation/run · GET /admin/reconciliation/reports[/:id] — 모두 admin 역할.
체크아웃 및 커머스
POST /checkout(멱등) · POST /checkout/confirm · POST /webhooks/toss(서명 검증, 재조회 권위) · GET /orders[/:id] · POST /orders/:id/refund · GET /orders/:id/refund-attempts · GET /payments/:id · POST /purchase/game-item · POST /fulfillments/:id/retry · GET|POST /settlements · GET /subscriptions · POST /subscriptions/:id/event — 상세는 결제와 계약 맵에 있습니다.
패리티 노트
activate/capability/execute/status,bindings,usage,usage-counters,security-events,admin/reconciliation/*— Worker 전용; Axumbe/에는 PoP 플레인이 없고 durable-read API도 없습니다./projects/:id/integration+/public/integrations/*— d3 포트 이후 양쪽 백엔드.- FE 클라이언트는 보안 플레인 라우트를 호출하지 않습니다 — 계약은 서버 측에만 존재합니다.