POST - Crear una Publicación

Crea una nueva Publicación en la Store Enterprise de Applivery. Una Publicación es la configuración de distribución que controla cómo y a quién se pone a disposición una Build específico (o conjunto de Builds) de una App — incluyendo su slug de URL, modo de seguridad, visibilidad, filtros de acceso y sobreescrituras de branding.

Para una visión general conceptual de las Publicaciones y su relación con las Builds, consulta Cómo distribuir tus apps.

Applivery proporciona dos APIs independientes para crear Publicaciones, cada una con una credencial de autenticación diferente.

Cómo elegir la API correcta

Integrations API

Usa este endpoint para crear 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

POST https://api.applivery.io/v1/integrations/distributions

Autenticación

Authorization: Bearer <your_app_token>

Formato de la petición

application/json

Parámetros

Los parámetros están agrupados por área de configuración.

Parámetros obligatorios

Filtro de selección de Build

Control de acceso

Opciones de visualización de Builds

Términos legales

Sobreescrituras de branding y configuración de app

Modos de seguridad

Modos de visibilidad

Configuración de filtros

Ejemplos de petición

Publicación mínima — pública, sirviendo siempre el último Build:

curl 'https://api.applivery.io/v1/integrations/distributions' \
  -X POST \
  -H 'Authorization: Bearer YOUR_APP_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "slug": "my-app-staging",
    "security": "public",
    "visibility": "active",
    "filter": {
      "type": "last"
    }
  }'

Publicación privada con control de acceso por grupos e historial de builds:

curl 'https://api.applivery.io/v1/integrations/distributions' \
  -X POST \
  -H 'Authorization: Bearer YOUR_APP_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "slug": "my-app-internal",
    "security": "logged",
    "visibility": "active",
    "filter": {
      "type": "gitBranch",
      "value": "develop"
    },
    "groups": [["qa-team", "developers"]],
    "showHistory": true,
    "showDevInfo": true,
    "tags": ["internal", "qa"]
  }'

Respuestas

{
  "status": true,
  "data": {
    "id": "string",
    "updatedAt": "string",
    "createdAt": "string",
    "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"]],
    "visibility": "active",
    "showHistory": true,
    "showDevInfo": true,
    "distributionUrl": "string",
    "terms": {
      "active": true,
      "text": "string"
    }
  }
}

{
  "status": false,
  "error": {
    "code": 5024,
    "message": "Slug already used"
  }
}

{
  "status": false,
  "error": {
    "code": 4002,
    "message": "No auth token"
  }
}

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

Workspace API

Usa este endpoint para crear Publicaciones a nivel de Workspace — por ejemplo, en flujos de trabajo de platform engineering 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 Cuentas de servicio.

Endpoint

POST https://api.applivery.io/v1/organizations/{organizationId}/stores/{storeId}/pubApps

Parámetros de ruta

Autenticación

Authorization: Bearer <your_service_account_token>

Ejemplo de petición

curl 'https://api.applivery.io/v1/organizations/ORG_ID/stores/STORE_ID/pubApps' \
  -X POST \
  -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "slug": "my-app-release",
    "security": "public",
    "visibility": "active",
    "filter": {
      "type": "last"
    }
  }'

Los parámetros del cuerpo de la petición y el esquema de respuesta son idénticos a los de la Integrations API.