{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"b478973c-df3b-4d91-9356-52d186d1222c","name":"Travellink API – SSO - Documentação","description":"SSO - Travellink\n\nColeções para desenvolvedores \nDúvidas e sugestões [api.travellink@wooba.com.br](null)\n\n_**O que é SSO? | Como funciona o login único**_ \nO Login Único (SSO) é uma importante tecnologia de segurança em nuvem que reduz todos os logins de aplicativos do usuário a um login para maior segurança e conveniência.\n\n_**O que é login único (SSO)?**_ \nO login único (SSO) é uma tecnologia que combina as telas de login de vários aplicativos diferentes em uma única tela. Com o SSO, um usuário só precisa digitar suas credenciais de login (nome de usuário, senha etc.) uma vez em uma única página para acessar todos os seus aplicativos SaaS.\n\n# **Configurações Iniciais**\n\n**Passo 1**\n\nO desenvolvedor precisa informar para o Contratante/Operadora qual a URL de redirecionamento.\n\n**Passo 2**\n\nO contratante/Operadora irá acessar o Portal Painel de acesso: \n[https://operadorateste.com.br/PainelDeAcessos/](null)\n\nConteúdo Travellink API > Credencial> Selecionar:\n\n**Dados Básicos:**\n\n|
Tipo de API

ID

Nome

Client ID

Client Secret

Status

URL Redirecionamento

|
Credencial Travellink_auth

ID é gerado automaticamente

Nome exemplo: Desenvolvedor Teste SSO

Informação gerada automaticamente

Informação gerada automaticamente

Manter Ativo

Informação que será informada pelo desenvolvedor.
(Obs.: Quando esse campo for preenchido o Travellink irá validar se a URL REDIRECT_URL é = valor do campo.
Se não preenchido, ele vai liberar para qualquer REDIRECT_URI

|\n| --- | --- |\n\n**Contexto :**\n\n|
Unidade

Agência

Cliente


|
Cadastrando a credencial por unidade, agência e cliente, o Travellink irá respeitar a mesma hierarquia.







|\n| --- | --- |\n\n**Passo 3**\n\nO Contratante/Operadora, deverá informar para o Desenvolvedor os dados dos campos Client ID e Client Secret.\n\n\n\n# **API Autenticação**\n\n**Autenticação**\n\n**Passo 1**\n\nO desenvolvedor deve incluir o botão na página de autenticação. \nSeguindo o modelo de exemplo:\n\n[https://wooba-sandbox.travellink.com.br/Agencias30/auth/authorize?client_id={CLIENT_ID}&response_type=code&scope=openid&redirect_uri={REDIRECT_URI](null)}\n\nEndFragment\n\n\n\n**Obs.:** As informações Cliente ID e o REDIRECT URL, são parâmetros obrigatórios que devem ser informados na URL do botão.\n\n**Passo 2**\n\nQuando o usuário autenticar no Travellink, ele será redirecionado para o endereço na REDIRECT_URL e o token de autenticação será enviado como parâmetro CODE.\n\n**Modelo de redirecionamento:**\n\n[{REDIRECT_URI](null)}? code={CODE}\n\n[https://meudominio.com.br?code={CODE](null)}\n\nApós se logar no Travellink receberá a resposta abaixo:\n\n**Passo 3** \nApós obter o valor CODE o desenvolvedor deverá fazer uma chamada Post para obter o ID_Token.\n\n**Exemplo Post:** \nPOST /Agencias30/auth/authorize/token HTTP/1.1 \nHost: wooba-sandbox.com.br \nAuthorization: Basic e0NMSUVOVF9JRH06e0NMSUVOVF9TRUNSRVR9\n\n**Content-Type: application/json:** \n{ \n\"grant_type\": \"authorization_code\", \n\"redirect_uri\": \"{{redirect_uri}}\", \n\"client_id\": \"{{client_id}}\", \n\"client_secret\": \"{{client_secret}}\", \n\"code\": \"{{code}}\" \n}\n\n\n\n**Exemplo www-form-urlencoded:** \nO formato application/x-www-form-urlencoded também é aceito:\n\nPOST /Agencias30/auth/authorize/token HTTP/1.1 \nHost: wooba-sandbox.com.br \nAuthorization: Basic e0NMSUVOVF9JRH06e0NMSUVOVF9TRUNSRVR9\n\nContent-Type: application/x-www-form-urlencoded \ncode={CODE}&client_id={CLIENT_ID}&client_secret={CLIENT_SECRET}&grant_type=authorization_code&redirect_uri={REDIRECT_URI}\n\n\n\nObs.: Authorization são {CLIENT_ID}:{CLIENT_SECRET} codificado em Base64\n\n**Modelo de resposta:** \n{ \n\"token_type\": \"Bearer\", \n\"expires_in\": 3600, \n\"id_token\": \"token_jwt\" \n}\n\n\n\n**Obtendo o id_token**\n\n\n\n**Claims do Usuário:****Dados que estão dentro do ID Token:**\n\n|
sub

email

name

role

useremails

phone_number

|
Id do usuário no Travellink

Email do usuário

Nome do usuário completo

Tipo de acesso user – Interno ou Externo

Mais de um email de usuário separados por;

Só irá ser enviado se o cadastro do usuário estiver com tel. cadastrado

|\n| --- | --- |\n| | |\n\n**Claims da Agência:**\n\n|
agencyid

agencybackofficecode

agencydocument

ragencyname

agencybusinessname

agencylogoUrl

agencyaddress1

agencyaddress2

agencyneighborhood

agencycity

agencyzipCode

agencystate

agencycountry

agencyphonegeneral

agencyphoneemergency

|
Id da Agência no Travellink

Código do Backoffice (IdERP)

Cnpj da Agência

Nome Razão Social da Agência

Nome Fantasia da Agência

Logo da Agência (imagem)

Endereço

Complemento

Bairro

Cidade

Cep

Estado

Pais

Telefone

Telefone contato emergencial.

|\n| --- | --- |\n\n**Passo 4** \nOpcional **(O desenvolvedor pode usar o site JWT.IO para validar o IDtoken).**\n\n**Validação do Id_Token:**\n\n\n\n**Código de acesso do desenvolvedor**\n\nLink da documentação do openId: [https://openid.net/specs/openid-connect-core-1_0.html#CodeFlowAuth](null)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"24548172","collectionId":"b478973c-df3b-4d91-9356-52d186d1222c","publishedId":"2s946k7rDV","public":true,"publicUrl":"https://documenter-api.postman.tech/view/24548172/2s946k7rDV","privateUrl":"https://go.postman.co/documentation/24548172-b478973c-df3b-4d91-9356-52d186d1222c","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2023-07-21T20:10:26.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s946k7rDV"}