Autenticação (v2)

API v2 — deprecated (desligamento 31/12/2026)

Prefira a v3 para novas integrações.

A API v2 usa autenticação por Token único por empresa, enviado no header Authorization. O Token é a chave de integração da empresa, gerada no Painel FazNota.

Header

Authorization: Token SEU_TOKEN_AQUI

Envie esse header em todas as requisições, exceto nos endpoints de health (/health, /health/deep, /health/pool), que são públicos.

Bearer também é aceito (mas prefira Token)

A v2 também aceita Authorization: Bearer SEU_TOKEN. Para consistência, use Token como forma canônica — é o esquema padrão em ambas as versões.

Exemplo

curl https://api.mysebr.com.br/nfemyse/rest/produtos \
  -H "Authorization: Token SEU_TOKEN_AQUI"

Respostas de autenticação

Diferente dos endpoints de negócio (que retornam sempre HTTP 200), os erros de autenticação retornam status HTTP real, com o corpo no formato {"error": {...}}:

HTTP	Situação	Corpo
401	Token ausente ou inválido	{ "error": { "status": 401, "message": "Token não autorizado." } }
403	Contrato da empresa inapto/pendente	{ "error": { "status": 403, "message": "..." } }
429	Limite de consumo da API atingido	{ "error": { "status": 429, "message": "..." } }

Dica

Guarde o Token com segurança e nunca o exponha em frontend/browser. Faça as chamadas a partir do seu backend. Se o Token for rotacionado no painel, o anterior é revogado.