Pular para o conteúdo
Academy

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 agente de viagens ou uma conta de afiliado.
  3. Crie uma Aplicação associando-a à conta criada no Passo 2.
  4. Depois de criar sua Application, guarde o client-id e o client secret em um local seguro.

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": "Foto do 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”

Acesse 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 da API Search Lookups (OAuth2).

  1. Use a Lookup API para recuperar destinos ou hotéis.
  2. Na barra lateral esquerda, 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, você verá que sua chave de API foi aplicada.
  5. Agora você pode testar o endpoint de lookup.
Endpoint da API Lookup
Exemplo de Search Lookups (OAuth2)

Postman

Seção intitulada “Postman”

Você pode fazer o mesmo usando 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 você 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 desejar para seu 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 inventory.read inventory.write inventory.remove. Esses são todos os escopos que você precisará para o Wink.
  14. Defina o campo Client Authentication para Send as Basic Auth header.
  15. Clique no botão Get New Access Token para recuperar seu token e salvá-lo.
  16. Para todas as chamadas de API na coleção Wink API, certifique-se de que a aba de autenticação esteja com Inherit auth from parent para incluir seu token em todas as chamadas.