Devuelve una lista paginada de Builds para una App determinada. Resulta útil para consultar el historial de builds, comprobar el estado de procesamiento tras una subida, o crear dashboards y scripts de automatización que actúen sobre Builds específicos.
Applivery proporciona dos APIs independientes para listar Builds, cada una con una credencial de autenticación diferente.
Cómo elegir la API correcta
| Integrations API | Workspace API | |
|---|---|---|
| Diseñada para | Integraciones por app, pipelines de CI/CD, herramientas de build | Automatización a nivel de Workspace en varias Apps |
| Autenticación | App API Token (por app) | un token de una cuenta de servicio (a nivel de Workspace) |
| URL base | https://api.applivery.io |
https://api.applivery.io |
| Contexto de app | Implícito — el token ya está vinculado a una App | Explícito — se requieren organizationId y applicationId en la ruta |
| Usuarios típicos | Scripts que comprueban el estado de la Build, polling tras subida | Platform engineers que consultan Builds en varias Apps |
El acceso a las distintas APIs puede no estar disponible en tu plan actual. Consulta la disponibilidad en nuestra página de precios.
Integrations API
Usa este endpoint para consultar Builds dentro del ámbito de una sola app. La autenticación usa un App API Token, vinculado a la App específica.
Para crear un App API Token, consulta Autenticación de la API de Apps.
Endpoint
GET https://api.applivery.io/v1/integrations/builds
Autenticación
Authorization: Bearer <your_app_token>
Parámetros de consulta
Todos los parámetros son opcionales. Sin filtros, el endpoint devuelve todos las Builds de la App asociada al token, ordenados por fecha de creación descendente.
| Parámetro | Tipo | Descripción |
|---|---|---|
versionName |
String | Filtra por nombre de versión legible. P. ej., RC-1, v2.4.0-beta. |
status |
String | Filtra por estado de procesamiento. Valores admitidos: pending, in_progress, processed, error. |
os |
String | Filtra por sistema operativo. Valores admitidos: ios, android. |
page |
Integer | Número de página para la paginación. Empieza en 1. |
limit |
Integer | Número máximo de Builds a devolver por página. |
Ejemplo de petición
curl 'https://api.applivery.io/v1/integrations/builds?status=processed&os=ios&page=1&limit=20' \
-X GET \
-H 'Authorization: Bearer YOUR_APP_TOKEN'
Respuestas
{
"status": true,
"data": {
"items": [
{
"id": "string",
"status": "processed",
"tags": ["string"],
"versionName": "string",
"application": "string",
"applicationInfo": {
"id": "string",
"name": "string",
"slug": "string",
"picture": "string"
},
"changelog": "string",
"info": {
"icon": "string",
"android": {
"targetSdkVersion": "string",
"minSDKVersion": "string",
"packageName": "string",
"platformBuildVersionName": "string",
"platformBuildVersionCode": "string",
"versionName": "string",
"versionCode": "string",
"icon": "string"
},
"ios": {
"plist": {
"CFBundleDisplayName": "string",
"CFBundleSupportedPlatforms": ["string"],
"MinimumOSVersion": "string",
"CFBundleIdentifier": "string",
"CFBundleShortVersionString": "string",
"CFBundleVersion": "string",
"CFBundleName": "string",
"CFBundleIcons": ["string"],
"UIDeviceFamily": ["string"]
},
"mobileprovision": {
"ExpirationDate": "2019-08-24T14:15:22Z",
"TeamIdentifier": "string",
"ProvisionsAllDevices": true,
"TeamName": "string",
"ProvisionedDevices": "string",
"signingType": "ad-hoc"
}
},
"pkg": {
"CFBundleDisplayName": "string",
"CFBundleIdentifier": "string",
"CFBundleShortVersionString": "string",
"CFBundleVersion": "string",
"CFBundleName": "string"
}
},
"size": 0,
"processTime": 0,
"queuedTime": 0,
"versionCode": "string",
"error": "string",
"errorCode": "string",
"os": "ios",
"deployer": {
"name": "string",
"info": {
"commitMessage": "string",
"commit": "string",
"branch": "string",
"triggerTimestamp": "string",
"buildUrl": "string",
"ciUrl": "string",
"repositoryUrl": "string",
"buildNumber": "string",
"tag": "string"
}
},
"uploadedBy": {
"id": "string",
"email": "[email protected]",
"firstName": "string",
"lastName": "string",
"picture": "string"
},
"originalExtension": "string",
"storageProvider": {
"id": "string",
"name": "string",
"region": "string"
},
"hasEmmJson": true,
"updatedAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z"
}
]
}
}
{
"status": false,
"error": {
"code": 4002,
"message": "No auth token"
}
}
{
"status": false,
"error": {
"code": 3001,
"message": "Entity not found"
}
}
Usa status=pending o status=in_progress para hacer polling de Builds que aún se están procesando tras una subida. Una vez que el status devuelva processed, la Build está lista. Si el status es error, consulta los campos error y errorCode para más detalles, y revisa los Códigos de procesamiento de Builds para los pasos de resolución.
Workspace API
Usa este endpoint para consultar Builds a nivel de Workspace — por ejemplo, en flujos de trabajo de platform engineering donde una sola credencial necesita listar Builds en varias Apps.
La autenticación usa un token de cuenta de servicio, con ámbito de Workspace y no vinculado a ninguna app individual. El contexto de la app se proporciona explícitamente mediante parámetros de ruta.
Para crear un token de una cuenta de servicio, consulta Cuentas de servicio.
Endpoint
GET https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/builds
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
organizationId |
String | Sí | El identificador único de tu organización en Applivery. |
applicationId |
String | Sí | El identificador único de la App cuyos Builds quieres listar. |
Autenticación
Authorization: Bearer <your_service_account_token>
Parámetros de consulta
La Workspace API acepta los mismos parámetros de consulta que la Integrations API.
Ejemplo de petición
curl 'https://api.applivery.io/v1/organizations/ORG_ID/apps/APP_ID/builds?status=processed&os=android&page=1&limit=10' \
-X GET \
-H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN'