Histórico da Página
Índice
Índice | ||||||||
---|---|---|---|---|---|---|---|---|
|
Plataforma
Produto: fluig Identity
Ocorrência
Como utilizar as APIs do fluig Identity?
Solução
Para utilizar a API do Identity, você pode seguir como referência o Swagger.
101. Acesse: Acessar https://<SEU_CONTEXTO>[contexto].fluigidentity.com/rest/swagger-ui/index.html
202. Obtenha Obter o Client Assertion (resultado no Response Body) passando o clientId de sua empresa:
...
Informações |
---|
Para obter o clientId, acesse como administrador o menu Configuração → aba Segurança → REST API v2 → ID do Cliente |
303. Depois, é preciso obter o token passando como parâmetro o Client Assertion:
Bloco de código |
---|
oauth2 > POST /rest/v2/oauth2/auth |
404. Após obter o token em Response Body > "access_token", copie o código e cole no campo superior da página "api_key" e pressione "Explore". Desta forma você poderá utilizar todos os endpoints da API do Identity.
Exemplo de código:
Bloco de código | ||||
---|---|---|---|---|
| ||||
// Exemplo de código para obter as informações de uma empresa por ajax. var clientId = '<CLIENT_ID>'; // Substituir '<CLIENT_ID>' pelo clientId da empresa var companyId ='<COMPANY_ID>'; // Substituir '<COMPANY_ID>' pelo companyId da empresa var domainUrl = 'https://<CONTEXT>.fluigidentity.com/'; //Substituir '<CONTEXT>' pelo contexto da empresa var apiUrl = domainUrl + 'rest/v2/'; // Get client assertion function getClientAssertion(clientId) { $.ajax({ url:apiUrl + 'oauth2/clients/' + clientId + '/assertion', crossDomain:true // se necessário cross domain }) .done(function(data){ getAccessToken(data); }) .fail(function(error){ console.log(error); }); } // Grant a new refresh token function getAccessToken(assertion) { var data = { 'grant_type':'urn:ietf:params:oauth:grant-type:jwt-bearer', 'assertion':assertion }; $.ajax({ url:apiUrl + 'oauth2/auth', crossDomain:true, // se necessário cross domain data:data, type:'POST' }) .done(function(data){ getCompany(data.access_token,companyId) }) .fail(function(error){ console.log(error); }); } // Get a company function getCompany(authorization, companyId) { $.ajax({ url:apiUrl + 'companies/' + companyId, crossDomain:true, // se necessário cross domain headers:{ 'Authorization':authorization } }) .done(function(data){ console.log(data); }) .fail(function(error){ console.log(error); }); } getClientAssertion(clientId); |
Observações
Para utilizar os endpoints com AJAX, é necessário realizar as 3 primeiras etapas acima e enviar o "access_token" no header de todas as requisições.
Dica | ||
---|---|---|
| ||
Consulte a documentação Introdução à API REST. |
...