mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
a59f8a9eca
* docs: update automations pages for dedicated configure page * docs: unify select terminology in update mode instructions * docs: note that appending runs appear in run history * docs: document grouped runs feed, Modified status, and run actions --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
54 lines
2.4 KiB
Plaintext
54 lines
2.4 KiB
Plaintext
---
|
|
title: "Activar automatización"
|
|
openapi: "/es/openapi.json POST /workflow/{projectId}/{workflowSchemaId}/trigger"
|
|
keywords: ["automation", "workflow", "trigger", "webhook", "schedule", "CI"]
|
|
---
|
|
|
|
Usa este endpoint para activar bajo demanda una automatización programada, en lugar de esperar a su próxima ejecución programada. La automatización se comporta de forma idéntica a una ejecución programada normal: recoge todo lo que ha cambiado desde la última ejecución completada.
|
|
|
|
Este endpoint solo admite automatizaciones configuradas con un activador de **Programación personalizada**. Las solicitudes para automatizaciones con otros activadores, como **Cambio de código** o **Actualización de contenido**, devuelven un error `400`.
|
|
|
|
<div id="use-cases">
|
|
## Casos de uso
|
|
</div>
|
|
|
|
- **Pipelines CI/CD**: Ejecuta la automatización **Update from code changes** en cada fusión a `main`, para que la documentación se actualice según tu cadencia de versiones en lugar de hacerlo según una programación fija.
|
|
- **Eventos de versión**: Ejecuta la automatización **Draft changelog** cuando creas una etiqueta de versión, para que el changelog se redacte al mismo tiempo que se publica la versión.
|
|
- **Herramientas personalizadas**: Activa automatizaciones desde herramientas internas, comandos de Slack o tareas programadas que ya ejecutas.
|
|
|
|
<div id="find-the-automation-id">
|
|
## Encuentra el ID de la automatización
|
|
</div>
|
|
|
|
Ejecuta [`mint automations list`](/es/cli/commands#mint-automations-list) en tu terminal y copia el ID de la salida.
|
|
|
|
<div id="example">
|
|
## Ejemplo
|
|
</div>
|
|
|
|
Activa una automatización desde una GitHub Action cada vez que se fusiona código a `main`:
|
|
|
|
```yaml .github/workflows/trigger-docs.yml
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
|
|
jobs:
|
|
trigger:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- run: |
|
|
curl -fsS -X POST \
|
|
"https://api.mintlify.com/v1/workflow/$PROJECT_ID/$WORKFLOW_ID/trigger" \
|
|
-H "Authorization: Bearer ${{ secrets.MINTLIFY_API_KEY }}"
|
|
env:
|
|
PROJECT_ID: ${{ vars.MINTLIFY_PROJECT_ID }}
|
|
WORKFLOW_ID: ${{ vars.MINTLIFY_WORKFLOW_ID }}
|
|
```
|
|
|
|
<div id="rate-limits">
|
|
## Límites de tasa
|
|
</div>
|
|
|
|
Este endpoint comparte un límite de tasa con [Trigger update](/es/api/update/trigger): hasta 10 solicitudes cada 10 segundos por organización. Las ejecuciones activadas consumen créditos al mismo ritmo que las ejecuciones programadas.
|