API pública

A API pública é uma superfície externa separada das rotas internas do painel. Use uma chave criada pelo administrador, aplique o menor escopo necessário e trate respostas de erro e limites de requisição.

Princípios

• envie a chave somente por HTTPS e nunca a coloque no frontend;
• trate 401/403 como falha de autenticação/autorização, não como ausência de dados;
• implemente retry com backoff somente para erros transitórios;
• armazene o identificador retornado para evitar operações duplicadas;
• valide webhooks recebidos antes de processar o conteúdo.

Os caminhos, campos e exemplos exatos devem ser conferidos na versão da instalação. O administrador deve revogar chaves antigas e limitar o acesso por integração.