mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
f072caaf92
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
36 lines
2.1 KiB
Plaintext
36 lines
2.1 KiB
Plaintext
---
|
|
title: "Activar implementación de vista previa"
|
|
openapi: "/es/openapi.json POST /project/preview/{projectId}"
|
|
keywords: ["preview", "preview deployment", "branch preview", "staging"]
|
|
---
|
|
|
|
Usa este endpoint para crear o actualizar de forma programática una implementación de vista previa para una rama de Git. Si ya existe una vista previa para la rama especificada, el endpoint activa una reimplementación en lugar de crear un duplicado.
|
|
|
|
La respuesta incluye un `statusId` que puedes pasar a [Get deployment status](/es/api/update/status) para rastrear el progreso de la implementación.
|
|
|
|
<div id="branch-requirements">
|
|
## Requisitos de la rama
|
|
</div>
|
|
|
|
La `branch` debe existir en el repositorio conectado a tu proyecto de Mintlify. Las ramas de forks no son compatibles. La aplicación de GitHub de Mintlify debe estar instalada en un repositorio para generar una vista previa, por lo que no puede generar vistas previas a partir de ramas de forks. Consulta [Solicitudes de extracción de forks](/es/deploy/preview-deployments#fork-pull-requests) para saber cómo previsualizar cambios de un fork.
|
|
|
|
<div id="use-cases">
|
|
## Casos de uso
|
|
</div>
|
|
|
|
- **Pipelines CI/CD**: Crea automáticamente implementaciones de vista previa cuando se abren o actualizan solicitudes de extracción.
|
|
- **Vistas previas programadas**: Genera vistas previas de ramas de funcionalidades de larga duración de forma programada.
|
|
- **Herramientas personalizadas**: Integra la creación de vistas previas en flujos de trabajo internos o bots de Slack.
|
|
|
|
<div id="access-to-previews">
|
|
## Acceso a las vistas previas
|
|
</div>
|
|
|
|
Las vistas previas creadas con este endpoint son accesibles públicamente a menos que habilites la autenticación para tus vistas previas, lo cual se aplica a todas las vistas previas de tu implementación. No puedes proteger con contraseña una vista previa individual a través de este endpoint. Consulta [Restringir el acceso a las implementaciones de vista previa](/es/deploy/preview-deployments#restrict-access-to-preview-deployments).
|
|
|
|
<div id="rate-limits">
|
|
## Límites de tasa
|
|
</div>
|
|
|
|
Este endpoint permite hasta 5 solicitudes por minuto por organización.
|