A autenticação da API do RD Station CRM é baseada no protocolo de segurança OAuth2. Para essa integração, optamos por definir um prazo de expiração de 2 horas (7200 segundos) para os tokens.
Nota sobre ambientes:
- Produção:
https://api.rd.services/oauth2/
Como funciona a Autenticação?
Ao criar o seu aplicativo na RD Station App Store você receberá as duas credenciais, que chamamos de client_id
e client_secret
.
Essas credenciais são utilizadas para gerar o code
, que autoriza a conexão do aplicativo à uma conta específica do RD Station CRM.
O code
será utilizado uma única vez para gerar os tokens: access_token
e o refresh_token
.
Uma vez que os tokens tenham sido gerados, o access_token
será utilizado no Header das requisições para autorizar as trocas de mensagens via API.
Para manter o access_token
válido, basta você utilizar o refresh_token
para renovar o access_token
.
Ao utilizar o refresh_token
para obter um novo access_token
, um novo refresh_token
também será retornado na resposta. É crucial que a sua aplicação armazene e utilize este novo refresh_token
para as futuras renovações, descartando o anterior.
Passo a Passo para realizar a Autenticação
Acesse as páginas abaixo para conferir o passo a passo com a explicação detalhada do processo de Autenticação:
Ao concluir o passo 3, estará autorizado para operar a API e saberá como atualizar o seu token. Com o passo 4, você saberá como renovar o access_token
.