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 afiliada. Você precisará dela para vincular sua Aplicação. Veja o que é Studio para mais contexto.
  3. Crie uma Aplicação e associe-a à conta afiliada que você criou no Passo 2. Para integrações API servidor a servidor, escolha MACHINE_2_MACHINE como tipo de cliente.
  4. Depois de criar sua Aplicação, copie e salve 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”

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”

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 de forma que você pode 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. 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 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 você 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 salvo no Postman. Ex: 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 sua aplicação ajudou a gerar.
  12. Defina o campo Client Secret para o Client Secret que sua aplicação ajudou a gerar.
  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 diga Inherit auth from parent para incluir seu token em todas as chamadas.