Fluxo do token de atualização OAuth 2.0 para sessões renovadas

Solicite uma chave de acesso atualizado

Um aplicativo conectado pode usar o token de atualização para obter um novo token de acesso enviando uma destas solicitações POST do token de atualização ao ponto de extremidade do token do Salesforce.

POST /services/oauth2/token HTTP/1.1
Host: login.salesforce.com/ 
grant_type=refresh_token&
client_id=3MVG9lKcPoNINVBIPJjdw1J9LLM82HnFVVX19KY1uA5mu0QqEWhqKpoW3svG3XHrXDiCQjK1mdgAvhCscA9GE&client_secret=1955279925675241571&
refresh_token=your token here 

Em vez de enviar credenciais de cliente como parâmetros no corpo da solicitação de POST do token de atualização, você pode usar o esquema de autenticação básico HTTP. O formato deste esquema exige client_id e client_secret no cabeçalho de autorização da publicação da seguinte maneira:

Authorization: Basic64Encode(client_id:secret)

O client_id e o client_secret são separados por dois-pontos (:). Para obter mais informações, consulte a Estrutura de autorização do OAuth 2.0.

POST /services/oauth2/token HTTP/1.1
Host: login.salesforce.com
Authorization:  Basic 
client_id=3MVG9lKcPoNINVBIPJjdw1J9LLM82HnFVVX19KY1uA5mu0QqEWhqKpoW3svG3XHrXDiCQjK1mdgAvhCscA9GE&
client_secret=1955279925675241571
grant_type=refresh_token&
refresh_token=your token here 

Nota Se client_id e client_secret forem enviados no corpo POST, o cabeçalho de autorização será ignorado.

Evite enviar solicitações simultâneas que contenham o mesmo token de atualização. Se o cliente enviar solicitações idênticas ao mesmo tempo, algumas das solicitações falharão de modo intermitente e a coluna Status no Histórico de logins exibirá Falha: A solicitação de token já está sendo processada. Em vez de enviar continuamente solicitações para novos tokens de acesso, armazene em cache e reutilize tokens. Se você enviar solicitações simultâneas com o mesmo token de atualização, o que não é recomendado, desenvolva uma maneira de tentar novamente as solicitações quando esse erro ocorrer.

Com o formato de solicitação de POST do token de atualização, inclua os seguintes parâmetros.

Importante Ao desenvolver integrações do OAuth, sempre passe informações confidenciais no corpo de uma solicitação POST ou em um cabeçalho da solicitação. Não use parâmetros GET na string de consulta de URL para passar informações confidenciais. As informações confidenciais incluem, entre outros, nomes de usuário, senhas, tokens OAuth, segredos do cliente e quaisquer informações de identificação pessoal. Para obter mais informações sobre as melhores práticas de segurança, consulte Armazenamento de dados confidenciais no Guia de codificação segura.

O Salesforce concede um novo token de acesso

Depois de verificar a solicitação, o Salesforce envia uma resposta com um novo token de acesso ao aplicativo conectado.

{ 
"id":"https://login.salesforce.com/id/00Dx0000000BV7z/005x00000012Q9P",
"issued_at":"1278448384422",
"instance_url":"https://yourInstance.salesforce.com/",
"signature":"SSSbLO/gBhmmyNUvN18ODBDFYHzakxOMgqYtu+hDPsc=",
"access_token":"00Dx0000000BV7z!AR8AQP0jITN80ESEsj5EbaZTFG0RNBaT1cyWk7TrqoDjoNIWQ2ME_sTZzBjfmOE6zMHq6y8PIW4eWze9JksNEkWUl.Cju7m4",
"token_type":"Bearer",
"scope":"id api refresh_token"
}

<Oauth>
   <access_token>00Dx0000000BV7z!AR8AQP0jITN80ESEsj5EbaZTFG0RNB
       aT1cyWk7TrqoDjoNIWQ2ME_sTZzBjfmOE6zMHq6y8PIW4eWze9JksNEkWUl.Cju7m4 
   </access_token>
   <token_type>Bearer
   </token_type>
   <scope>id api refresh_token
   </scope>
   <instance_url>https://yourInstance.salesforce.com/</instance_url>
   <id>https://login.salesforce.com/id/00Dx0000000BV7z/005x00000012Q9P</id>
   <issued_at>1278448101416</issued_at>
   <signature>CMJ4l+CCaPQiKjoOEwEig9H4wqhpuLSk4J2urAe+fVg=</signature>
</Oauth>

access_token=00Dx0000000BV7z%21AR8AQP0jITN80ESEsj5EbaZTFG0RNBaT1cyWk7TrqoDjoNIWQ2
ME_sTZzBjfmOE6zMHq6y8PIW4eWze9JksNEkWUl.Cju7m4
&token_type=Bearer&scope=id%20api%20refresh_token
&instance_url=https%3A%2F%2FyourInstance.salesforce.com
&id=https://login.salesforce.com%2Fid%2F00Dx0000000BV7z%2F005x00000012Q9P
&issued_at=1278448101416
&signature=CMJ4l%2BCCaPQiKjoOEwEig9H4wqhpuLSk4J2urAe%2BfVg%3D

Se a rotação do token de atualização estiver habilitada para o aplicativo conectado ou o aplicativo cliente externo, a resposta incluirá um novo token de atualização. Aqui está um exemplo de resposta JSON se a rotação de token de atualização estiver habilitada.

{ 
"access_token":"00Dx0000000BV7z!AR8AQP0jITN80ESEsj5EbaZTFG0RNBaT1cyWk7T...",
"refresh_token":"CjAwRHgwMDAwMDAwQlY3eiFBUjhBUVAwaklUTjgwRVNFc2o1RWJhWl...",
"signature":"SSSbLO/gBhmmyNUvN18ODBDFYHzakxOMgqYtu+hDPsc=",
"scope":"id api refresh_token",
"instance_url":"https://yourInstance.salesforce.com/",
"id":"https://login.salesforce.com/id/00Dx0000000BV7z/005x00000012Q9P"
"token_type":"Bearer",
"issued_at":"1278448384422",
}

Os seguintes parâmetros podem ser incluídos no corpo da resposta.