Disparador Externo (HTTP / cURL)

Jobs|3 min de lectura|Actualizado: 18 sept 2026

Esta funcionalidad permite ejecutar un trabajo (Job) desde fuera de Crestone mediante una URL de endpoint generada automáticamente.
Puede utilizar herramientas de orquestación y desarrollo como Postman, cURL, Apache Airflow o cualquier cliente HTTP.

1. Abrir el Disparador del Trabajo (Job Trigger)

  1. Diríjase a la sección Jobs (Trabajos).
  2. Abra el trabajo que desea ejecutar de forma remota.
  3. Haga clic en el botón Trigger (ubicado en la esquina superior derecha).

Cargando imagen...Abrir disparador del trabajoAbrir disparador del trabajo

2. Obtener la URL del Endpoint

En la pestaña Endpoint:

  • Copie la URL generada.
  • La URL incluye el identificador único del trabajo (<job-id>).
  • La ejecución se invoca a través de una solicitud HTTP POST.

Ejemplo:

http
POST http://<host>/jobs/<job-id>/run/

También se proporciona un comando cURL preconfigurado y listo para usar en la consola.

Cargando imagen...EndpointEndpoint

3. Configurar la Autenticación

En la pestaña Authentication:

  • Se utiliza autenticación basada en Bearer Token.
  • Debe incluir el siguiente encabezado HTTP en su petición:
http
Authorization: Bearer <token>
NOTA

El token de ejecución posee un tiempo de expiración de 1 hora por motivos de seguridad.

Cargando imagen...AutenticaciónAutenticación

4. Configurar Encabezados (Headers)

En la pestaña Headers:

  • De forma predeterminada, se requiere el encabezado de autorización:
http
Authorization: Bearer <token>
  • Puede incluir encabezados adicionales si su arquitectura de red o proxy lo requiere.

Cargando imagen...EncabezadosEncabezados

5. Ejecutar el Trabajo

Ejemplo de invocación utilizando cURL:

shell
curl --request POST 'http://<host>/jobs/<job-id>/run/' \
     --header 'Authorization: Bearer <token>' \
     --header 'Content-Type: application/json'

6. Respuestas del Servidor

  • 200 OK → Ejecución iniciada exitosamente.
  • 400 Bad Request → Encabezados incorrectos, incompletos o sintaxis de petición no válida.
  • 401 Unauthorized → Token de autenticación ausente, no válido o expirado.