Devuelve una lista paginada de Publicaciones para una App determinada. Usa este endpoint para consultar el estado actual de tus Publicaciones, obtener los valores publishedApplicationId que necesitan otros endpoints, o construir dashboards y scripts de automatización que actúen sobre Publicaciones específicas.
Applivery proporciona dos APIs independientes para listar Publicaciones, 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 y pipelines de CI/CD | 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 storeId en la ruta |
| Usuarios típicos | Scripts que buscan el ID de una Publicación antes de actualizarla | Platform engineers que consultan Publicaciones de 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 listar Publicaciones 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/distributions
Autenticación
Authorization: Bearer <your_app_token>
Parámetros de consulta
Todos los parámetros son opcionales. Sin filtros, el endpoint devuelve todas las Publicaciones de la App asociada al token.
| Parámetro | Tipo | Descripción |
|---|---|---|
slug |
String | Filtra por slug de la Publicación. Devuelve solo la Publicación que coincide exactamente con este slug. |
security |
String | Filtra por modo de seguridad. Valores permitidos: public, password, logged. |
visibility |
String | Filtra por estado de visibilidad. Valores permitidos: active, inactive, unlisted. |
filter-type |
String | Filtra por estrategia de selección de Build. Valores permitidos: last, build, builds, gitBranch, gitTag, tag. |
page |
Integer | Número de página para paginación. Empieza en 1. |
limit |
Integer | Número máximo de Publicaciones a devolver por página. |
Ejemplo de petición
curl 'https://api.applivery.io/v1/integrations/distributions?visibility=active&security=public' \
-X GET \
-H 'Authorization: Bearer YOUR_APP_TOKEN'
Respuestas
{
"status": true,
"data": {
"items": [
{
"id": "string",
"updatedAt": "2025-10-23T07:54:26.518Z",
"createdAt": "2024-07-23T08:10:46.471Z",
"application": "string",
"applicationInfo": {
"id": "string",
"slug": "string",
"name": "string",
"picture": "string"
},
"slug": "string",
"filter": {
"type": "last",
"value": "string",
"ios": "string",
"android": "string",
"windows": "string",
"macos": "string",
"builds": [
{
"buildPlatform": "string",
"id": "string"
}
]
},
"security": "public",
"tags": ["string"],
"groups": [["string"]],
"activateUserAudiences": false,
"userAudienceMap": [],
"visibility": "active",
"showHistory": false,
"showDevInfo": false,
"expirationDate": "string",
"distributionUrl": "string",
"terms": {
"active": true,
"text": "string"
},
"configuration": {
"branding": {
"logo": "string",
"primaryColor": "string",
"useAppIcon": false
},
"application": {
"description": "string",
"name": "string"
}
},
"allowedCountries": [],
"blockedCountries": []
}
],
"totalDocs": 0,
"limit": 0,
"hasPrevPage": true,
"hasNextPage": true,
"page": 0,
"totalPages": 0,
"pagingCounter": 0,
"prevPage": 0,
"nextPage": 0
}
}
{
"status": false,
"error": {
"code": 4002,
"message": "No auth token"
}
}
{
"status": false,
"error": {
"code": 3001,
"message": "Entity not found"
}
}
Campos principales de la respuesta
| Campo | Descripción |
|---|---|
id |
El identificador único de la Publicación (publishedApplicationId). Úsalo en los endpoints PUT – Actualizar y DELETE. |
slug |
El identificador amigable para URL que forma parte de la URL de la Publicación. |
distributionUrl |
La URL pública completa de la Publicación. Compártela con tus usuarios para darles acceso. |
security |
Modo de seguridad actual: public, password o logged. |
visibility |
Estado de visibilidad actual: active, inactive o unlisted. |
filter.type |
Estrategia de selección de Build configurada: last, build, builds, gitBranch, gitTag o tag. |
expirationDate |
Timestamp ISO 8601 a partir del cual la Publicación deja de estar disponible. null si no hay fecha de caducidad. |
activateUserAudiences |
Si el control de acceso basado en audiencias está habilitado para esta Publicación. |
userAudienceMap |
Array de asignaciones de audiencias para esta Publicación. |
allowedCountries |
Códigos de país desde los que se permite explícitamente el acceso. Array vacío significa sin restricción. |
blockedCountries |
Códigos de país desde los que se bloquea explícitamente el acceso. Array vacío significa sin restricción. |
configuration |
Sobreescrituras de branding y nombre/descripción de app aplicadas a esta Publicación. |
terms |
Configuración de términos legales — si se requiere aceptación y el texto de los términos. |
Campos de paginación
| Campo | Descripción |
|---|---|
totalDocs |
Número total de Publicaciones que coinciden con la consulta. |
page |
Número de página actual. |
totalPages |
Número total de páginas. |
limit |
Número de resultados por página. |
hasNextPage |
Si hay una página siguiente de resultados. |
hasPrevPage |
Si hay una página anterior de resultados. |
nextPage |
Número de la página siguiente, o null si estás en la última página. |
prevPage |
Número de la página anterior, o null si estás en la primera página. |
Workspace API
Usa este endpoint para listar Publicaciones a nivel de Workspace — por ejemplo, en pipelines de automatización que operan en varias Apps usando una sola credencial.
La autenticación usa un token de cuenta de servicio, con ámbito de Workspace y no vinculado a ninguna app individual.
Para crear un token de una cuenta de servicio, consulta Cuenta de servicio.
Endpoint
GET https://api.applivery.io/v1/organizations/{organizationId}/stores/{storeId}/pubApps
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
organizationId |
String | Sí | El identificador único de tu organización en Applivery. |
storeId |
String | Sí | El identificador único de la store (proyecto de app) cuyas Publicaciones 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/stores/STORE_ID/pubApps?visibility=active' \
-X GET \
-H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN'
El esquema de respuesta es idéntico al de la Integrations API.