Documentación

La API

Todo lo que hace el portal lo hace la API. Así se llama, sin entrar antes.

El portal es opcional

No hay endpoints privados: cada pantalla de HopMango está construida sobre la misma API pública que llama un script, una pipeline o un asistente.

Dónde vive la API

Un origen y un prefijo de versión. Todo lo de abajo cuelga de ahí.

URL base

https://api.hopmango.com

Toda la superficie está descrita en un documento OpenAPI que sirve la propia API. https://api.hopmango.com/openapi.yaml

Autenticación

Crea una clave de API en el portal, en Ajustes → Claves de API, y envíala como bearer token.

La cabecera que lleva cada llamada

Authorization: Bearer hm_your_key_here

Una clave se muestra una sola vez y se guarda como hash. Guárdala en una variable de entorno, nunca en un repositorio; pueden estar activas dos mientras rotas una.

Cuatro llamadas para empezar

Exporta antes tu clave como HOPMANGO_API_KEY.

Listar los hosts

curl -s https://api.hopmango.com/v1/hosts \
  -H "Authorization: Bearer $HOPMANGO_API_KEY"

Listar los incidentes abiertos

curl -s "https://api.hopmango.com/v1/incidents?status=open" \
  -H "Authorization: Bearer $HOPMANGO_API_KEY"

Reconocer un incidente

curl -s -X POST https://api.hopmango.com/v1/incidents/{incidentId}/acknowledge \
  -H "Authorization: Bearer $HOPMANGO_API_KEY"

Crear un monitor de web

curl -s -X POST https://api.hopmango.com/v1/synthetics/monitors \
  -H "Authorization: Bearer $HOPMANGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Storefront","url":"https://www.example.com","interval":"60s","for":"2m"}'

Límites de uso

Por organización y por credencial, con lecturas y escrituras contadas aparte. Toda respuesta lleva cabeceras RateLimit-*; un rechazo lleva Retry-After.

Conectar un asistente

Las mismas operaciones están expuestas por MCP, para tu propio asistente: Documentación de IA y MCP