시작하기
Cherpa Open API는 스페이스(Space) 단위로 동작해요. API 키가 스페이스 하나에 묶여 있어서, 그 키로 보낸 요청은 모두 그 스페이스의 데이터를 다뤄요.
1. API 키 발급
콘솔 설정 → API 키 관리에서 + API 키 발급을 눌러 키를 만들어요. 키 원문(chp_...)은 발급 직후 한 번만 보이니 바로 복사해 두세요.
키에는 권한을 정할 수 있어요. 처음 살펴볼 때는 full(전체 접근)로 발급하고, 실제로 붙일 때는 쓰는 곳에 맞게 좁히는 걸 권장해요. 자세한 내용은 API 키를 참고하세요.
2. 콘텐츠 가져오기
콘솔에서 발행한 콘텐츠를 가져와요. 경로의 blog 자리에는 콘텐츠 종류의 슬러그를 넣어요. 아직 콘텐츠가 없다면 콘텐츠 등록 가이드를 먼저 따라 해 보세요.
bash
curl "https://api.cherpa.me/v1/content/blog/entries?limit=10" \
-H "Authorization: Bearer chp_..."목록에서 받은 id로 한 건을 가져와요.
bash
curl https://api.cherpa.me/v1/content/blog/entries/0d6f3c2a-... \
-H "Authorization: Bearer chp_..."필터·정렬·다국어는 콘텐츠 조회에 정리돼 있어요.
3. 문의 폼 연결하기
웹사이트 문의 폼의 제출 내용을 그대로 보내면 통합문의함에 신규 문의로 들어와요.
bash
curl -X POST https://api.cherpa.me/v1/public/inquiries \
-H "Authorization: Bearer chp_..." \
-H "Content-Type: application/json" \
-d '{ "name": "김하늘", "email": "haneul@example.com", "message": "견적 문의드려요" }'필드와 연락처 자동 연결 규칙은 인바운드 등록을 참고하세요.
4. 아웃바운드 등록하기
먼저 컨택할 대상을 아웃바운드 목록에 넣어요. full 권한 키로, 서버나 스크립트에서 호출하세요.
bash
curl -X POST https://api.cherpa.me/v1/public/outbounds \
-H "Authorization: Bearer chp_..." \
-H "Content-Type: application/json" \
-d '{ "name": "박서준", "company": "루미너스 스튜디오", "channel": "email" }'필드와 컨택 경로 값은 아웃바운드 등록을 참고하세요.
다음 단계
인증 방식과 에러 형식, 요청 제한은 API 개요 · 인증에 모여 있어요.