Autenticação Oauth

Requisitos para integração

Para realizar a integração de um sistema externo, o administrador da organização deve concluir as seguintes atividades:

Criar uma "Aplicação conectada" para o sistema externo que pretende enviar indicações.
Criar um usuário para autenticar o sistema externo.

Token de acesso

Antes de enviar uma requisição de cadastro para uma nova indicação, o sistema externo deve solicitar um token de acesso.

Para mais informações, consulte o link abaixo:

https://developer.salesforce.com/docs/atlas.en-us.218.0.api_rest.meta/api_rest/intro_understanding_username_password_oauth_flow.htm

Requisição

Para enviar uma indicação, o sistema externo deve receber um token de segurança que é utilizado para autenticar as requisições para a API do SnapProperty.

Parâmetro	Tipo	Descrição
Endpoint	String	Endereço para enviar uma requisição para token de acesso. Utilizar sempre https://login.salesforce.com/services/oauth2/token/
Verbo	String	Utilizar sempre POST
grant_type	String	Identifica o tipo de requisição. Deve utilizar sempre "password".
client_id	String	Código para identificação da aplicação no Salesforce, informado pelo administrador da organização.
client_secret	String	Chave secreta da aplicação, informado pelo administrador da organização.
username	String	Nome do usuário para autenticação, cadastrado pelo administradora da organização.
password	String	Senha utilizada pelo usuário para autenticação concatenada com a chave de segurança enviada por email pelo Salesforce.

Retorno de uma requisição bem sucedida

Parâmetro	Tipo	Descrição
access_token	String	Chave de acesso para as demais requisições para a API.
instance_url	String	Este valor será utilizado nas demais requisições para a API.
id	String
token_type	String
issued_at	String
signature	String

Exemplo de requisição com suceso

	Exemplo
Requisição	https://login.salesforce.com/services/oauth2/token ?grand_type=password &client_id=3MVG9QDx8IX8nP5SIyDa4YCKZ5fWQe4zJBToiPFMmU94sSExkYBBr3gNZnzXXUS316 &client_secret=065345560BF35CD3F101EAB2B9F1838B402D4903 &username=sistema@dominio.com.br &password=senha23409284203942
Retorno	{ "access_token": "00DU0000000KkSx!ARQAQCV4Ss4lCPejtaWcCz3W.26oOVeAbvxaAU4BndfDvDk5CoRKSWUubdF7XjNulocbDRlPU81DjNT0.kiFhIr.Kbz", "instance_url": "https://snap-broker-dev-ed.my.salesforce.com", "id": "https://login.salesforce.com/id/00DU0000000KkSxMAK/005U0000000NVceIAG", "token_type": "Bearer", "issued_at": "1556731033567", "signature": "15dl4dW8LSkp+r1FHbj/Y/3mD/AiRrKB0HNee4IGa+A=" }