REST API · 인증
핵심 요약
API를 호출하기 전에 공개 사용자 / 로그인한 판매자·관리자 / 라이선스 기기 중 어떤 호출인지 구분하세요. 인증 방식이 서로 다릅니다.
인증 비교표를 확인한 다음 엔드포인트에서 경로와 오류 계약을 찾아보세요.
YetdaPay의 API는 사용자 로그인, 구매자 기기 라이선스, 공개 위젯 호출을 서로 다른 인증 경계로 관리합니다.
어떤 인증을 사용하나요?
| 호출 유형 | 인증 방식 |
|---|---|
| 판매자·관리자 사용자 | Cloudflare Worker JWT Bearer |
| 로컬 Axum 개발 환경 | 개발용 X-Dev-User 헤더 — 운영 환경에서는 사용 금지 |
| 라이선스 보호 기능 | Entitlement JWS + DPoP 방식의 기기 증명 |
| 공개 후원·피드백 등 | 지정된 공개 API에 한해 인증 없음 |
권한이 필요한 관리 API에는 판매자별 범위 확인이 별도로 수행되어야 합니다. 로그인 토큰을 받았다는 사실만으로 타 판매자의 자료를 볼 수는 없습니다.
주요 오류
401: 인증되지 않은 요청403: 권한이 없는 요청 또는 보호 기능 거부404: 대상이 없거나 비활성화된 기능409: Capability 중복 소비 등 충돌
정확한 오류 코드는 엔드포인트별 계약을 확인해야 합니다.