Una clave para la API REST y el servidor MCP

Inicio rápido

Cada solicitud se autentica con una clave de API que creas en la app. Apunta curl, tu CI o cualquier cliente HTTP a https://app.relvato.com/api/v1.

# 1 — Confirm your key works and see the endpoints
curl https://app.relvato.com/api/v1 \
  -H "Authorization: Bearer rlv_your_key"

# 2 — List the sites Relvato monitors for you
curl https://app.relvato.com/api/v1/sites \
  -H "Authorization: Bearer rlv_your_key"

# 3 — Read recent runs (optionally scoped to one site)
curl "https://app.relvato.com/api/v1/runs?limit=10" \
  -H "Authorization: Bearer rlv_your_key"

# 4 — Trigger an on-demand scan of a site
curl -X POST https://app.relvato.com/api/v1/sites/SITE_ID/scan \
  -H "Authorization: Bearer rlv_your_key"

Autenticación

Envía tu clave en cada solicitud como Authorization: Bearer rlv_your_key (también funciona una cabecera x-api-key). Una clave ausente, revocada o desconocida devuelve 401.

Crea y revoca claves en Acceso a la API dentro de la app. Las claves empiezan por rlv_, se muestran una sola vez al crearse y actúan sobre toda tu cuenta: trátalas como una contraseña.

Endpoints REST

Cada endpoint se limita a la cuenta de la clave y devuelve JSON. URL base https://app.relvato.com/api/v1.

Ejemplo: listar sitios

{
  "sites": [
    {
      "id": "st_1a2b3c",
      "name": "style4street",
      "url": "https://style4street.com",
      "connectionType": "wordpress"
    }
  ]
}

Ejemplo: ejecuciones recientes

Una ejecución que falló pero se resolvió después (línea base aceptada o ignorada) informa status: "passed" con resolved: true.

{
  "runs": [
    {
      "id": "rn_9f8e7d",
      "siteId": "st_1a2b3c",
      "journey": "checkout",
      "status": "passed",
      "startedAt": "2026-08-31T09:15:00.000Z",
      "durationMs": 4210,
      "resolved": false
    }
  ]
}

Límites de tasa

Las solicitudes se limitan por minuto y por cuenta, sumando REST y MCP. Tu plan fija el máximo:

Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Al superar el límite se devuelve 429 con una cabecera Retry-After.

Códigos de estado

Servidor MCP (para agentes de IA)

Relvato también es un servidor remoto Model Context Protocol, así un agente como Claude puede listar tus sitios, leer ejecuciones y lanzar escaneos en una conversación. Usa la misma clave y el mismo límite que la API REST.

Endpoint https://app.relvato.com/api/mcp

Añádelo como conector HTTP remoto. En un cliente que lee un mcp.json, la entrada es así:

{
  "mcpServers": {
    "relvato": {
      "type": "http",
      "url": "https://app.relvato.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rlv_your_key"
      }
    }
  }
}

Preguntas frecuentes