API de gestão

Duas chaves diferentes

O Nextfy Monitor usa duas credenciais com finalidades distintas. Trocar uma pela outra devolve 401 nas duas direções — se um 401 aparecer com a chave “certa”, confira primeiro se ela é do tipo certo para aquela rota.

Nenhuma das duas pode ser lida depois de criada: o banco guarda apenas o hash. Perdeu, rotaciona.

Conectar um site em um comando

O comando abaixo cria projeto, monitor e chave de ingestão, e grava as variáveis no .env do site. Conectar o próximo produto é a mesma linha trocando o domínio.

npx nextfy-monitor connect \
  --url https://seusite.com \
  --env-file /apps/seusite/.env.local

Defina NEXTFY_API_URL e NEXTFY_API_TOKEN no ambiente. Passar a chave por argumento a deixa no histórico do shell e na lista de processos.

POST /provision

O mesmo que o comando faz, por HTTP. Idempotente pelo slug do domínio: repetir não duplica projeto nem monitor.

curl -X POST https://nextfymonitor.nextfy.pro/api/v1/provision \
  -H "Authorization: Bearer nf_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seusite.com" }'

{
  "data": {
    "project":  { "id": "...", "name": "seusite.com", "slug": "seusite-com" },
    "monitor":  { "id": "...", "url": "https://seusite.com" },
    "ingest_key": { "id": "...", "key": "pk_nextfy_...", "created": true },
    "snippet":  "<script defer src=\"https://nextfymonitor.nextfy.pro/sdk/v1.js\" data-key=\"pk_nextfy_...\" data-endpoint=\"https://nextfymonitor.nextfy.pro/api/v1/analytics\"></script>",
    "env":      "NEXTFY_INGEST_KEY=pk_nextfy_...\nNEXTFY_INGEST_URL=https://nextfymonitor.nextfy.pro/api/v1/analytics",
    "idempotent": { "project_created": true, "monitor_created": true, "key_created": true }
  }
}

Numa repetição, ingest_key.key volta null — o valor não é recuperável. Envie "rotate_key": true para gerar outro. Exige os escopos projects:write, monitors:write e analytics:write.

Recursos

Criar um monitor

Só project_id, name e url são obrigatórios. O tipo do monitor é derivado do esquema da URL — não envie type.

curl -X POST https://nextfymonitor.nextfy.pro/api/v1/monitors \
  -H "Authorization: Bearer nf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "00000000-0000-0000-0000-000000000000",
    "name": "Uptime",
    "url": "https://seusite.com"
  }'

Opcionais e seus limites: method (GET ou HEAD), interval_seconds (30 a 86400), timeout_ms (1000 a 30000), expected_status_min e expected_status_max (100 a 599), expected_content (só com method GET), failure_threshold e recovery_threshold (1 a 10).

Erros

Toda recusa de escrita diz qual campo está errado e por quê, em vez de uma mensagem genérica.

{
  "error": {
    "code": "invalid_field",
    "message": "O campo \"interval_seconds\" precisa ficar entre 30 e 86400."
  }
}

Limites

• Listagens devolvem no máximo 100 registros, do mais recente para o mais antigo.
• Uma chave de ingestão aceita até 20 origens.
• A ingestão aceita 60 requisições por minuto e 20 eventos por requisição.
• O contrato em /api/v1/openapi acompanha estas rotas.

Continue por aqui