Setup

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

Os testes devem sempre ocorrer em nossoambiente de preparação. Há muito menos dados lá, mas você está livre para testar o quanto quiser sem interferir no ambiente de produção.

Assim que estiver pronto para entrar no ar, certificaremos sua conta e seu aplicativo, e você poderá iniciar em nosso ambiente de produção.

Siga estes passos:

1. Registrar sua conta de usuário no Wink
2. Criar um conta de agente de viagens ou um conta de afiliado.
3. Criar um aplicativo onde você o associa à conta criada na Etapa 2.
4. Depois de criar seu Application, salve o ID do cliente e o segredo do cliente em um local seguro.

CDN

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

Nosso cloud_name é traveliko.

Cloudinary

• Começando
• SDKs
• Cloudinary no GitHub
• Tutoriais em vídeo

Exemplo

Para cada tipo de inventário de viagens que oferecemos suporte, haverá uma matriz JSON aninhada chamadamultimedias. O JSON para uma entrada multimídia se parece com isto:

{
  "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 exclusivo do Cloudinarypartners/radisson_blu_logo. Isso é tudo o que você precisa para recuperar a imagem em qualquer formato, qualidade e tamanho que desejar.

Teste

Vá até o nossoAPIsseção e escolha a API com a qual deseja trabalhar.

Documentação da API

Nosso site de documentação é configurado de forma que você possa executar comandos de API de dentro do site.

Neste exemplo, você deseja usar oSearch Lookups (OAuth2)Chamada de API.

:::dica[Dica Profissional] Para facilitar o uso, recomendamos que os integradores utilizem os endpoints que designamos comoOAuth2. Esses endpoints sabem esperar chamadores de API e já sabem em qual conta você está, então você não precisa especificarcompanyIdentifierem seus URLs. :::

1. Use o API de pesquisa para recuperar destinos ou hotéis.
2. Na barra de navegação à esquerda, clique em Authentication.
3. Digite seu ID do cliente e segredo do cliente e clique em Get TOKEN botão.
4. Se suas credenciais forem válidas, você verá que sua chave de API foi aplicada.
5. Agora você pode testar o ponto de extremidade de pesquisa.

Exemplos de pesquisas (OAuth2)

Carteiro

Você pode fazer a mesma coisa com o Postman.

1. Download Carteiro.
2. Clique em Download OpenAPI spec do topo do API de pesquisa página.
3. Importe-o para o Postman.
4. Se você importou como uma nova coleção chamada Wink API, clique na elipse horizontal (3 pontos) ao lado do nome da coleção e clique Edit.
5. No Authorization tab, 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 qualquer nome que você queira dar ao seu token salvo no Postman. Por 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 ID do cliente que seu aplicativo ajudou a gerar.
12. Defina o campo Client Secret para o segredo do cliente que seu aplicativo ajudou a gerar.
13. Defina o campo Scope para inventory.read inventory.write inventory.remove. Esses são todos os escopos que você precisa para o Wink.
14. Defina o campo Client Authentication para Send as Basic Auth header.
15. Clique no Get New Access Token botão para recuperar seu token e salvá-lo.
16. Para todas as chamadas de API na coleção Wink API, certifique-se de que a guia de autenticação diga Inherit auth from parent então ele inclui seu token em cada chamada.

:::dica[Dica Profissional] Recomenda-se transformar o domínio do servidor, o ID do cliente e o segredo do cliente em variáveis de ambiente. Dessa forma, você pode alternar facilmente entre os ambientes de preparação e produção e reutilizar todas as operações que criou. :::