API 개요
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.
이 문서는 API의 공개 Capgo 클라우드의 API입니다. Capgo 리소스(조직, 장치, 채널 및 배너)를 프로그램적으로 관리할 수 있도록 허용합니다. RESTful로 설계되어 표준 HTTP 메서드를 사용합니다.
인증
인증 섹션API API의 모든 엔드포인트는 인증이 필요합니다. 인증을 위해 요청에 API 키를 추가하세요. authorization 헤더에 추가하세요.
예시:
curl -H "authorization: your-api-key" https://api.capgo.app/organization/ API 키 가져오기 API 키를 Capgo 대시보드에서 생성하세요.
속도 제한
속도 제한 섹션API는 사용자 경험을 보장하기 위해 속도 제한을 구현합니다. 현재 제한은 다음과 같습니다.
- 표준 계정의 경우 1분당 100개의 요청이 허용됩니다.
- 1000분 단위로 기업 계정에 대한 요청 제한
429 (Too Many Requests) 응답을 받게 됩니다.
응답 형식
응답 형식모든 응답은 JSON 형식입니다. 성공적인 응답은 일반적으로 data 객체 또는 status 필드를 포함합니다. 오류 응답은 오류 설명을 포함하는 error 필드를 포함합니다.
성공적인 응답 예시:
{ "status": "ok", "data": { ... }}오류 응답 예시:
{ "error": "Invalid API key", "status": "KO"}사용 가능한 엔드포인트
사용 가능한 엔드포인트 단체 단체를 만들고 관리하고 설정을 업데이트하고 단체 수준의 구성 요소를 관리합니다.
API 키 API 키를 생성하고 목록을 만들고 취소하여 Capgo API에 대한 안전한 접근을 보장합니다.
멤버 단체 멤버, 역할 및 권한을 관리합니다.
통계 앱 사용량, 저장소 및 대역폭 소비에 대한 세부적인 분석에 접근합니다.
채널 앱 업데이트 채널, 버전 (버전), 업데이트 정책을 제어합니다.
기기 앱이 실행되는 기기들을 추적하고 관리하세요. 버전 및 채널 assignments 포함
배포 앱 배포를 관리하세요. 업로드, 목록, 배포(버전) 관리 포함
최선의 방법
Section titled “최선의 방법”- 오류 처리: 항상 오류 응답을 확인하고 적절히 처리하세요
- 속도 제한: 속도 제한을 만나면 지연 백오프를 implement하세요
- 캐싱: 캐시 응답을 사용하여 API calls를 줄이세요
- 버전 관리: API의 변경 사항을 추적하기 위해 우리의 변경 로그를 사용하세요.