mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
8e8d75a509
* docs: clarify preview API does not support fork branches * docs: translate fork preview clarification and tighten SEO description * Apply suggestion from @ethanpalm --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
30 lines
1.6 KiB
Plaintext
30 lines
1.6 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="rate-limits">
|
|
## Límites de tasa
|
|
</div>
|
|
|
|
Este endpoint permite hasta 5 solicitudes por minuto por organización.
|