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 no seu próprio site ou aplicativo.

Nota

Seu primeiro app já está criado quando você cria uma nova conta. Usamos esse app para alguns cenários de reserva.

Você não pode reutilizar esse app. Por favor, crie novos apps conforme precisar.

Entrada de aplicação de exemplo

Nota

Uma aplicação gerada no Wink pode ser usada para todos os endpoints da API.

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. Escolha editar uma existente ou criar uma nova.

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.

Cuidado

Você precisa criar uma conta afiliada no Wink ou uma conta no TripPay antes de criar um app, pois irá vincular sua aplicação a uma conta específica.

Tipos de cliente

Ao criar uma aplicação, você escolhe um tipo de cliente que determina como o app autentica:

• SPA (Single Page Application) — Para aplicações frontend baseadas em navegador que usam o fluxo de código de autorização OAuth2 com PKCE. Este é o tipo mais comum para apps web.
• MACHINE_2_MACHINE — Para integrações servidor a servidor que autenticam diretamente usando credenciais de cliente. Use este quando seu serviço backend precisar chamar APIs do Wink sem a presença de um 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 SPA para apps web ou MACHINE_2_MACHINE para integrações servidor.
4. Nome da entidade Vincule seu app a uma das suas contas existentes. ex: Conta Legal
5. 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. ex: https://www.site-legal.com
6. URIs de redirecionamento pós-logout (Opcional) URLs para onde os usuários podem ser redirecionados após o logout. Isso garante que os usuários cheguem a uma página conhecida após o término da sessão.
7. Clique no botão Salvar para continuar.

Você será redirecionado de volta para sua lista de aplicações. Verá seu novo app na lista e terá acesso à chave secreta do app apenas esta vez. Certifique-se de copiá-la e guardá-la em um local seguro.

Atualizar app

Você precisará atualizar seu app se algum dos seus URIs de redirecionamento mudar ou se quiser adicionar ou remover um URI.

Para atualizar um app existente, faça o seguinte:

1. Clique no link Ações do app que deseja atualizar.
2. Clique no botão Atualizar em Ações.
3. Faça suas alterações no app.
4. Clique no botão Salvar para continuar.

Você será redirecionado de volta para sua lista de aplicações.

Remover app

Cuidado

Por favor, não exclua o app que criamos automaticamente para você para garantir que todos os recursos funcionem para sua conta.

Se você não precisar mais de um app, pode removê-lo.

Para remover um app, faça o seguinte:

1. Clique no link Ações do app que deseja remover.
2. Clique no botão Remover em Ações.
3. Clique no botão OK para confirmar a exclusão.

Você será redirecionado de volta para sua lista de aplicações.