Planos Pro e Plus.
- Endereço:
https://painel-acs-<provedor>.nuvoon.com.br/v1/ - Documentação:
https://painel-acs-<provedor>.nuvoon.com.br/api-docs.html(lê a especificação/v1/openapi.json). - Tokens: em Configuração › API. O token aparece uma única vez; guardamos só o código de verificação dele. Até 10 tokens ativos; revogue o que não usa mais.
Autenticação
Authorization: Bearer nacs_<provedor>_…Escopos e limites
| Escopo | Permite | Limite |
|---|---|---|
| leitura | consultas | 120 requisições por minuto |
| ação | consultas + reiniciar, ler dados agora, teste de velocidade no roteador | 20 ações por minuto |
Acima do limite: resposta 429 com o tempo para tentar de novo.
Rotas principais
| Rota | O que devolve ou faz |
|---|---|
GET /v1/resumo | totais da rede |
GET /v1/equipamentos | lista de equipamentos |
GET /v1/equipamentos/{id} | detalhe de um equipamento |
GET /v1/equipamentos/{id}/eventos | linha do tempo |
GET /v1/equipamentos/por-pppoe/{login} | equipamento pelo login PPPoE |
GET /v1/alertas | alertas abertos |
GET /v1/concentradores | concentradores e sessões (com ERP) |
POST /v1/equipamentos/{id}/reiniciar | reinicia (escopo ação) |
POST /v1/equipamentos/{id}/reler | pede contato imediato (escopo ação) |
POST /v1/equipamentos/{id}/teste-velocidade | teste no roteador (escopo ação) |
O que não sai pela API
Configuração, Wi-Fi, portas, restauração de fábrica e PPPoE ficam só no painel, com o papel certo e auditoria por pessoa. Toda chamada de ação entra na Auditoria como "API: nome do token".