Pular para o conteúdo
Academy

Configuração

Este artigo mostra-lhe como configurar rapidamente como programador 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 agente de viagens ou uma conta de afiliado.
  3. Crie uma Aplicação onde a associe à conta que criou no Passo 2.
  4. Depois de criar a sua Application, guarde o client-id e o client secret num local seguro.

CDN

Seção intitulada “CDN”

Na Wink, usamos o 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 que 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 nos três pontos horizontais ao lado do nome da coleção e clique em Edit.
  5. No separador 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 de que o separador de autenticação diz Inherit auth from parent para incluir o seu token em cada chamada.