Maestron Developers
Documentação
da API Maestron.
Integre o Maestron à sua stack. Base https://api.maestron.com.br/v1, autenticação por Bearer token e respostas JSON com envelope previsível.
Conceitos da API
Tudo o que se aplica a qualquer requisição: como autenticar, o que você recebe de volta e como tratar erros e limites.
Faça POST /auth/login e envie o token no header Authorization. Há refresh token e login social.
A empresa é resolvida automaticamente a partir do Bearer token. Nenhum header extra é necessário.
Receba eventos por HTTP assinados com HMAC-SHA256. Valide a assinatura; há reenvio automático em falhas.
Status HTTP padrão. O corpo traz sempre message e, em validações, errors por campo.
Acompanhe X-RateLimit-Remaining e respeite Retry-After ao receber 429.
A versão fica na URL (/v1/). Mudanças que quebram só entram em uma nova versão; depreciações usam o header Sunset.
Módulos da API
Mesma base e autenticação para todos. Cada módulo adiciona seus próprios endpoints sob um prefixo.
/v1/crm/v1/inventory/v1/helpdesk/v1/marketing