1. O que é a autenticação OAuth2 e quando ela é necessária;
2. Quais são os pré-requisitos para autenticar na API;
3. Como realizar a autenticação e obter o token de acesso.

A API da Mainô utiliza o protocolo OAuth2 para garantir que apenas sistemas autorizados consigam acessar e manipular dados. Esse processo de autenticação é obrigatório para qualquer integração via API — seja para emitir notas fiscais, movimentar estoque, registrar vendas ou qualquer outra operação. Antes de começar, você vai precisar de um Application UID, que é fornecido pelo time da Mainô, e de credenciais de usuário válidas no sistema. Caso ainda não tenha essas informações, entre em contato com o suporte antes de prosseguir.

OAuth2 é o protocolo padrão de autorização utilizado pela API da Mainô. Ele funciona da seguinte forma: ao enviar suas credenciais para o endpoint de autenticação, o sistema retorna um token de acesso temporário. Esse token deve ser incluído no cabeçalho de todas as requisições subsequentes. Sem ele, as chamadas à API serão rejeitadas.

Para realizar a autenticação, você vai precisar dos seguintes itens:
• Application UID: identificador único da sua aplicação, fornecido pelo time da Mainô;
• Credenciais de usuário: login e senha de um usuário válido cadastrado no sistema.

Caso não tenha o Application UID ou as credenciais de acesso, entre em contato com o suporte pelo WhatsApp (21) 2224-5777 antes de prosseguir.

A autenticação é feita por meio de uma requisição ao endpoint de Authentication da API. A documentação completa com os parâmetros, formato da requisição e exemplos de resposta está disponível no link abaixo:

Documentação da API — Autenticação

Após enviar a requisição com as credenciais corretas, o sistema retorna um token de acesso. Esse token deve ser incluído no cabeçalho Authorization de todas as chamadas seguintes à API, no formato Bearer [token].

Se tiver dúvidas, fale com a Mai pelo chat no sistema ou pelo número de WhatsApp (21) 2224-5777.