¿Para qué sirve el endpoint GET de detalles de una Build?

Permite obtener los detalles completos de una Build, incluyendo su estado de procesamiento, metadatos e información específica de plataforma. Es el endpoint recomendado para hacer polling tras una subida hasta que la Build se haya procesado o haya fallado.

¿Cuáles son las dos APIs disponibles para obtener detalles de una Build?

Applivery ofrece la Integrations API (por app) y la Workspace API (a nivel de workspace) para obtener detalles de una Build.

¿Cuándo debo usar la Integrations API para obtener detalles de una Build?

Usa la Integrations API para integraciones por app, pipelines de CI/CD y polling de estado tras una subida. Usa un App API Token para autenticarte.

¿Cómo me autentico con la Integrations API?

Autentícate con un App API Token en la cabecera `Authorization`: `Authorization: Bearer `.

¿Cuándo debo usar la Workspace API para obtener detalles de una Build?

Usa la Workspace API para automatización a nivel de workspace en varias apps. Usa un token de una cuenta de servicio para autenticarte.

¿Cómo me autentico con la Workspace API?

Autentícate con un token de una cuenta de servicio en la cabecera `Authorization`: `Authorization: Bearer `.

¿Qué parámetros de ruta requiere la Workspace API?

La Workspace API requiere `organizationId`, `applicationId` y `buildId` en la ruta.

GET - Detalles de una Build

Q: ¿Qué significa un error 400 al obtener detalles de una Build?

Un error 400 con el código 5014 significa que la Build existe pero aún no ha terminado de procesarse. Vuelve a intentarlo tras una breve espera.

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.

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.

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

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

Respuestas

{
  "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": "[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"
  }
}

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.

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

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

{
  "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 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.

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

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.