# Detalles de la Build

> Obtén información detallada de tus Builds de Applivery usando la Integrations API o la Workspace API, incluyendo endpoints, autenticación y ejemplos.

Source: https://docs.applivery.com/es/app-distribution/api/builds/build-details/  •  Last updated: 2026-06-08

**Answers:** ¿Para qué sirve el endpoint GET de detalles de una Build? · ¿Cuáles son las dos APIs disponibles para obtener detalles de una Build? · ¿Cuándo debo usar la Integrations API para obtener detalles de una Build? · ¿Cómo me autentico con la Integrations API? · ¿Cuándo debo usar la Workspace API para obtener detalles de una Build? · ¿Cómo me autentico con la Workspace API? · ¿Qué parámetros de ruta requiere la Workspace API? · ¿Qué significa un error 400 al obtener detalles de una Build?

---

**TL;DR:** Obtén información detallada sobre las builds de Applivery usando la API de Integraciones por app o la API de Workspace para múltiples apps.

Devuelve los detalles completos de una Build en concreto, identificado por su `buildId`. Es el endpoint principal para inspeccionar el estado de procesamiento, los metadatos y la información específica de plataforma de una Build — y el endpoint recomendado para hacer polling tras una subida hasta que la Build alcance un estado terminal (`processed` o `error`).

Applivery proporciona dos APIs independientes para obtener los detalles de una Build, 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, polling de estado tras subida | Automatización a nivel de Workspace en varias Apps |
| **Autenticación** | App API Token (por app) | token de una cuenta de servicio (a nivel de Workspace) |
| **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 de CI que comprueban si una Build ha terminado de procesarse | Platform engineers que inspeccionan Builds en varias Apps |

:::warning
El acceso a las distintas APIs puede no estar disponible en tu plan actual. Consulta la disponibilidad en nuestra [página de precios](https://www.applivery.com/app-distribution-pricing/).
:::

* * *

## Integrations API

Usa este endpoint para obtener los detalles de una Build 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](https://docs.applivery.com/en/app-distribution/api/app-api-token/).

### Endpoint

```
GET https://api.applivery.io/v1/integrations/builds/{buildId}
```

### Autenticación

```
Authorization: Bearer <your_app_token>
```

### Parámetros de ruta

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `buildId` | String | Sí | El identificador único de una Build a obtener. P. ej. `552ae3cfcb5abfc58d733b81`. El `buildId` se devuelve en la respuesta de POST – Subir una Build y GET – Lista de Builds. |

### Ejemplo de petición

```bash
curl 'https://api.applivery.io/v1/integrations/builds/552ae3cfcb5abfc58d733b81' \
  -X GET \
  -H 'Authorization: Bearer YOUR_APP_TOKEN'
```

### Respuestas

**✓ 200 OK**

```json
{
  "status": true,
  "data": {
    "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": "user@example.com",
      "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"
  }
}
```

**✗ 400 Bad Request**

Build aún no procesado. Este error se devuelve cuando la Build existe pero aún no ha terminado de procesarse. Vuelve a intentarlo tras una breve espera.

```json
{
  "status": false,
  "error": {
    "code": 5014,
    "message": "Build Not Processed"
  }
}
```

**✗ 401 Unauthorized**

```json
{
  "status": false,
  "error": {
    "code": 3002,
    "message": "Token Expired"
  }
}
```

**✗ 404 Not Found**

```json
{
  "status": false,
  "error": {
    "code": 3001,
    "message": "Entity not found"
  }
}
```

### Campos principales de la respuesta

| Campo | Descripción |
| --- | --- |
| `status` | Estado de procesamiento de una Build: `pending`, `in_progress`, `processed` o `error`. |
| `error` | Mensaje de error legible, solo presente cuando `status` es `error`. |
| `errorCode` | Código de error para gestión programática. Consulta los Códigos de procesamiento de Builds. |
| `info.android` | Metadatos Android extraídos: nombre del paquete, nombre y código de versión, SDK targets e icono. Solo presente en Builds Android. |
| `info.ios.plist` | Metadatos del `Info.plist` de iOS: bundle identifier, versión, nombre de pantalla, plataformas admitidas y familias de dispositivos. Solo presente en Builds iOS. |
| `info.ios.mobileprovision` | Detalles del perfil de aprovisionamiento iOS: equipo, fecha de caducidad, tipo de firma y dispositivos aprovisionados. Solo presente en Builds iOS. |
| `info.pkg` | Metadatos del paquete macOS extraídos. Solo presente en Builds macOS. |
| `deployer` | Metadatos de CI/CD adjuntos en la subida: rama, commit, número de build y URLs de la plataforma. |
| `size` | Tamaño del archivo de Build en bytes. |
| `processTime` | Tiempo empleado en procesar la Build, en milisegundos. |

:::tip
Tras subir una Build, llama a este endpoint periódicamente con el `buildId` devuelto en la respuesta de la subida hasta que el `status` sea `processed` o `error`. Un `status` de `pending` o `in_progress` indica que el procesamiento aún está en curso. Si el estado es `error`, consulta el campo `errorCode` y revisa los [Códigos de procesamiento de Builds](https://docs.applivery.com/en/app-distribution/builds/processing-error-codes/) para los pasos de resolución.
:::

* * *

## Workspace API

Usa este endpoint para obtener los detalles de una Build a nivel de Workspace — por ejemplo, en automatizaciones que operan en varias Apps usando una sola credencial.

La autenticación usa un token de una **cuenta de servicio**, con ámbito de Workspace y no vinculado a ninguna app individual. El contexto de la app y de una Build se proporcionan mediante parámetros de ruta.

Para crear un token de una cuenta de servicio, consulta [Cuentas de servicio](https://docs.applivery.com/en/platform/api/service-accounts/).

### Endpoint

```
GET https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/builds/{buildId}
```

### 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 a la que pertenece la Build. |
| `buildId` | String | Sí | El identificador único de una Build a obtener. |

### Autenticación

```
Authorization: Bearer <your_service_account_token>
```

### Ejemplo de petición

```bash
curl 'https://api.applivery.io/v1/organizations/ORG_ID/apps/APP_ID/builds/552ae3cfcb5abfc58d733b81' \
  -X GET \
  -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN'
```

El esquema de la respuesta es idéntico al de la Integrations API.