Pular para o conteúdo
Wink

Configuração

Este artigo mostra como configurar rapidamente como desenvolvedor e começar a testar nossas APIs no Wink.

Siga estes passos:

  1. Registre-se com sua conta de usuário no Wink.
  2. Crie uma conta de afiliado. Você precisará dela para vincular sua Aplicação. Veja o que é o Studio para mais contexto.
  3. Crie uma Aplicação e associe-a à conta de afiliado criada no Passo 2. Para integrações API servidor a servidor, escolha MACHINE_2_MACHINE como tipo de cliente.
  4. Depois de criar sua Application, copie e salve imediatamente o client-id e a chave secreta — a chave secreta é mostrada apenas uma vez e não pode ser recuperada depois.

CDN

Seção intitulada “CDN”

No Wink, usamos Cloudinary para todos os nossos ativos de imagem e vídeo. Ao acessar nosso inventário de viagens, você terá acesso completo a todos os recursos avançados do Cloudinary.

Nosso cloud_name é traveliko.

Cloudinary

Seção intitulada “Cloudinary”

Exemplo

Seção intitulada “Exemplo”

Para cada tipo de inventário de viagem que suportamos, haverá um array JSON aninhado chamado multimedias. O JSON para uma entrada multimídia é assim:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

A linha destacada acima mostra o ID único do Cloudinary partners/radisson_blu_logo. Isso é tudo que você precisa para recuperar a imagem em qualquer formato, qualidade e tamanho que desejar.

Testes

Seção intitulada “Testes”

Vá para nossa seção de APIs e escolha a API com a qual deseja trabalhar.

Documentação da API

Seção intitulada “Documentação da API”

Nosso site de documentação está configurado para que você possa executar comandos da API diretamente no site.

Neste exemplo, você quer usar a chamada de API Search Lookups (OAuth2).

  1. Use a Lookup API para recuperar destinos ou hotéis.
  2. No menu lateral esquerdo, clique em Authentication.
  3. Insira seu client-id e client secret e clique no botão Get TOKEN.
  4. Se suas credenciais forem válidas, verá que sua chave de API foi aplicada.
  5. Agora você pode testar o endpoint de lookup.
Endpoint da Lookup API
Exemplo de Search Lookups (OAuth2)

Postman

Seção intitulada “Postman”

Você pode fazer o mesmo com o Postman.

  1. Baixe o Postman.
  2. Clique em Download OpenAPI spec no topo da página da Lookup API.
  3. Importe para o Postman.
  4. Se importou como uma nova coleção chamada Wink API, clique no elipse horizontal (3 pontos) ao lado do nome da coleção e clique em Edit.
  5. Na aba Authorization, defina o Auth type para OAuth2.
  6. Defina o campo Add auth data to para Request headers.
  7. Defina o campo Header prefix para Bearer.
  8. Defina o campo Token Name para o nome que quiser dar ao token salvo no Postman. Exemplo: Wink Staging.
  9. Defina o campo Grant type para Client Credentials.
  10. Defina o campo Access token URL para https://staging-iam.wink.travel/oauth2/token.
  11. Defina o campo Client ID para o Client ID gerado pela sua aplicação.
  12. Defina o campo Client Secret para o Client Secret gerado pela sua aplicação.
  13. Defina o campo Scope para os escopos delimitados por espaço que sua integração precisa (ex: inventory.read inventory.write inventory.remove). Veja a referência de escopos para a lista completa.
  14. Defina o campo Client Authentication para Send as Basic Auth header.
  15. Clique no botão Get New Access Token para obter seu token e salvá-lo.
  16. Para todas as chamadas de API na coleção Wink API, certifique-se que a aba de autenticação esteja como Inherit auth from parent para incluir seu token em todas as chamadas.