Monitores

Notas
Nivel experto
La clave API debe enviarse como un token Bearer en el encabezado Authorization de la solicitud. Obtén tu clave API.
Listar

Endpoint de la API:

GET 
https://monitoractivo.com/api/v1/monitors

Ejemplo de solicitud: 

curl --location --request GET 'https://monitoractivo.com/api/v1/monitors' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parámetro
Tipo
Descripción
search
opcional string
La consulta de búsqueda.
search_by
opcional string
Buscar por. Los valores posibles son: name para Nombre, url para URL. Por defecto: name.
status_page_id
opcional integer
ID de página de estado.
sort_by
opcional string
Ordenar por. Los valores posibles son: id para Fecha de creación, name para Nombre, url para URL. Por defecto: id.
sort
opcional string
Ordenar. Los valores posibles son: desc para Descendente, asc para Ascendente. Por defecto: desc.
per_page
opcional integer
Resultados por página. Los valores posibles son: 10, 25, 50, 100. Por defecto: 100.
Mostrar

Endpoint de la API:

GET 
https://monitoractivo.com/api/v1/monitors/{id}

Ejemplo de solicitud: 

curl --location --request GET 'https://monitoractivo.com/api/v1/monitors/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Guardar

Endpoint de la API:

POST 
https://monitoractivo.com/api/v1/monitors

Ejemplo de solicitud: 

curl --location --request POST 'https://monitoractivo.com/api/v1/monitors' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'name={name}' \
--data-urlencode 'url={url}'
Parámetro
Tipo
Descripción
name
requerido string
Nombre.
url
requerido string
URL.
interval
requerido integer
Intervalo. Los valores posibles son: 60, 180, 300, 600, 900, 1800, 3600.
alert_condition
requerido string
Condición de alerta. Los valores posibles son: url_unavailable para La URL deja de estar disponible, url_text para La respuesta contiene texto, url_no_text para La respuesta no contiene texto.
alert_text_lookup
opcional string
Texto que activará las alertas. Solo funciona cuando el campo alert_condition está configurado como url_text, url_no_text.
request_method
requerido string
Método de solicitud. Los valores posibles son: GET, POST, HEAD, PUT, DELETE, PATCH, OPTIONS.
request_headers[index][key]
opcional string
Nombre del encabezado de la solicitud.
request_headers[index][value]
opcional string
Valor del encabezado de la solicitud.
request_auth_username
opcional string
Username for Basic HTTP request authentication.
request_auth_password
opcional string
Password for Basic HTTP request authentication.
cache_buster
opcional integer
Cache buster. Los valores posibles son: 0 para Deshabilitado, 1 para Habilitado. Por defecto: 0.
ssl_alert_days
opcional integer
Número de días antes del vencimiento del certificado SSL para recibir una alerta. Los valores posibles son: 0, 1, 2, 3, 7, 14, 30, 60.
domain_alert_days
opcional integer
Días antes del vencimiento del dominio para recibir una alerta. Los valores posibles son: 0, 1, 2, 3, 7, 14, 30, 60.
maintenance_start_at
opcional string
Fecha de inicio del mantenimiento en formato Y-m-d H:i.
maintenance_end_at
opcional string
Fecha de finalización del mantenimiento en formato Y-m-d H:i.
alerts[index][key]
opcional string
Canales de alerta. Los valores posibles son: email para Email, webhook para Webhook, slack para Slack, teams para Microsoft Teams, discord para Discord, flock para Flock, telegram para Telegram, sms para SMS.
alerts[index][value]
opcional string
Valor de la alerta.
Actualizar

Endpoint de la API:

PUT PATCH 
https://monitoractivo.com/api/v1/monitors/{id}

Ejemplo de solicitud: 

curl --location --request PUT 'https://monitoractivo.com/api/v1/monitors/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'name={name}'
Parámetro
Tipo
Descripción
name
opcional string
Nombre.
url
opcional string
URL.
interval
opcional integer
Intervalo. Los valores posibles son: 60, 180, 300, 600, 900, 1800, 3600.
alert_condition
opcional string
Condición de alerta. Los valores posibles son: url_unavailable para La URL deja de estar disponible, url_text para La respuesta contiene texto, url_no_text para La respuesta no contiene texto.
alert_text_lookup
opcional string
Texto que activará las alertas. Solo funciona cuando el campo alert_condition está configurado como url_text, url_no_text.
request_method
opcional string
Método de solicitud. Los valores posibles son: GET, POST, HEAD, PUT, DELETE, PATCH, OPTIONS.
request_headers[index][key]
opcional string
Nombre del encabezado de la solicitud.
request_headers[index][value]
opcional string
Valor del encabezado de la solicitud.
request_auth_username
opcional string
Username for Basic HTTP request authentication.
request_auth_password
opcional string
Password for Basic HTTP request authentication.
cache_buster
opcional integer
Cache buster. Los valores posibles son: 0 para Deshabilitado, 1 para Habilitado.
ssl_alert_days
opcional integer
Número de días antes del vencimiento del certificado SSL para recibir una alerta. Los valores posibles son: 0, 1, 2, 3, 7, 14, 30, 60.
domain_alert_days
opcional integer
Días antes del vencimiento del dominio para recibir una alerta. Los valores posibles son: 0, 1, 2, 3, 7, 14, 30, 60.
maintenance_start_at
opcional string
Fecha de inicio del mantenimiento en formato Y-m-d H:i.
maintenance_end_at
opcional string
Fecha de finalización del mantenimiento en formato Y-m-d H:i.
alerts[index][key]
opcional string
Canales de alerta. Los valores posibles son: email para Email, webhook para Webhook, slack para Slack, teams para Microsoft Teams, discord para Discord, flock para Flock, telegram para Telegram, sms para SMS.
alerts[index][value]
opcional string
Valor de la alerta.
paused
opcional boolean
Pausado.
Eliminar

Endpoint de la API:

DELETE 
https://monitoractivo.com/api/v1/monitors/{id}

Ejemplo de solicitud: 

curl --location --request DELETE 'https://monitoractivo.com/api/v1/monitors/{id}' \
--header 'Authorization: Bearer {api_key}'