Endpoints de la API
Todos los endpoints tienen el prefijo /v1/ironflock. Se requiere autenticación mediante Bearer token en cada solicitud.
Para documentación interactiva con esquemas de solicitud/respuesta, consulta api.ironflock.com/docs.
Dispositivos
Listar todos los dispositivos
GET /devicesDevuelve todos los dispositivos accesibles por el usuario autenticado.
Obtener un dispositivo
GET /devices/:device_keyCrear dispositivos
POST /swarms/:swarm_key/devicesCrea uno o más dispositivos en un proyecto. El swarm_key es el identificador del proyecto.
Eliminar un dispositivo
DELETE /swarms/:swarm_key/devices/:device_keyEliminación masiva de dispositivos
DELETE /swarms/:swarm_key/devices?ids=1,2,3Pasa los IDs de dispositivos separados por comas como parámetro de consulta.
Apps en dispositivos
Listar apps en un dispositivo
GET /devices/:device_key/appsAgregar un dispositivo a una app
POST /devices/:device_key/appsCuerpo de la solicitud:
{
"app_key": 123
}Actualizar el estado de una app en un dispositivo
PUT /devices/:device_key/apps/:app_keyDesinstalar una app de un dispositivo
DELETE /devices/:device_key/apps/:app_keyApps
Listar todas las apps
GET /appsDevuelve todas las apps publicadas accesibles por el usuario autenticado.
Obtener una app
GET /apps/:app_keyCrear una app
POST /appsEliminar una app
DELETE /apps/:app_keyReleases
Crear un release
POST /apps/:app_key/releasesPor defecto, esta llamada es sincrónica — espera a que la compilación se complete. Usa ?wait=false para un comportamiento asincrónico.
Parámetros de consulta opcionales:
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
wait | boolean | true | Esperar a que la compilación se complete |
timeout | number | — | Tiempo máximo de espera en segundos (1–1800) |
Listar releases
GET /apps/:app_key/releases?swarm_key=NObtener un release
GET /apps/:app_key/releases/:release_key?swarm_key=NEliminar un release
DELETE /apps/:app_key/releases/:release_keyCancelar una compilación
POST /apps/:app_key/releases/cancelCancela una compilación de release en progreso.
Grupos
Listar grupos en un proyecto
GET /swarms/:swarm_key/groupsObtener un grupo
GET /swarms/:swarm_key/groups/:group_keyAgregar dispositivo a un grupo
PUT /swarms/:swarm_key/groups/:group_key/devices/:device_keyEliminar dispositivo de un grupo
DELETE /swarms/:swarm_key/groups/:group_key/devices/:device_keyInstalar app en un grupo
POST /swarms/:swarm_key/groups/:group_key/appsActualizar app en un grupo
PUT /swarms/:swarm_key/groups/:group_key/apps/:app_keyEliminar app de un grupo
DELETE /swarms/:swarm_key/groups/:group_key/apps/:app_key