Referência da API

API pública v1 (publicada). Use o host HTTPS do seu tenant. Somente Authorization: Bearer autentica as requisições; cookies do navegador são ignorados. As credenciais são opacas, não são JWTs. Expiração, revogação, permissões de ação independentes e acesso atual aos recursos são verificados na persistência a cada requisição. Grupos selecionados autorizam seus membros atuais, em união com os dispositivos selecionados individualmente. Nenhuma permissão de ação implica outra. Recursos fora do tenant ou do escopo do token retornam 404. Todas as chamadas processadas em um tenant identificado são auditadas antes da liberação de dados ou mutações; falhas de persistência bloqueiam a operação com 503. Credenciais, comandos e URLs de armazenamento não são expostos. Limites compartilhados padrão por janela fixa de um minuto: 30 tentativas por origem/tenant antes da autenticação (incluindo requisições válidas), 120 requisições por token e 600 por tenant. A configuração do backend pode alterar esses limites. 429 inclui Retry-After em segundos. A revogação bloqueia novas chamadas; trabalhos aceitos continuam. A rotação invalida imediatamente as credenciais anteriores. Restrições do ciclo de vida do tenant, cobrança e confiança SSH continuam prevalecendo. Mudanças aditivas são permitidas na v1; mudanças incompatíveis exigem depreciação documentada e uma nova versão da API. A versão do OpenAPI não altera /api/v1.