스크립트나 에이전트에서 설명서를 생성합니다
REST API, CLI, 그리고 Claude Code와 Cursor 같은 에이전트를 위한 에이전트 스킬이 앱과 똑같은 동작을 호출합니다. 영상으로 설명서를 생성하고, 문서를 편집하고, 게시하세요. Solo / Small Team 플랜 이상에서 제공됩니다.
설명서 API 하나, 엔드포인트 그룹 여덟 개
문서, 폴더, 템플릿, 영상, 생성, 프로젝트 설정, 게시, 내보내기가 하나의 OpenAPI 명세에 정리되어 있으며, 브라우저나 코드 생성기가 읽는 것과 같은 레퍼런스입니다. 번역, 버전 복원, 재생성은 그 그룹 안에 들어 있습니다.
생성한 다음 작업 확인하기
조회 대신 서명된 콜백 받기
범위 네 개, 엔드포인트마다 적용
모든 v2 요청은 실행 전에 키의 범위를 확인합니다. generate는 작업을 시작하고, write는 콘텐츠를 만들고 편집하고 옮기며, publish는 게시하거나 재게시하고, read는 그 밖의 모든 것을 덮습니다. 키는 발급된 프로젝트에만 작용합니다. 지금은 모든 키가 네 범위를 다 지니고 있습니다. 제한된 키를 발급하는 기능은 아직 만들지 않았습니다.
| 범위 | 허용하는 것 | 예시 |
|---|---|---|
read | 문서, 폴더, 템플릿, 영상, 내보내기, 작업 상태 읽기 | GET /articlesGET /generate/{jobId} |
write | 콘텐츠 만들기, 옮기기, 복제하기, 복원하기, 그리고 영상 업로드 | POST /articles/emptyPATCH /folders/{id}/move |
generate | 생성과 재생성, 번역 시작하기, 그리고 링크에서 영상 가져오기 | POST /generatePOST /videos/import |
publish | 프로젝트 게시와 재게시 | POST /publishPOST /publish/republish |
터미널에서 실행하거나, 에이전트에 넘기세요
CLI는 같은 API를 감싸고, 에이전트 스킬은 그 CLI를 감싸므로 사람과 스크립트, Claude Code나 Cursor 같은 에이전트가 모두 같은 명령에 닿습니다. 스크립트가 읽을 수 있는 출력에는 --json을, 작업이 끝날 때까지 기다리려면 --wait를 붙이세요.
$npm install -g @hintoai/cli
CLI 설치$hinto articles list
프로젝트의 모든 문서 나열$npx skills add hintoai/hinto-cli
에이전트 스킬 설치웹훅: 이벤트 네 개, URL 하나, 직접 정한 헤더
프로젝트는 게시, 재게시, 게시 취소, 보관에 웹훅을 발생시키며, 인증용으로 넣은 헤더를 함께 실어 보냅니다. 호출마다 이벤트 이름, 프로젝트와 게시 id, 타임스탬프, 그리고 프로젝트 이름과 URL 슬러그를 보냅니다. 콘텐츠 자체가 아니라 무슨 일이 있었고 어디서 찾을 수 있는지 알리는 통지입니다.
project.publish프로젝트가 처음 게시될 때project.republish프로젝트가 변경 사항과 함께 재게시될 때project.unpublish프로젝트가 게시 취소될 때project.archive프로젝트가 보관될 때
{
"event": "project.republish",
"projectId": "<project id>",
"publicationId": "<publication id>",
"timestamp": "2026-09-15T10:24:00.000Z",
"data": {
"projectName": "Acme Help Center",
"urlSlug": "acme"
}
}직접 넣은 헤더를 더해 POST로 보냅니다. Hinto는 최대 3번 시도하고, 시도마다 최대 30초를 기다리며, 4xx 응답에는 다시 시도하지 않습니다.작동 방식이미 쓰는 도구와 연결됩니다
웹훅과 지원 수신함, 웹사이트 빌더가 모두 같은 프로젝트에서 읽을 수 있습니다.
자체 시스템을 위한 웹훅
웹훅을 자체 엔드포인트로 가리키고 게시, 재게시, 게시 취소, 보관이 일어나는 대로 반응하세요.
Intercom Fin이 그것으로 답합니다
프로젝트 콘텐츠를 Intercom으로 동기화하면 Intercom의 지원 에이전트인 Fin이 Hinto가 생성한 내용으로 답합니다.
Framer가 그것을 사이트로 가져옵니다
Framer 플러그인이 문서와 폴더를 Framer CMS로 가져오므로, Framer에서 만들고 호스팅하는 사이트에 쓸 수 있습니다.
다른 기능
Hinto API와 CLI, 에이전트 스킬에 관한 질문
아니요. 요청마다 X-API-Key 헤더가 실리며, 이 키는 한 프로젝트의 설정에서 만듭니다.
더 나은
지식 기반을 더 빠르게 구축해 보세요
무료로 시작하고 몇 분 만에 첫 번째 문서를 만들어보세요