Logística - TOTVS Checklist - Checklist - Autenticação de APIs públicas da Suite Logística via Postman

Tempo aproximado para leitura: 00:02:00 min

Dúvida
Como realizar a autenticação nas APIs públicas da Suite Logística TOTVS via Postman? 

Ambiente
TOTVS Logística - TOTVS Checklist - Checklist - Todas as versões

Solução
Os produtos SaaS da TOTVS disponibilizam APIs para que seja possível desenvolver integrações de ferramentas e produtos terceiros com os produtos da TOTVS.

Nossas API são protegidas por autenticação e autorização, utilizando o padrão de mercado OAUTH2.

O Meu Checklist, assim como outros produtos como YMS e Agendamentos, da Suíte Logística TOTVS possuem APIs públicas protegidas por autenticação e autorização baseadas no padrão de mercado OAuth2.

Para obter um token de acesso e realizar integrações, siga os passos abaixo:

1. No aplicativo Postman, acesse as configurações e desabilite a opção SSL certificate verification;
2. Clique em New e selecione a opção Collection para criar uma nova requisição.
3. Nomeie a coleção e salve. Exemplo: Autenticação.
4. Na aba Authorization, altere o Auth Type para OAuth 2.0 e defina o campo Add authorization data to como Request Headers;
5. Na seção Configure New Token, preencha os parâmetros da seguinte forma:
   • Token name: Defina um nome de sua escolha.
   • Grant type: Selecione Client Credentials.
   • Access Token URL: Preencha com https://[tenant].rac.totvs.app/totvs.rac/connect/token, e substitua [tenant] pelo nome do seu ambiente.
   • Client ID e Client Secret: Insira suas credenciais M2M geradas no ambiente.
   • Scope: Preencha com authorization_api.
   • Client Authentication: Selecione Send as Basic Auth header.

6. Clique no botão Get New Access Token.

7. Se os dados estiverem corretos, o token será gerado com sucesso. A partir disso, você poderá realizar requisições para o portal conforme a documentação específica de cada produto.

Importante
A utilização de API com credenciais M2M se aplicam exclusivamente a APIs públicas, as quais contém /public/ em sua estrutura. Caso identifiquem a necessidade de utilizar outra API que não está pública, é necessário solicitar uma melhoria de produto Central Colaborativa TOTVS, localizada em nosso Portal do Cliente.

Saiba mais
APIs do TOTVS Logística Checklist: Logística - TOTVS Checklist - Checklist - API REST 
APIs do TOTVS Logística Agendamentos: Logística - TOTVS Agendamentos - Agendamentos - API REST 
APIs do TOTVS Logística YMS: Logística - TOTVS YMS - YMS - API REST 

Glossário
API: Application Programming Interface (Interface de Programação de Aplicação).
M2M: Machine-to-Machine (Integração Máquina para Máquina).
OAuth2: Protocolo de autorização padrão de mercado.