Conectar Semaphore a tus herramientas

Webhook selecciona plantilla y entradas de un evento. REST API ofrece gestión y ejecución explícita con seguimiento. Ambos usan el modelo Semaphore. Elige según datos y seguimiento del llamante.

Un alias de proyecto evalúa las reglas de sus integraciones y puede iniciar las que coinciden con la solicitud. Un alias específico llama directamente a una integración sin evaluar sus reglas. Esto importa si esperas que una regla de rama o tipo de evento controle la ejecución. Elige el endpoint deliberadamente y prueba datos coincidentes y no coincidentes, sin asumir el mismo filtro para todos los alias.

Configura extractores para leer cabeceras o campos pertinentes y asignarlos a variables o parámetros documentados. Los destinos deben coincidir con los campos aceptados. Mantén la asignación precisa: una versión debe convertirse en la entrada prevista, no en un fragmento de comando sin restricciones. Valida el significado donde corresponda y prueba campos ausentes o inesperados antes de producción.

Un token API actúa con los permisos de su usuario Semaphore. Usa una identidad cuyo acceso corresponda a las operaciones previstas y protege el token donde lo guarde el llamante. La API no elude la autorización del proyecto. Configura deliberadamente autenticación y exposición de webhooks. Separa la autenticación del llamante de las credenciales que la tarea usa para la infraestructura.

Conserva el ID de tarea devuelto y usa los métodos documentados para estado y salida. Una solicitud correcta indica ejecución solicitada, no infraestructura terminada. Distingue errores, espera, ejecución y resultado. Enlaza a la tarea para consultar pruebas.

No asumas ejecución exactamente una vez ni entrega duradera garantizada. Un servicio puede reintentar tras un timeout aunque la primera solicitud llegara. Diseña duplicados y reintentos según consecuencias y usa idempotencia cuando proceda. Conserva la correlación entre evento y ejecución para entender entregas repetidas o inciertas.

La referencia representa el Swagger/OpenAPI publicado con una versión específica, no un resumen manual. Consulta /api-docs/ o el documento bruto para generar cliente. Verifica la versión que usas porque cambian endpoints y esquemas.

El llamante necesita alcanzar Semaphore, no necesariamente por Internet público. Red privada, VPN o balanceador bastan. Nuestra prueba usó loopback sin autenticación, no un modelo público. Si se expone fuera de confianza, añade autenticación admitida y restricciones de red.

Prueba primero una plantilla inocua con curl o cliente HTTP. Envía datos no coincidentes y verifica ausencia de tarea, luego datos coincidentes y una sola tarea. Abre Details: registra la integración como origen y muestra valores extraídos. Así probamos localmente y detectamos claves incorrectas antes de depender del servicio.

Sí. REST API cubre proyectos, repositorios, inventarios, credenciales, Variable Groups, plantillas y más. Configura, inicia y consulta resultados. Pro añade workflows y aprobaciones para operaciones completas CI/CD. Usa OpenAPI para parámetros y esquemas.