Pular para o conteúdo

Aplicações

As aplicações dão acesso a todos os recursos do Wink como desenvolvedor. Você pode acessar todos os mesmos dados e até estender os próprios recursos do Wink. Você pode optar por usar o servidor OAuth2 do Wink para autenticar seu site de viagens da mesma forma que usaria Google ou Facebook. Dessa forma, você pode estender os recursos do Wink para seu próprio site ou aplicativo.

Aplicação de exemplo
Entrada de aplicação de exemplo
  1. Selecione a conta com a qual deseja trabalhar em Contas.
  2. Clique em Ações na parte inferior do cartão da conta e escolha Gerenciar conta.
  3. Clique na aba Aplicações na página seguinte.
  4. Esta seção listará todas as suas aplicações.
  5. Gire ou exclua uma existente, ou crie uma nova.

Como você não pode acessar a chave secreta do app que criamos para você, será necessário criar o seu próprio. Você pode criar uma aplicação aqui sem precisar configurar primeiro uma propriedade ou empresa — ela não está vinculada a nenhuma conta específica.

Ao criar uma aplicação, você escolhe um tipo de cliente que determina como o app autentica. Isso não pode ser alterado depois — se precisar de um tipo diferente, crie uma nova aplicação.

  • Aplicação web — Um app renderizado no servidor que pode manter um segredo do cliente com segurança (fluxo de código de autorização).
  • Aplicativo de página única (SPA) — Um app no navegador sem backend; usa PKCE, sem segredo do cliente.
  • App móvel — Um app nativo iOS/Android; usa PKCE com tokens de atualização rotativos.
  • Máquina para máquina — Um serviço backend atuando por si só (credenciais do cliente); sem login de usuário.

Aqui estão os passos para criar uma aplicação:

  1. Na página de apps, clique no botão Criar nova aplicação.
  2. Nome Dê um nome ao seu app. ex: App Legal
  3. Tipo de cliente Escolha o tipo que corresponde à forma como seu app autentica — veja Tipos de cliente acima.
  4. URIs de redirecionamento É necessário pelo menos um URI de redirecionamento. Ele é usado para validar o domínio de redirecionamento após uma autenticação bem-sucedida. Não usado para apps Máquina para máquina. ex: https://www.site-legal.com
  5. URIs de redirecionamento pós-logout (Opcional) URLs para onde os usuários podem ser redirecionados após o logout. Deixe em branco para reutilizar os URIs de redirecionamento acima.
  6. Escopos Escolha o que esta aplicação pode acessar em seu nome — veja Escolhendo escopos abaixo.
  7. Clique no botão Criar aplicação para continuar.

Você será redirecionado de volta para sua lista de aplicações, e um diálogo único mostrará o novo Client ID e o Client secret. Copie o segredo agora e salve em um local seguro — ele nunca será mostrado novamente, e não há como recuperá-lo depois (apenas girar para um novo).

Toda aplicação sempre carrega os escopos Login (OpenID Connect) (openid, profile, email, offline_access) — estes confirmam a identidade do usuário e mantêm ele logado, por isso são mostrados marcados e bloqueados; não são uma escolha.

Todo o resto é opcional. Os escopos restantes são agrupados nas mesmas seções funcionais documentadas em Escopos — Conta, Inventário & tarifas, Reservas, Marketing & promoções, Conteúdo da propriedade, Análises & relatórios, Integrações com gerenciadores de canais, Pagamentos e Contabilidade & livro razão — cada um com uma descrição em linguagem simples do que desbloqueia. Use os links Todos / Nenhum acima da lista para selecionar ou limpar todos os escopos opcionais de uma vez.

Duas famílias de escopos são deliberadamente não oferecidas neste formulário:

  • mcp.* — acesso de agente de IA ao transporte do Model Context Protocol. Você não cria uma aplicação para isso: um cliente de IA como Claude, ChatGPT ou Codex se registra e solicita esses escopos quando você faz login pela tela de consentimento MCP. Eles nunca são concedidos a apps máquina para máquina, porque MCP sempre age em nome de um usuário logado.
  • Escopos de nível administrador (administrator.*) — acesso ao nível da plataforma que não é concedido por aplicação.

Uma vez criado o app, tanto esta aba quanto Apps Consentidos mostram seus escopos concedidos agrupados por seção (ex: “Reservas: booking.read”), para que você possa ver o que um app pode fazer rapidamente sem precisar abri-lo.

Se um segredo do cliente pode ter vazado, ou você quer apenas credenciais novas, gire-as em vez de recriar o app:

  1. Encontre o app na sua lista de aplicações e clique em Girar.
  2. Confirme o diálogo — o Client ID e segredo atuais param de funcionar imediatamente.
  3. Copie o novo Client ID e segredo no diálogo único antes de fechá-lo.

Girar mantém o nome do app, tipo de cliente, URIs de redirecionamento e escopos — apenas as credenciais mudam.

Se você não precisar mais de um app, pode removê-lo. Isso é permanente — as credenciais são revogadas imediatamente e não podem ser recuperadas.

  1. Encontre o app na sua lista de aplicações e clique em Excluir.
  2. Confirme o diálogo para excluir permanentemente a aplicação.