API de monitoramento de uptime
Tudo o que você faz no aplicativo também dá para fazer pela API REST: criar monitores a partir do seu pipeline de deploy, levar uptime e tempos de resposta para os seus próprios painéis, manter status pages e canais de alerta sincronizados. JSON na entrada, JSON na saída, um único token Bearer. Os tokens de API estão disponíveis a partir do plano Business.
Primeiros passos
URL base
https://app.centoculus.com/api/v1
Toda requisição leva dois cabeçalhos: Authorization: Bearer <token> e Accept: application/json. Requisições com corpo enviam JSON com Content-Type: application/json.
- Crie um token em Minha conta → Tokens de API no aplicativo web ou no aplicativo de celular e escolha os scopes dele.
- Copie o token na hora; ele é exibido só uma vez.
- Chame
GET /me. Funciona com qualquer token e mostra de quem ele é.
Sua primeira chamada:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
A resposta é o seu usuário com função, idioma e os espaços de trabalho que o token alcança (resumida):
{
"data": {
"id": 4821,
"name": "Mara Lindqvist",
"email": "mara@example.com",
"role": "customer_admin",
"role_label": "admin",
"locale": "en",
"timezone": "Europe/Stockholm",
"customers": [{"id": 1207, "name": "Example Ltd"}],
"default_customer_id": 1207
}
}
Tokens e scopes
Um token tem um nome, uma validade opcional (até 730 dias) e os scopes que pode usar. Escolha só os scopes de que uma integração precisa: um painel recebe monitors:read e incidents:read, um script de deploy recebe monitors:write. Nos planos abaixo do Business, a seção fica visível, mas desativada.
| Scope | Permite |
|---|---|
monitors:read | Listar e exibir monitores, uptime, uptime diário, tempos de resposta, tipos de verificação, locais e o resumo do painel |
monitors:write | Criar, atualizar, excluir, pausar e retomar monitores |
servers:read | Listar e exibir servidores e suas métricas |
servers:write | Criar, atualizar, excluir, pausar e retomar servidores; novo comando de instalação do agente |
incidents:read | Listar e exibir incidentes, resumo do painel |
status-pages:read | Listar e exibir status pages |
status-pages:write | Criar, atualizar e excluir status pages e seus avisos |
notifications:read | Listar e exibir canais de notificação e tipos de canal |
notifications:write | Criar, atualizar e excluir canais (e-mail, Telegram, webhook, push), enviar um teste |
GET /me funciona com qualquer token. Cobrança, equipe, tokens, segurança da conta e reparos não são acessíveis com um token de API e respondem 403, assim como uma chamada sem o scope correspondente.
Revogue um token no mesmo lugar; ele para de funcionar na hora.
Convenções
- As respostas são JSON. Um objeto único vem em
data, uma lista emdatacomlinksemeta. - Monitores e servidores são endereçados por UUID; incidentes, status pages e canais de notificação por um id numérico.
- Os horários seguem ISO 8601 em UTC, por exemplo
2026-11-15T08:30:00.000000Z. - As listas são paginadas com os parâmetros de consulta
pageeper_page;metatrazcurrent_page,last_page,per_pageetotal. Tamanhos de página padrão: monitores 15 (máx. 200), incidentes 25 (máx. 100), canais de notificação 50, servidores 100, status pages 15. - Contas com vários espaços de trabalho (parceiros e revendedores) passam
customer_idao criar algo e podem filtrar as listas com ele. Contas de cliente não o usam. - Não há uma cota geral de requisições. Alguns endpoints têm limite de frequência, por exemplo o reenvio de uma confirmação de e-mail (10 por minuto); eles respondem 429 com
Retry-After. Não consulte com mais frequência que o seu intervalo de verificação; para dados em tempo real, use um canal de webhook.
Erros
Os erros são JSON com uma message. Erros de validação acrescentam errors com uma lista de mensagens por campo.
| Status | Significado |
|---|---|
401 | Token ausente, inválido, expirado ou revogado. |
402 | O monitoramento está pausado porque o saldo pré-pago acabou (clientes de revendedores); ele é retomado após uma recarga. |
403 | O token não tem o scope, o endpoint está fechado para tokens de API ou o seu plano não inclui o recurso. |
404 | Não encontrado, ou fora do seu espaço de trabalho. |
409 | Conflito, por exemplo confirmar um endereço de e-mail que já está confirmado. |
422 | A validação falhou; veja errors. Quando o limite do plano é atingido, upgrade indica o recurso que um plano maior libera. |
429 | Requisições demais a um endpoint com limite de frequência; aguarde os segundos indicados em Retry-After. |
Um erro de validação:
HTTP/1.1 422 Unprocessable Content
{
"message": "The target field is required. (and 1 more error)",
"errors": {
"target": ["The target field is required."],
"interval_seconds": ["The interval must be at least 60 seconds on your plan."]
}
}
Monitores
Um monitor é uma verificação: um site, um certificado SSL, um ping, uma porta TCP, um registro DNS, um heartbeat de cron ou a configuração de e-mail de um domínio. Tipos: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types mostra quais tipos, intervalos e locais o seu plano inclui e os valores padrão de cada tipo.
| Endpoint | O que faz |
|---|---|
GET /monitors |
Listar; filtros status, search, ids (separados por vírgula), with_stats=1 acrescenta uptime e o último tempo de resposta |
POST /monitors |
Criar; as verificações começam em segundo plano |
GET /monitors/{id} |
Um monitor com seus locais e o incidente aberto |
PATCH /monitors/{id} |
Atualizar; o tipo não pode mudar |
DELETE /monitors/{id} |
Excluir (204) |
POST /monitors/{id}/pause |
Pausar; um incidente aberto é encerrado |
POST /monitors/{id}/resume |
Retomar |
GET /check-types |
Tipos, valores padrão e os limites do seu plano |
GET /locations |
Locais de verificação ativos (code, name, country) |
Campos ao criar
| Campo | Descrição |
|---|---|
name |
Nome de exibição, até 255 caracteres. Obrigatório. |
type |
Um dos tipos acima. Obrigatório, fixo depois. |
target |
URL, nome de host, endereço IP ou domínio, conforme o tipo. Obrigatório, exceto para heartbeat, que fornece uma URL de ping. |
interval_seconds |
Intervalo de verificação. O mínimo depende do seu plano; GET /check-types o retorna como limits.min_interval_seconds. |
locations |
Códigos de local, por exemplo ["eu", "sg"]. Quantos você pode escolher depende do seu plano. |
primary_location |
Local principal que confirma primeiro as quedas (Smart Verify). |
confirm_locations |
Quantos locais precisam ver a falha antes de você ser avisado (1–3). Configurável nos planos maiores. |
confirm_checks |
Quantas verificações seguidas com falha confirmam uma queda (1–3). Configurável nos planos maiores. |
options |
Conforme o tipo. Para http: method (GET, HEAD, POST), expected_status (p. ex. 200-399 ou 200,301), keyword com keyword_mode (present ou absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Opções omitidas assumem os padrões de GET /check-types. |
Criar uma verificação de site com uma palavra-chave:
curl -X POST https://app.centoculus.com/api/v1/monitors \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Shop",
"type": "http",
"target": "https://shop.example.com",
"interval_seconds": 60,
"locations": ["eu", "sg"],
"options": {"keyword": "Add to cart", "expected_status": "200-399"}
}'
A resposta (201) é o monitor. provisioning.state passa a synced assim que os locais o assumem, e status vai de pending a up após a primeira verificação:
{
"data": {
"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
"customer_id": 1207,
"name": "Shop",
"type": "http",
"target": "https://shop.example.com",
"interval_seconds": 60,
"options": {
"method": "GET",
"expected_status": "200-399",
"keyword": "Add to cart",
"keyword_mode": "present",
"timeout_seconds": 10,
"check_ssl": true,
"warn_days": 14,
"crit_days": 3,
"allow_self_signed": false
},
"location_codes": ["eu", "sg"],
"primary_location": "eu",
"smart_verify": true,
"confirm_locations": 1,
"confirm_checks": 1,
"status": "pending",
"is_paused": false,
"provisioning": {"state": "pending"},
"locations": [
{"code": "eu", "role": "primary", "name": "Europe", "status": "pending", "last_response_ms": null, "last_checked_at": null},
{"code": "sg", "role": "verify", "name": "Singapore", "status": "pending", "last_response_ms": null, "last_checked_at": null}
],
"open_incident": null,
"last_checked_at": null,
"status_changed_at": null,
"created_at": "2026-11-15T08:30:12.000000Z",
"updated_at": "2026-11-15T08:30:12.000000Z"
}
}
Valores de status: pending, up, degraded, down, paused.
Pausar um monitor durante um deploy e retomá-lo depois:
curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/pause \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/resume \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
Uptime e tempos de resposta
O uptime é calculado a partir das quedas (incidentes de gravidade major); avisos, como um certificado prestes a expirar, não contam. Ainda não verificado significa null, não 100.
| Endpoint | O que faz |
|---|---|
GET /monitors/{id}/uptime |
Uptime em porcentagem das últimas 24 horas, 7 dias e 30 dias |
GET /monitors/{id}/daily-uptime |
Uptime por dia do calendário (UTC), days 1–90, padrão 30 |
GET /monitors/{id}/response-times |
Tempo de resposta e disponibilidade por local, range 24h, 7d ou 30d; pontos por hora, diários para 30d |
Uptime:
curl https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/uptime \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{"data": {"24h": 100, "7d": 99.952, "30d": 99.987}}
Tempos de resposta (resumido):
curl "https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/response-times?range=24h" \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": {
"range": "24h",
"locations": {
"eu": [
{"time": "2026-11-15T07:00:00+00:00", "avg_ms": 212.4, "min_ms": 180, "max_ms": 402, "availability": 100},
{"time": "2026-11-15T08:00:00+00:00", "avg_ms": 230.1, "min_ms": 190, "max_ms": 388, "availability": 100}
],
"sg": [
{"time": "2026-11-15T07:00:00+00:00", "avg_ms": 512.8, "min_ms": 470, "max_ms": 790, "availability": 100}
]
}
}
}
Servidores
Um servidor é uma máquina com o agente instalado, que informa CPU, memória, carga, discos, rede e serviços. Criar um servidor retorna o comando de instalação de uso único; execute-o na máquina e o servidor aparece um instante depois.
| Endpoint | O que faz |
|---|---|
GET /servers |
Listar; filtro ids |
POST /servers |
Criar; a resposta traz install_command (Linux) e install_command_freebsd |
GET /servers/{id} |
Um servidor com inventário, último snapshot e limites |
PATCH /servers/{id} |
Renomear, escolher os services monitorados, definir thresholds |
DELETE /servers/{id} |
Excluir (204); o agente é removido do monitoramento |
POST /servers/{id}/pause |
Pausar; incidentes abertos são encerrados |
POST /servers/{id}/resume |
Retomar |
POST /servers/{id}/install-token |
Novo comando de instalação; rotate_key=true também emite uma nova chave do agente |
GET /servers/{id}/metrics |
Séries para gráficos, range 24h, 7d ou 30d: métrica → contexto → [unix time, avg, min, max] |
| Campo | Descrição |
|---|---|
name |
Nome de exibição, até 100 caracteres. Obrigatório ao criar. |
services |
Nomes dos serviços que o agente deve monitorar, por exemplo ["nginx", "php8.4-fpm", "mariadb"]; até 200. O servidor informa o que encontrou em discovered.services. |
thresholds |
Limites de alerta: cpu_max (porcentagem), load_max_per_cpu, mem_min_pavail (porcentagem livre), fs_warn e fs_crit (porcentagem usada), inode_warn, agent_nodata_minutes, por ponto de montagem em filesystems, e as expressões regulares fs_types, fs_exclude, net_exclude. Valores omitidos mantêm os padrões. |
Adicionar um servidor e ler o comando de instalação na resposta:
curl -X POST https://app.centoculus.com/api/v1/servers \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name": "web-1"}'
{
"data": {
"id": "a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58",
"customer_id": 1207,
"name": "web-1",
"status": "pending",
"is_paused": false,
"provisioning": {"state": "pending"},
"services": [],
"install_token_expires_at": "2026-11-16T08:30:12.000000Z",
"install_command": "curl -fsSL https://app.centoculus.com/install/K7xQ2mVt9…Rd | sudo sh",
"install_command_freebsd": "fetch -qo - https://app.centoculus.com/install/K7xQ2mVt9…Rd | sh",
"created_at": "2026-11-15T08:30:12.000000Z"
}
}
Monitorar três serviços e alertar com 80 por cento de uso do disco:
curl -X PATCH https://app.centoculus.com/api/v1/servers/a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58 \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"services": ["nginx", "php8.4-fpm", "mariadb"],
"thresholds": {"fs_warn": 80, "fs_crit": 90}
}'
Incidentes
Um incidente é uma queda ou um aviso de um monitor ou servidor, de started_at até resolved_at. Cada incidente traz seu número de alerta, o mesmo que o e-mail de alerta mostra.
| Endpoint | O que faz |
|---|---|
GET /incidents |
Mais recentes primeiro; filtros monitor_id, status (open ou closed), open=1 (quedas abertas sem avisos), from e to (datas) |
GET /incidents/{id} |
Um incidente com sua linha do tempo: quando cada local caiu e se recuperou, e o reparo que o resolveu |
Incidentes abertos:
curl "https://app.centoculus.com/api/v1/incidents?status=open&per_page=10" \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": [
{
"id": 90412,
"monitor_id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
"monitor_name": "Shop",
"server_id": null,
"subject_type": "monitor",
"severity": "major",
"cause": "unreachable",
"started_at": "2026-11-15T09:14:03.000000Z",
"resolved_at": null,
"duration_seconds": 241,
"alert_number": 101,
"alert_label": "Incident #101",
"affected_locations": ["eu", "sg"],
"failure_reason": "HTTP 502 instead of 200-399",
"fix": null
}
],
"links": {"first": "…?page=1", "last": "…?page=1", "prev": null, "next": null},
"meta": {"current_page": 1, "from": 1, "last_page": 1, "per_page": 10, "to": 1, "total": 1}
}
Campos úteis: subject_type (monitor ou server), severity (major, warning, info), cause (por exemplo unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations e, enquanto aberto, failure_reason com os últimos valores da verificação.
Status pages
Uma status page mostra monitores escolhidos ao público ou à sua equipe, no nosso domínio ou no seu. Os avisos anunciam manutenções ou explicam um incidente em andamento.
| Endpoint | O que faz |
|---|---|
GET /status-pages |
Listar |
POST /status-pages |
Criar |
GET /status-pages/{id} |
Uma página com monitores, avisos e o estado dos seus domínios |
PATCH /status-pages/{id} |
Atualizar; monitors substitui a lista inteira |
DELETE /status-pages/{id} |
Excluir (204) |
POST /status-pages/{id}/notices |
Adicionar um aviso |
PUT /status-pages/{id}/notices/{notice} |
Atualizar um aviso |
DELETE /status-pages/{id}/notices/{notice} |
Remover um aviso (204) |
| Campo | Descrição |
|---|---|
slug |
Parte do endereço, 3–63 caracteres, letras minúsculas, dígitos e hifens; único. Obrigatório. |
title |
Título da página. Obrigatório. |
description |
Texto curto abaixo do título, até 2000 caracteres. |
logo_url |
Endereço HTTPS de um logotipo. |
custom_domain |
Domínio próprio, como status.example.com; exige um plano com domínios de status próprios. |
is_public |
Pública (true) ou só para usuários conectados. |
monitors |
Lista ordenada de {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name e group são opcionais. |
Um aviso tem kind (maintenance, info ou incident), title, body (opcional, até 5000 caracteres), starts_at e um ends_at opcional.
Criar uma status page pública com dois monitores:
curl -X POST https://app.centoculus.com/api/v1/status-pages \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"slug": "example-status",
"title": "Example status",
"is_public": true,
"monitors": [
{"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "display_name": "Online shop", "group": "Web"},
{"id": "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f", "group": "Web"}
]
}'
Anunciar uma janela de manutenção:
curl -X POST https://app.centoculus.com/api/v1/status-pages/318/notices \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"kind": "maintenance",
"title": "Database upgrade",
"body": "Checkout will be unavailable for about 15 minutes.",
"starts_at": "2026-11-20T01:00:00Z",
"ends_at": "2026-11-20T01:30:00Z"
}'
Canais de notificação
Um canal de notificação é uma forma de alcançar alguém: um endereço de e-mail, um chat do Telegram, um webhook ou os dispositivos push de um usuário. Um canal recebe os alertas de todos os monitores do espaço de trabalho ou só os dos monitores em monitor_ids. Quais tipos de canal o seu plano inclui: GET /notification-channel-types.
| Endpoint | O que faz |
|---|---|
GET /notification-channels |
Listar |
POST /notification-channels |
Criar; em um webhook, o secret de assinatura aparece só nesta resposta |
GET /notification-channels/{id} |
Um canal |
PATCH /notification-channels/{id} |
Atualizar; o tipo não pode mudar |
DELETE /notification-channels/{id} |
Excluir (204) |
POST /notification-channels/{id}/test |
Enviar uma notificação de teste (202); um endereço de e-mail não confirmado recebe de novo o link de confirmação |
GET /notification-channel-types |
Tipos de canal com available e paid |
| Campo | Descrição |
|---|---|
type |
email, telegram, webhook ou push. Obrigatório, fixo depois. |
name |
Nome de exibição. Obrigatório. |
config |
Conforme o tipo: {"email": "…"}, {"chat_id": "…"} ou {"url": "https://…"}. Push não precisa de configuração. Um novo endereço de e-mail precisa ser confirmado por link antes de os alertas serem enviados. |
monitor_ids |
UUIDs dos monitores a que este canal se destina; omita para todos os monitores. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: sem alertas nessa faixa. |
escalation_delay_minutes |
Alertar este canal só quando uma queda dura tanto tempo (0–1440). |
notify_recovery |
Enviar também o aviso de normalização (true ou false). |
is_active |
Ligar ou desligar o canal sem excluí-lo. |
Criar um canal de webhook para dois monitores e guardar o secret:
curl -X POST https://app.centoculus.com/api/v1/notification-channels \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"type": "webhook",
"name": "Ops bot",
"config": {"url": "https://hooks.example.com/centoculus"},
"monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
"notify_recovery": true
}'
{
"data": {
"id": 512,
"customer_id": 1207,
"type": "webhook",
"name": "Ops bot",
"config": {"url": "https://hooks.example.com/centoculus", "secret": "wq7Hc2…48 characters…Zp"},
"quiet_hours": null,
"escalation_delay_minutes": 0,
"notify_recovery": true,
"is_active": true,
"confirmed": true,
"monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
"created_at": "2026-11-15T08:41:55.000000Z",
"updated_at": "2026-11-15T08:41:55.000000Z"
}
}
Payload do webhook
Um canal de webhook envia cada alerta por POST como JSON para a sua URL, com timeout de 10 segundos e sem redirecionamentos. O destino precisa ser um endereço público.
Cabeçalhos: X-Webhook-Timestamp (tempo Unix), X-Webhook-Signature (sha256= seguido do HMAC-SHA256 de <timestamp>.<body> com o secret do canal como chave) e User-Agent: Uptime-Webhook/1.
event é down, recovered, paused ou test. Em um alerta de monitor, o corpo traz monitor (id, name, target) e incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); em um alerta de servidor, server (id, name) e incident com problem no lugar dos locais. subject é o título do alerta no idioma do canal.
Corpo de um alerta de queda:
POST /your-endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Uptime-Webhook/1
X-Webhook-Timestamp: 1794912843
X-Webhook-Signature: sha256=3f1b9c…e2a7
{
"event": "down",
"monitor": {"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "name": "Shop", "target": "https://shop.example.com"},
"incident": {
"id": 90412,
"severity": "major",
"cause": "unreachable",
"started_at": "2026-11-15T09:14:03+00:00",
"resolved_at": null,
"duration_seconds": 0,
"affected_locations": ["eu", "sg"]
},
"subject": "DOWN: Shop"
}
Verifique a assinatura antes de confiar no corpo: calcule o HMAC sobre o corpo bruto exatamente como recebido e compare em tempo constante. Rejeite carimbos de data e hora com mais de alguns minutos.
Conferir a assinatura em um shell:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Resumo do painel
GET /dashboard retorna as contagens por trás dos blocos da visão geral: monitores por status (servidores contam com suas unidades do plano), servidores por status e o número de incidentes abertos. Qualquer um dos scopes monitors:read, servers:read ou incidents:read dá acesso.
curl https://app.centoculus.com/api/v1/dashboard \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": {
"monitors": {"pending": 0, "up": 46, "degraded": 1, "down": 1, "paused": 2},
"monitors_total": 50,
"servers": {"pending": 0, "up": 3, "degraded": 0, "down": 0, "paused": 0},
"open_incidents": 2
}
}
Perguntas frequentes
Qual plano inclui a API?
Os tokens de API estão disponíveis a partir do plano Business. Nos planos menores, você vê a seção em Minha conta desativada, com um link de upgrade. Todo o resto do Centoculus funciona sem a API.
Um token pode fazer tudo o que a minha conta faz?
Não. Um token só alcança as áreas para as quais você deu scopes a ele, e nunca cobrança, membros da equipe, outros tokens, segurança da conta ou reparos. Isso fica no aplicativo.
Existe um sandbox?
Para explorar, use um token só com scopes de leitura e crie monitores de teste no plano gratuito de uma segunda conta. Os monitores que você cria contam para o seu plano como os criados no aplicativo.
Como levo os alertas para o meu próprio sistema?
Crie um canal de webhook e verifique a assinatura de cada entrega. Toda queda, recuperação e pausa chega à sua URL em segundos, com o monitor, a causa e os locais afetados em JSON.
A API muda?
A versão está no endereço (/api/v1). Novos campos podem ser adicionados às respostas a qualquer momento; dentro de uma versão, campos não são removidos nem renomeados. Leia o que precisar e ignore o resto.
Pronto para automatizar o seu monitoramento?
Os tokens de API estão incluídos a partir do plano Business. Compare os planos, ou comece grátis e faça upgrade quando os seus scripts estiverem prontos.