Pular para o conteúdo
Wink

Configuração

Este artigo mostra-lhe como configurar rapidamente como desenvolvedor e começar a testar as nossas APIs na Wink.

Siga estes passos:

  1. Registe-se com a sua conta de utilizador na Wink.
  2. Crie uma conta de afiliado. Vai precisar disto para associar à sua Aplicação. Veja o que é o Studio para mais contexto.
  3. Crie uma Aplicação e associe-a à conta de afiliado que criou no Passo 2. Para integrações API servidor-a-servidor, escolha MACHINE_2_MACHINE como tipo de cliente.
  4. Depois de criar a sua Application, copie e guarde imediatamente o client-id e a chave secreta — a chave secreta é mostrada apenas uma vez e não pode ser recuperada novamente.

CDN

Seção intitulada “CDN”

Na Wink, usamos Cloudinary para todos os nossos ativos de imagem e vídeo. Quando aceder ao nosso inventário de viagens, terá acesso total a todas as funcionalidades avançadas do Cloudinary.

O nosso cloud_name é traveliko.

Cloudinary

Seção intitulada “Cloudinary”

Exemplo

Seção intitulada “Exemplo”

Para cada tipo de inventário de viagens 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. É tudo o que precisa para obter a imagem em qualquer formato, qualidade e tamanho que desejar.

Testes

Seção intitulada “Testes”

Dirija-se à nossa secção de APIs e escolha a API com a qual quer trabalhar.

Documentação da API

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

O nosso site de documentação está configurado de forma a que possa executar comandos API diretamente no site.

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

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

Postman

Seção intitulada “Postman”

Pode fazer o mesmo com o Postman.

  1. Descarregue o Postman.
  2. Clique em Download OpenAPI spec no topo da página da Lookup API.
  3. Importe-o para o Postman.
  4. Se o importou como uma nova coleção chamada Wink API, clique no elipses 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 seu token guardado 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 que a sua app ajudou a gerar.
  12. Defina o campo Client Secret para o Client Secret que a sua app ajudou a gerar.
  13. Defina o campo Scope para inventory.read inventory.write inventory.remove. Estes são todos os scopes que vai precisar para a Wink.
  14. Defina o campo Client Authentication para Send as Basic Auth header.
  15. Clique no botão Get New Access Token para obter o seu token e guardá-lo.
  16. Para todas as chamadas API na coleção Wink API, certifique-se que a aba de autenticação diz Inherit auth from parent para incluir o seu token em cada chamada.