Kanorio를 사용하면 브랜드 사이트를 두 가지 방식으로 제공할 수 있습니다.
가장 큰 장점은 두 모드 모두 동일한 Kanorio 백엔드를 공유한다는 점입니다. 프론트엔드가 엔지니어링이나 AI에 의해 구축되더라도, 운영 팀은 코드를 한 줄도 건드리지 않고 매일 "데이터 및 컬렉션 › 테이블" 작업 공간에서 기사를 수정하고, 주문을 확인하고, 고객을 관리하며, 모든 데이터를 검토할 수 있습니다.
Kanorio가 귀하의 요구 사항(예: 브랜드 사이트 + 블로그, 온라인 강의 플랫폼, 멤버십 사이트 등)을 지원하는지 평가할 때, 실시간으로 생성되는 기능 지원 매트릭스(/developers/capabilities)를 확인할 수 있습니다.
| 기능 도메인 | 현재 상태 | 가이드 및 참조 |
|---|---|---|
| 1. 콘텐츠 (페이지, 내비게이션, 블로그, 사용자 지정 데이터 컬렉션) | 완전 지원 | · Delivery API 참조 |
| 2. 고객 및 멤버 (연락처, 동적 세그먼트, 비밀번호 없는 로그인, 액세스 제어) | 완전 지원 (멤버십 등급 계획 중) | · Customer API 참조 |
| 3. 크레딧 및 저장된 가치 (스토어 크레딧, 패스 원장) | 계획 중 | 지원 상태 개요 보기 |
| 4. 상품 및 프로모션 (상품, 변형, 카테고리, 할인 규칙) | 완전 지원 (시스템 호스팅 체크아웃) | Delivery API 참조 · Management API 참조 |
| 5. 예약 및 리소스 (시간 슬롯, 직원 및 장비 예약) | 계획 중 | 지원 상태 개요 보기 |
| 6. 주문 및 양식 (거래, 온라인 양식 및 스팸 방지 제출) |
"외부 스토어프론트 URL(externalStorefrontUrl)"을 설정하여 트래픽을 사용자 지정 프론트엔드로 리디렉션하면, 호스팅된 페이지 DOM이나 호스팅된 트래픽에 의존하는 특정 기능(예: 백엔드 "SEO › 사이트 속도" 측정, "마케팅 › 사이트 내 프로모션" 배너 및 팝업, 에디터 기반 글꼴/색상 스타일링, 자동 생성되는 sitemap.xml, 자사 트래픽 분석)은 Kanorio 호스팅 페이지에서만 작동합니다.
호스팅 전용 기능과 사용자 지정 프론트엔드(Next.js/Astro)를 위한 해당 대체 방법은 기능 지원 매트릭스 — 호스팅 전용 섹션에 문서화되어 있습니다.
자체 프론트엔드를 구축할 때는 각 자격 증명이 어디에 적용되는지 확인하십시오.
https://{your-site}/api/v1/*에서 양식을 제출합니다. 브라우저에서 직접 fetch할 수 있습니다. 읽기 전용 초안 미리보기에는 서버 측에서 X-Kanorio-Preview: knr_pv_... 미리보기 토큰을 포함해야 합니다.knr_cat_): 프론트엔드에서 <kanorio-login> 또는 /api/v1/customer/auth/*를 통해 구매자가 로그인한 후 획득합니다. 이는 구매자의 상업적 권한을 나타냅니다.knr_pat_): 귀하 또는 귀하 팀의 백엔드 운영 권한(RBAC)을 나타냅니다. 이는 반드시 서버 측, CI/CD 또는 AI 도구에만 저장해야 합니다. 브라우저 코드에 절대 노출하지 마십시오.프론트엔드가 외부 플랫폼(예: Vercel의 https://www.brand.com)에 배포된 경우, 검색 엔진 색인 생성 시 공식 사이트와 경쟁하게 되므로 기본 Kanorio 템플릿 페이지에서 "게시"를 클릭하지 않는 것이 좋습니다.
"사이트 설정 › 개발자"의 세 가지 설정을 통해 헤드리스 배포를 완료할 수 있습니다. 구성이 완료되면 "대시보드"의 사이트 상태 카드가 자동으로 "API 서비스 활성"으로 전환되며, 외부 프론트엔드 URL과 시스템 API URL이 표시됩니다.
systemHost): 모든 사이트는 생성 시 영구 시스템 URL(https://s-xxxxxxxxxxxx.kanorio.com)이 할당되며, 이는 외부 프론트엔드 환경 변수에서 API 기본 URL로 사용하기에 적합합니다.headlessEnabled): 활성화되면 호스팅된 사이트가 게시되지 않은 상태에서도 https://{system-url}/api/v1/*, 블로그 게시 및 고객 로그인이 작동합니다.externalStorefrontUrl): 설정 시 Kanorio 하위 도메인에 방문하는 사용자는 302 리디렉션을 통해 외부 메인 사이트로 자동 이동됩니다. 대시보드의 "사이트 미리보기" 버튼도 단기 미리보기 토큰과 함께 외부 프론트엔드를 자동으로 엽니다.AI 어시스턴트에게 다음과 같이 요청하여 활성화할 수 있습니다:
이 사이트에 대해 헤드리스 모드를 활성화하고(headlessEnabled: true), 외부 스토어프론트 URL을 https://www.example.com으로 설정하고, allowedOrigins에 https://www.example.com을 추가하고, 이 사이트의 영구 시스템 URL(systemHost)을 알려줘.
| 기능 | 무료 플랜 | 프로 플랜 | 비즈니스 플랜 |
|---|---|---|---|
| 콘텐츠 배포 API 호출 및 대역폭 | 무제한, 대역폭 비용 없음 | 무제한, 대역폭 비용 없음 | 무제한, 대역폭 비용 없음 |
| 사용자 지정 데이터 컬렉션 항목 (초안 포함; 유료 플랜은 1,000개 단위로 추가 가능) | 50개 항목 | 1,000개 항목 (최대 20,000개까지 추가) | 10,000개 항목 (최대 200,000개까지 추가) |
블로그 게시물 게시 및 blog* 시스템 컬렉션 API | 초안만 가능 | 사용 가능 (사용자 지정 컬렉션 제한에 포함되지 않음) | 사용 가능 (사용자 지정 컬렉션 제한에 포함되지 않음) |
| 온라인 코스 및 디지털 배포물 (배포물 및 요소) | 사용 가능 | 사용 가능 | 사용 가능 |
| Webhook 엔드포인트 수 (비즈니스 플랜은 컬렉션 또는 양식별 필터링 지원) | — | 최대 3개 엔드포인트 | 최대 10개 엔드포인트 (이벤트 필터링 지원) |
| 총 저장 공간 | 200 MB (계정 전체 공유) | 10 GB (추가 기능 사용 가능) | 200 GB (추가 기능 사용 가능) |
아니요. blog* 컬렉션과 products, orders, contacts, deliverables와 같은 시스템 테이블은 50/1,000/10,000개의 사용자 지정 데이터 컬렉션 제한에서 완전히 제외됩니다.
네, 마이그레이션 비용 없이 가능합니다. 백엔드에서 생성한 페이지, 데이터 컬렉션, 블로그 게시물, 상품, 전달 가능 항목 및 온라인 양식은 이미 {your-site}/api/v1/*를 통해 제공됩니다. 새로운 프론트엔드를 구축하고 externalStorefrontUrl을 설정하면 언제든지 원활하게 전환할 수 있습니다.
| · Delivery API 참조 |
| 7. 배포 (온라인 코스, 다운로드 가능한 패키지, 600초 서명된 재생, 학습 진행률) | 완전 지원 (<kanorio-*> 구성 요소 포함) | · Elements 참조 |