API 키
Kagibag API에 프로그래밍 방식으로 액세스하세요. 통합, 자동화 스크립트 및 타사 도구를 위한 개인 액세스 토큰을 생성하세요.
누가 키를 생성할 수 있나요?
API 키는 팀 관리자가 생성합니다. 인증을 받고 팀에 대한 관리자 액세스 권한이 있어야 합니다. 각 키는 귀하의 팀에 범위가 지정되며 귀하의 팀 권한을 상속받습니다.
API 키 생성하기
관리자, 팀, API 키로 이동합니다. API 키 생성 클릭 후 설명적인 이름(예: "CRM 동기화" 또는 "분석 내보내기")을 입력합니다. 키는 생성 시 한 번만 표시됩니다 — 즉시 복사하세요.
중요:귀하의 API 키는 한 번만 표시됩니다. 대화상자를 닫기 전에 복사하여 안전하게 보관하세요. 키를 잃어버리면 새 키를 생성해야 합니다.
API 키 사용하기
HTTP 요청의 Authorization 헤더에 Bearer 토큰으로 API 키를 포함하세요.
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
https://your-domain.test/api/v1/organizer/events키 관리
API 키 섹션에서 모든 API 키를 볼 수 있습니다. 각 키는 이름, 마지막 네 자릿수(식별용 미리보기), 생성 날짜 및 마지막 사용 날짜를 표시합니다. 마지막 사용 타임스탬프는 비활성 키를 식별하는 데 도움이 됩니다.
키 철회하기
더 이상 필요하지 않거나 손상되었을 수 있는 키를 삭제합니다. 철회는 즉시 적용되며 — 해당 키를 사용하는 모든 요청은 401 Unauthorized 응답으로 실패합니다. 연결된 통합은 새 키로 업데이트될 때까지 작동을 중지합니다.
보안 모범 사례
다음 지침에 따라 API 키를 안전하게 유지하세요:
- 키를 소스 코드가 아닌 환경 변수나 비밀 관리 도구에 저장하세요
- 주기적으로 키를 교체하세요 — 새 키를 생성하고, 통합을 업데이트한 후 이전 키를 폐기하세요
- 다른 통합을 위해 별도의 키를 사용하여 하나를 폐기해도 다른 통합에 영향을 주지 않도록 하세요
- 예상치 못한 사용을 감지하기 위해 마지막 사용 타임스탬프를 모니터링하세요
- 채팅, 이메일 또는 공개 채널에서 키를 공유하지 마세요