API 개요
이것은 Capgo cloud의 공개 API 문서입니다. API를 사용하면 조직, 기기, 채널 및 번들을 포함한 Capgo 리소스를 프로그래밍 방식으로 관리할 수 있습니다. RESTful로 설계되었으며 표준 HTTP 메서드를 사용합니다.
모든 API 엔드포인트는 인증이 필요합니다. 요청을 인증하려면 authorization 헤더에 API 키를 추가하세요.
예시:
curl -H "authorization: your-api-key" https://api.capgo.app/organization/ API 키 받기 Capgo 대시보드에서 API 키 생성
API는 공정한 사용을 보장하기 위해 속도 제한을 구현합니다. 현재 제한은:
- 표준 계정의 경우 분당 100개 요청
- 엔터프라이즈 계정의 경우 분당 1000개 요청
이러한 제한을 초과하면 429 (Too Many Requests) 응답을 받게 됩니다.
모든 응답은 JSON 형식입니다. 성공 응답에는 일반적으로 data 객체 또는 status 필드가 포함됩니다. 오류 응답에는 무엇이 잘못되었는지에 대한 설명이 포함된 error 필드가 포함됩니다.
성공 응답 예시:
{ "status": "ok", "data": { ... }}오류 응답 예시:
{ "error": "Invalid API key", "status": "KO"}사용 가능한 엔드포인트
Section titled “사용 가능한 엔드포인트” 조직 조직 생성 및 관리, 설정 업데이트 및 조직 수준 구성 처리
API 키 Capgo API에 대한 안전한 액세스를 위한 API 키 생성, 나열 및 취소
회원 조직 회원, 역할 및 권한 관리
통계 앱 사용, 스토리지 및 대역폭 소비에 대한 상세한 분석에 액세스
채널 앱 업데이트 채널, 버전 및 업데이트 정책 제어
기기 앱을 실행하는 기기 추적 및 관리, 버전 및 채널 할당 포함
번들 업로드, 나열 및 버전 관리를 포함한 앱 번들 처리
- 오류 처리: 항상 오류 응답을 확인하고 적절하게 처리하세요
- 속도 제한: 속도 제한에 도달할 때 지수 백오프를 구현하세요
- 캐싱: API 호출을 줄이기 위해 적절한 경우 응답을 캐시하세요
- 버전 관리: 변경 로그를 통해 API 변경 사항을 추적하세요