API 키가 있으면 스크립트, 연동, AI 에이전트가 https://api.caliuapp.com의 REST API를 통해 Caliu 계정과 통신할 수 있어요.
키 만들기
- 웹 앱에서: 사이드바 아래쪽의 사용자 메뉴를 열고 API 키를 선택한 다음 새 API 키를 고르세요. 무엇에 쓰는 키인지 알 수 있는 이름을 붙이세요(예: "My Script").
- iPhone과 iPad 앱, Mac 앱에서: 설정을 열고 계정, API 키 순서로 이동하세요.
모든 키는 caliu_로 시작해요. 곧바로 복사하세요. 보안을 위해 Caliu는 키의 해시만 저장하므로, 키는 딱 한 번만 보여요. 이후 목록에는 짧은 접두사와 함께 각 키를 만든 시각과 마지막으로 사용한 시각만 표시돼요.
사용하기
Authorization 헤더에 Bearer 토큰으로 키를 보내세요.
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
API 전체는 대화형 문서에 정리되어 있어요. API 문서 항목을 참고하세요.
키 해제하기
키를 만든 그 화면에서 언제든 키를 해제할 수 있어요. 해제는 즉시 적용돼요. 그 키를 계속 쓰던 애플리케이션은 다음 요청부터 접근할 수 없어요. 키는 비밀번호처럼 다루고, 절대 코드에 커밋하지 마세요.