API
Tokens, cuentas, límites de peticiones y dónde encontrar la referencia completa.
Referencia completa
Todos los endpoints, parámetros y respuestas están en la referencia de la API, generada a partir de nuestra descripción OpenAPI en /openapi.yaml.
Tokens
Crea un token en Ajustes › Tokens de API. Elige Solo lectura para paneles y consultas de estado, o Lectura y escritura para hacer cambios, y, si quieres, cuándo caduca. El token se muestra una sola vez, al crearlo, así que cópialo en ese momento: solo guardamos una copia cifrada. Envíalo como token bearer:
curl https://pingerer.com/api/v1/sites \
-H "Authorization: Bearer YOUR-TOKEN"
Elegir la cuenta
Si perteneces a varias cuentas, elige una con la cabecera Pingerer-Account (el id de la cuenta) o con el parámetro account_id. Si no, se usa la cuenta del propio token y, después, tu primera cuenta de equipo.
Qué puedes hacer
- Sitios y monitores: listar, agregar, cambiar, pausar, reanudar, probar ahora, resultados y disponibilidad. Incluye la fecha de renovación de los dominios cuyo registro la mantiene privada (
renews_on). - Salud del sitio: la puntuación de salud de cada sitio y qué arreglar, y volver a comprobarlo ahora.
- Incidentes: listar, atender, agregar notas y resolver. Cuando la causa probable es tu proveedor de hosting, el incidente dice qué empresa es.
- Heartbeats, canales de alerta y horas de silencio (con tu fin de semana).
- Ventanas de mantenimiento, páginas de estado y actualizaciones (con las direcciones de sus insignias) e informes mensuales.
- Herramientas: cómo se ve cualquier página cuando se comparte su enlace, y el tiempo en internet (qué proveedores de hosting y CDN tienen problemas ahora mismo).
GET /api/v1/statuspara saber rápido si todo está en línea.
Los tokens de los miembros pueden leer y atender incidentes; los cambios necesitan el token de un administrador.
Webhooks
Para recibir alertas en tu propio código, agrega un canal de alerta de tipo webhook. Cada alerta es un POST JSON firmado; Alertas y canales explica qué contiene y cómo verificar la firma.
Respuestas y errores
Las respuestas son JSON con la forma {"data": ..., "meta": ...}. Los errores son {"error": "code", "message": "...", "details": ...}. Superar un límite del plan devuelve 422 con plan_limit; un token de solo lectura que intenta escribir recibe 403 read_only_token.
Límites de peticiones
300 peticiones por minuto y token. Si te pasas, recibes 429; espera un momento y vuelve a intentarlo.
¿Sigues atascado? Escríbenos y te responderá una persona.