Aplicação e credenciais

Toda chamada à API é feita em nome de uma aplicação da empresa, criada pelo administrador na interface.

O administrador cria a aplicação na interface e entrega as credenciais ao time que integra.

Criar a aplicação

Entre no Notifica com um usuário administrador, na conta da empresa.
Abra Aplicações e crie uma nova aplicação com um nome que identifique o sistema que vai usá-la (ex.: "ERP Cobrança").
Copie o client_id e o client_secret, ou baixe o arquivo JSON com os dois.

🚧
O client_secret aparece uma única vez
Se perder, gere uma nova chave e atualize o sistema integrado.

Regras da aplicação

A aplicação pertence à empresa. Tudo o que ela faz acontece na empresa e é cobrado dela, independentemente de quem criou a chave ou da conta que essa pessoa está usando na tela.
Não existe aplicação pessoal. Em conta de pessoa física a criação é recusada, e um token de pessoa é recusado pela API (NTF-AUTH-147).

Boas práticas

Uma aplicação por sistema integrado. Assim você revoga um sem derrubar os outros.
Guarde o client_secret num cofre de segredos ou variável de ambiente do servidor. Nunca em frontend, app móvel ou repositório.
Ao suspeitar de vazamento, revogue a chave na interface e gere outra.