Content Delivery API는 외부 프론트엔드 및 모바일 앱을 위해 설계된 공개 HTTP API로, 사용자의 웹사이트 도메인 바로 아래에 마운트됩니다. 컬렉션, 블로그, 페이지 또는 온라인 폼에서 콘텐츠를 게시하면 모든 프론트엔드 프레임워크(Next.js, Astro, Remix, Nuxt, SvelteKit 등)에서 직접 호출할 수 있습니다. 프론트엔드에 API 키를 저장할 필요가 없으며, 글로벌 에지 캐싱을 통해 밀리초 단위의 응답 속도를 제공합니다.
전체 엔드포인트, 매개변수 및 오류 코드(SSOT): 모든 엔드포인트 경로, 쿼리 매개변수, 응답 구조, 속도 제한 헤더 및 오류 코드는 OpenAPI 3.1 사양에서 자동으로 생성되며 Content Delivery API 참조 페이지에서 확인할 수 있습니다(
https://{your-site}/api/v1/openapi.json을 사이트에서 직접 다운로드할 수도 있습니다). 이 문서는 플랫폼 수준의 설계 개념에 중점을 둡니다.
| 비교 | 콘텐츠 전송 API (본 가이드) | 고객 API (구매자) | 관리 REST API / MCP |
|---|---|---|---|
| 기본 URL | https://{your-website}/api/v1 | https://{your-website}/api/v1/customer | https://app.kanorio.com/api/v1 |
| 인증이 필요한가요? | 아니요 (공개/익명; 초안 미리보기 시에만 토큰 필요) | 구매자 로그인 후 Bearer 세션 (knr_cat_) 필요 | 예 (Authorization: Bearer knr_pat_... 필요) |
| 브라우저에서 안전한가요? | 예 (CORS 허용 오리진 설정 시) | 예 (로그인한 구매자로 제한) | 아니요 (서버 측, CI 또는 AI 도구 전용) |
| 데이터 버전 | 게시된 데이터만 반환 | 구매자를 위한 실시간 액세스 및 진행 상황 | 초안 및 게시된 데이터에 대한 읽기/쓰기 액세스 |
| 문서 | 전송 API 참조 |
웹사이트에는 Content Delivery API를 호출할 수 있는 두 가지 유형의 URL이 있습니다.
https://s-xxxxxxxxxxxx.kanorio.com/api/v1): 생성 시 할당되며 영구적으로 유지됩니다. Kanorio 호스팅 페이지를 게시하지 않았거나( [| 고객 API 참조 |
| 관리 API 참조 |