API 엔드포인트
모든 엔드포인트는 /v1/ironflock으로 시작합니다. 모든 요청에 Bearer 토큰을 통한 인증이 필요합니다.
요청/응답 스키마가 있는 인터랙티브 문서는 api.ironflock.com/docs를 참조하십시오.
디바이스
모든 디바이스 목록
GET /devices인증된 사용자가 접근할 수 있는 모든 디바이스를 반환합니다.
디바이스 가져오기
GET /devices/:device_key디바이스 생성
POST /swarms/:swarm_key/devices프로젝트에 하나 이상의 디바이스를 생성합니다. swarm_key는 프로젝트 식별자입니다.
디바이스 삭제
DELETE /swarms/:swarm_key/devices/:device_key디바이스 일괄 삭제
DELETE /swarms/:swarm_key/devices?ids=1,2,3쉼표로 구분된 디바이스 ID를 쿼리 파라미터로 전달합니다.
디바이스 앱
디바이스의 앱 목록
GET /devices/:device_key/apps디바이스에 앱 추가
POST /devices/:device_key/apps요청 본문:
{
"app_key": 123
}디바이스의 앱 상태 업데이트
PUT /devices/:device_key/apps/:app_key디바이스에서 앱 제거
DELETE /devices/:device_key/apps/:app_key앱
모든 앱 목록
GET /apps인증된 사용자가 접근할 수 있는 모든 릴리스된 앱을 반환합니다.
앱 가져오기
GET /apps/:app_key앱 생성
POST /apps앱 삭제
DELETE /apps/:app_key릴리스
릴리스 생성
POST /apps/:app_key/releases기본적으로 이 호출은 동기 방식입니다 — 빌드가 완료될 때까지 기다립니다. 비동기 동작을 위해 ?wait=false를 사용하십시오.
선택적 쿼리 파라미터:
| 파라미터 | 유형 | 기본값 | 설명 |
|---|---|---|---|
wait | boolean | true | 빌드 완료 대기 |
timeout | number | — | 최대 대기 시간 (초 단위, 1–1800) |
릴리스 목록
GET /apps/:app_key/releases?swarm_key=N릴리스 가져오기
GET /apps/:app_key/releases/:release_key?swarm_key=N릴리스 삭제
DELETE /apps/:app_key/releases/:release_key빌드 취소
POST /apps/:app_key/releases/cancel진행 중인 릴리스 빌드를 취소합니다.
그룹
프로젝트의 그룹 목록
GET /swarms/:swarm_key/groups그룹 가져오기
GET /swarms/:swarm_key/groups/:group_key그룹에 디바이스 추가
PUT /swarms/:swarm_key/groups/:group_key/devices/:device_key그룹에서 디바이스 제거
DELETE /swarms/:swarm_key/groups/:group_key/devices/:device_key그룹에 앱 설치
POST /swarms/:swarm_key/groups/:group_key/apps그룹의 앱 업데이트
PUT /swarms/:swarm_key/groups/:group_key/apps/:app_key그룹에서 앱 제거
DELETE /swarms/:swarm_key/groups/:group_key/apps/:app_keyLast updated on