PUT - Actualizar una Publicación

Actualiza la configuración de una Publicación existente. Todos los campos actualizables del endpoint POST – Crear una Publicación están soportados aquí, incluyendo el modo de seguridad, el filtro de Build, el control de acceso, la visibilidad, las sobreescrituras de branding y los términos legales.

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

Cómo elegir la API correcta

Integrations API

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

PUT https://api.applivery.io/v1/integrations/distributions/{publishedApplicationId}

Autenticación

Authorization: Bearer <your_app_token>

Formato de la petición

application/json

Parámetros de ruta

Parámetros

Identidad y visibilidad

Seguridad y control de acceso

Filtro de selección de Build

Opciones de visualización de Builds

Términos legales

Sobreescrituras de branding y configuración de app

Ejemplo de petición

Actualiza una Publicación para apuntar a una rama de git específica y restringe el acceso a usuarios conectados de un grupo concreto:

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

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 actualizar Publicaciones a nivel de Workspace usando una sola credencial en varias Apps.

La autenticación usa un token de cuenta de servicio. Para crear un token de una cuenta de servicio, consulta Cuentas de servicio.

Endpoint

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

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/PUB_APP_ID' \
  -X PUT \
  -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.

Gestión de usuarios con acceso OTP

El acceso OTP (One-Time Password) es una opción de seguridad a nivel de Publicación que te permite compartir Builds de forma segura con usuarios externos — freelancers, estudios de QA, contratistas — sin que necesiten tener una cuenta de Applivery ni pasar por tu SSO. Esto es especialmente útil para organizaciones con políticas de SSO estrictas que necesitan compartir Builds externamente sin relajar su configuración global de autenticación.

El acceso OTP se configura por Publicación y no afecta a ninguna otra Publicación ni a la configuración global de autenticación de la Store Enterprise.

Cómo funciona

Por parte del administrador:

1. Crea o actualiza una Publicación con el acceso OTP habilitado (security: "private" + lista de acceso OTP configurada).

2. Añade las direcciones de email de los usuarios externos autorizados a la lista de acceso OTP, y configura el ciclo de vida y la configuración de uso único de cada usuario.

Por parte del usuario:

1. El usuario visita la URL de la Publicación e introduce su dirección de email.

2. Si su email está en la lista de acceso, recibe un OTP con tiempo limitado por email (válido 5–10 minutos).

3. Introduce el código para verificar su identidad y obtener acceso para descargar la App.

4. Si el uso único está habilitado, su email se elimina automáticamente de la lista de acceso tras la primera descarga correcta.

Añadir usuarios OTP mediante API

Los usuarios OTP se gestionan de forma independiente a la configuración de la Publicación en sí, a través de un endpoint dedicado. Este endpoint se llama después de crear o actualizar una Publicación para añadir usuarios a su lista de acceso OTP.

Endpoint

POST https://api.applivery.io/v1/organizations/{organizationSlug}/stores/{storeId}/otp-users

Autenticación

Authorization: Bearer <your_service_account_token>

Parámetros de ruta

Parámetros del cuerpo

Ejemplo de petición

curl 'https://api.applivery.io/v1/organizations/my-org-slug/stores/STORE_ID/otp-users' \
  -X POST \
  -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "[email protected]",
    "temporal": true,
    "singleUse": false
  }'

Respuestas

{
  "status": true,
  "data": {
    "id": "string",
    "email": "[email protected]",
    "temporal": true,
    "singleUse": false,
    "createdAt": "string"
  }
}

Referencia de opciones de configuración OTP

Cuándo usar el acceso OTP