Características do token de API

O acesso por usuário e senha é exclusivo do frontend nativo do Fácil123. Qualquer outro aplicativo deve interagir com a API por meio de um token de API. Para criar e usar um token, veja Gerando e usando seu token de API.

O token de API é uma herança de um usuário comum, mas a autenticação é feita por uma key, não por login e senha.
O token não cria sessão: a key deve ser enviada em toda comunicação.
Não é possível alterar o licenciado ao qual o token está conectado. Para múltiplos licenciados da mesma organização, cadastre tokens diferentes — um por licenciado.
Tokens são monolicenciado.
Apesar de serem usuários, os tokens não são contabilizados no plano da licença.
O controle de permissões e telas de auditoria funcionam para tokens da mesma forma que para usuários regulares. Quando o token não tem acesso a uma operação, a API responde com o erro FORBIDDEN, informando qual permissão falta ou qual app precisa ser instalado. Veja Entendendo os erros da API.

Comportamento dos headers em requests não autenticados

Ao chamar um endpoint sem token de autorização, a resposta varia conforme o header Accept:

Sem Accept definido: status 302 Permanent redirect com location apontando para a rota de login do Fácil123.
Com Accept: application/json: status 401 Unauthorized.