인증

Crisphive API에 대한 모든 요청은 Authorization 헤더에 베어러 토큰으로 전송되는 시크릿 API 키로 인증됩니다. 대시보드의 설정 → 개발자에서 키를 생성할 수 있으며, 키 값은 생성 시 한 번만 표시되므로 즉시 복사해 두시기 바랍니다.

curl "https://api.crisphive.com/v1/customers" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

키 프리픽스로 환경을 선택합니다

키 프리픽스가 데이터 환경을 결정합니다. chsk_live_ 키는 프로덕션(라이브) 데이터를 읽고 쓰며, chsk_test_ 키는 격리된 샌드박스를 대상으로 합니다. API 키는 만료됩니다. 유효 기간은 생성 시에 선택하며 — 기본 30일, 1일부터 365일까지 — 키가 존재하는 동안 고정됩니다. expires_at은 절대 변경되지 않습니다. 갱신하려면 교체 키를 만들고 기존 키를 폐기하세요 — 인증을 참고하시기 바랍니다.

스코프

키는 전체 접근 권한을 갖거나 특정 권한 스코프로 제한되며(예: 고객 목록 읽기 권한 없이 작업 요청 생성), 항상 하나의 워크스페이스와 하나의 환경(라이브 또는 샌드박스)에 고정됩니다.