API-Endpunkte

Alle Endpunkte haben das Präfix /v1/ironflock. Für jede Anfrage ist eine Authentifizierung per Bearer-Token erforderlich.

Interaktive Dokumentation mit Anfrage-/Antwort-Schemas finden Sie unter api.ironflock.com/docs.

Geräte


GET /devices

Gibt alle Geräte zurück, auf die der authentifizierte Benutzer Zugriff hat.


GET /devices/:device_key


POST /swarms/:swarm_key/devices

Erstellt ein oder mehrere Geräte in einem Projekt. Der swarm_key ist die Projektkennung.


DELETE /swarms/:swarm_key/devices/:device_key


DELETE /swarms/:swarm_key/devices?ids=1,2,3

Übergeben Sie kommagetrennte Geräte-IDs als Query-Parameter.


GET /devices/:device_key/apps


POST /devices/:device_key/apps

Anfragekörper:


{
    "app_key": 123
}


PUT /devices/:device_key/apps/:app_key


DELETE /devices/:device_key/apps/:app_key


GET /apps

Gibt alle veröffentlichten Apps zurück, auf die der authentifizierte Benutzer Zugriff hat.


GET /apps/:app_key


POST /apps


DELETE /apps/:app_key


POST /apps/:app_key/releases

Standardmäßig ist dieser Aufruf synchron — er wartet auf den Abschluss des Builds. Verwenden Sie ?wait=false für asynchrones Verhalten.

Optionale Query-Parameter:

Parameter	Typ	Standard	Beschreibung
`wait`	boolean	`true`	Auf Build-Abschluss warten
`timeout`	number	—	Maximale Wartezeit in Sekunden (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

Bricht einen laufenden Release-Build ab.


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_key