SDK 및 도구

CLI

터미널에서 Management API를 스크립트화하고, 사이트 컬렉션에 대한 TypeScript 타입을 생성하며, 헤드리스 프론트엔드 설정을 점검합니다.

Kanorio CLI는 스크립트 및 CI를 위해 Management API를 래핑하며, 타입 생성과 헤드리스 프론트엔드 상태 점검이라는 두 가지 개발자 도구를 추가로 제공합니다.

npx @kanorio/cli --help

주요 명령어

kanorio sites list
kanorio pages list ws_example123
kanorio pages replace-sections ws_example123 pg_example456 --file sections.json
kanorio media upload ws_example123 --file hero.jpg
kanorio publish ws_example123
kanorio domains status ws_example123

콘텐츠를 덮어쓰는 명령어는 먼저 리소스를 읽고 타임스탬프를 전송하므로, 다른 사용자의 편집 내용을 덮어쓰지 않고 CONFLICT 오류와 함께 실패합니다. 전체 명령어 목록을 보려면 kanorio --help를 실행하십시오.

출력 및 종료 코드

--json을 추가하면 오류를 포함한 원시 API 응답이 출력되어 스크립트 작성에 활용할 수 있습니다.
오류는 stderr에 <CODE> (HTTP <status>): <message> 형식으로 출력되며 종료 코드 1을 반환합니다. 사용법 오류는 종료 코드 2를 반환합니다.
더 이상 사용되지 않는 작업에 대한 경고는 stderr로 출력됩니다.

타입 생성

kanorio types --site https://s-xxxxxxxxxxxx.kanorio.com --out src/kanorio.d.ts

types는 사이트의 공개 컬렉션 스키마를 읽어 각 컬렉션에 대한 FieldData, Expanded, Item 타입을 작성하며, 페이지, 글로벌, 사이트 메타데이터에 대한 타입도 함께 생성합니다. 스키마가 변경될 때마다 다시 실행하거나 collections.schema.changed 웹훅을 구독하여 자동화할 수 있습니다.

헤드리스 프론트엔드 점검

kanorio doctor --site ws_example123

doctor는 프론트엔드가 사이트맵, robots.txt, llms.txt, 피드, JSON-LD 및 IndexNow 키 파일을 올바르게 제공하는지, 페이지 콘텐츠가 동기화되어 있는지, 페이지뷰와 웹훅이 정상적으로 도착하는지 확인합니다. Kanorio 호스팅 사이트에서 자체 프론트엔드로 도메인을 이전하기 전에 --switching 옵션을 추가하여 실행하십시오.

로그인

주요 명령어

출력 및 종료 코드

타입 생성

헤드리스 프론트엔드 점검