account/monitors

Crear un monitor y la primera línea base son gratis. Un ciclo de 30 días se cobra en cuanto el monitor se activa. El precio depende del intervalo de comprobación y cubre todas las comprobaciones que el intervalo programa dentro de un ciclo.

Un intervalo entre dos escalones cuesta lo mismo que el siguiente escalón más frecuente: cada cuatro días cuesta lo mismo que cada tres días.

Las comprobaciones adicionales se producen sobre todo cuando acortas el intervalo a mitad de un ciclo. Cada comprobación adicional correcta cuesta el importe de la tabla.

Pasados 30 días, el ciclo se renueva automáticamente al precio vigente entonces. Las comprobaciones fallidas no cuestan nada. Si pausas, archivas o cambias el intervalo, no reembolsamos nada.

Cada cuenta puede tener hasta 50 monitores a la vez, uno por empresa. En 24 horas puedes crear hasta 50 monitores; los archivados también cuentan.

El precio de un intervalo lo obtienes gratis con GET /v1/account/monitoring/pricing, aquí para una comprobación cada siete días:

1. Crear. Indicas la empresa, el intervalo de comprobación y al menos un endpoint de webhook verificado. El monitor empieza con el estado initializing.
2. Línea base. Registramos como conocidas las señales de los últimos días. No se entregan, así que solo recibes lo nuevo a partir de ahí.
3. Activar. Cobramos el ciclo, el monitor pasa a active y comprueba por primera vez al momento.
4. Comprobar. Después comprueba con el intervalo elegido. Cada señal nueva genera un mensaje por monitor a tus endpoints de webhook.
5. Renovar. Tras cada ciclo se cobra automáticamente el siguiente, mientras tu saldo lo cubra.

El intervalo de comprobación está entre 1 y 30 días. El momento exacto de una comprobación puede variar dentro de una hora. Cada comprobación mira unos días hacia atrás, para que también lleguen las inscripciones publicadas tarde.

Un monitor entrega los temas de Signals de tu plan: cinco en cualquier cuenta, Insolvencias con Pro, Transformaciones y M&A con Max. Un webhook lleva en el campo data.signal la misma señal que signals.

En monitores pausados y con errores, status_reason explica por qué, por ejemplo no_verified_endpoint o insufficient_cycle_floor.

Todas las rutas están bajo /v1/account. Lees y escribes con tu clave API en el header x-api-key.

Cada solicitud de escritura necesita el header Idempotency-Key, un valor único por operación, idealmente un UUID. Sin él, la API responde con 428.

Si repites una solicitud con la misma clave y los mismos datos en 24 horas, recibes de vuelta la respuesta guardada. Lleva el header Idempotency-Status: replayed. Así un error de red no crea un segundo monitor.

Esto aplica también a las respuestas de error. Así que, para un nuevo intento tras una corrección, usa una clave nueva. La misma clave con datos distintos devuelve 409.

Se permiten hasta 128 caracteres: letras, dígitos y . _ : -. El primer carácter es una letra o un dígito. Una clave con cualquier otro formato devuelve 400.

Necesitas la entity_id de la empresa y al menos un endpoint de webhook verificado, consulta account/webhook-endpoints.

La API responde con 202: el monitor está creado, y la línea base y la activación se ejecutan en segundo plano. meta.billing.charged_credits muestra que no se cobró nada por ello.

GET /v1/account/monitors devuelve hasta 100 monitores en monitors, con total. Los archivados no están en la lista.

GET /v1/account/monitors/{id} muestra además el ciclo actual en billing_cycle y las últimas comprobaciones en recent_runs.

PATCH /v1/account/monitors/{id} cambia el intervalo de comprobación. La siguiente comprobación sigue entonces el nuevo intervalo, contado desde el cambio.

El ciclo actual mantiene su precio y sus comprobaciones incluidas. El nuevo precio rige desde el siguiente ciclo. Un intervalo más corto puede generar comprobaciones adicionales en el ciclo actual.

POST …/{id}/pause detiene un monitor activo. El ciclo pagado sigue corriendo hasta su fin, y no se reembolsa nada.

POST …/{id}/resume reanuda un monitor pausado o con error. Volvemos a comprobar los endpoints de webhook, el saldo y el precio.

Dentro del ciclo pagado actual, reanudar no cuesta nada. Si el ciclo ha terminado, empieza ahora un ciclo nuevo al precio actual. meta.request_credit_cost muestra el importe.

Si, por ejemplo, falta un endpoint de webhook verificado, la API responde igualmente con 200, pero con meta.activated: false. El estado del monitor y status_reason indican el motivo.

Si el precio ha cambiado, un monitor activo se detiene al final del ciclo con pricing_consent_required. Con resume aceptas el nuevo precio.

DELETE …/{id} archiva el monitor definitivamente. Es irreversible y no reembolsa nada.

Los errores tienen la estructura {"error": "…", "meta": {"message": "…"}}. En tu programa, comprueba el valor de error. El texto de meta.message está en inglés y puede cambiar. Los errores no cuestan nada.