Aplicativos

Os aplicativos dão a você 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.

Aplicativo de exemplo — *Entrada de aplicativo de exemplo*

Selecione a conta com a qual deseja trabalhar em Contas.
Clique em Ações na parte inferior do cartão da conta e escolha Gerenciar conta.
Clique na aba Aplicativos na página seguinte.
Esta seção listará todos os seus aplicativos.
Gire ou exclua um existente, ou crie um novo.

Criar app

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 um aplicativo aqui sem precisar configurar primeiro uma propriedade ou empresa — ele não está vinculado a nenhuma conta específica.

Tipos de cliente

Ao criar um aplicativo, 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 um novo aplicativo.

Aplicativo 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 um aplicativo:

Na página de apps, clique no botão Criar novo aplicativo.
Nome Dê um nome ao seu app. ex: App Legal
Tipo de cliente Escolha o tipo que corresponde à forma como seu app autentica — veja Tipos de cliente acima.
URIs de redirecionamento Pelo menos um URI de redirecionamento é obrigatório. 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
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.
Escopos Escolha o que este aplicativo pode acessar em seu nome — veja Escolhendo escopos abaixo.
Clique no botão Criar aplicativo para continuar.

Você será redirecionado de volta para sua lista de aplicativos, 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).

Escolhendo escopos

Todo aplicativo 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 e tarifas, Reservas, Marketing e promoções, Conteúdo da propriedade, Análises e relatórios, Integrações com gerenciadores de canais, Pagamentos e Contabilidade e 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, que é provisionado separadamente e apenas para clientes máquina para máquina.
Escopos de nível administrador (administrator.*) — acesso em nível de plataforma que não é concedido por aplicativo.

Uma vez criado um 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 de relance sem precisar abri-lo.

Girar credenciais

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

Encontre o app na sua lista de aplicativos e clique em Girar.
Confirme o diálogo — o Client ID e segredo atuais param de funcionar imediatamente.
Copie o novo Client ID e segredo do diálogo único antes de fechá-lo.

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

Remover app

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.

Encontre o app na sua lista de aplicativos e clique em Excluir.
Confirme o diálogo para excluir permanentemente o aplicativo.