Aplicações

As aplicações dão-lhe acesso a todas as funcionalidades do Wink como desenvolvedor. Pode aceder a todos os mesmos dados e até estender as funcionalidades do próprio Wink. Pode optar por usar o servidor OAuth2 do Wink para autenticar o seu site de viagens da mesma forma que usaria o Google ou o Facebook. Desta forma, pode estender as funcionalidades do Wink para o seu próprio website ou aplicação.

Nota

A sua primeira app já está criada quando cria uma nova conta. Usamos essa app para alguns cenários de reserva.

Não pode reutilizar esta app. Por favor, crie novas 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 quer trabalhar em Contas.
2. Clique em Ações na parte inferior do cartão da conta e escolha Gerir conta.
3. Clique no separador Aplicações na página seguinte.
4. Esta secção listará todas as suas aplicações.
5. Escolha editar uma existente ou criar uma nova.

Criar app

Como não pode aceder à chave secreta da app que criámos para si, terá de criar a sua própria.

Cuidado

Precisa de criar uma conta afiliada no Wink ou uma conta no TripPay antes de criar uma app, pois irá associar a sua aplicação a uma conta específica.

Tipos de cliente

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

• SPA (Single Page Application) — Para aplicações frontend baseadas em browser 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 se autenticam diretamente usando credenciais de cliente. Use este tipo quando o seu serviço backend precisar de chamar APIs Wink sem um utilizador presente.

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

1. Na página das apps, clique no botão Criar nova aplicação.
2. Nome Dê um nome à sua app. ex. Cool App
3. Tipo de cliente Escolha SPA para apps web ou MACHINE_2_MACHINE para integrações servidor.
4. Nome da entidade Associe a sua app a uma das suas contas existentes. ex. Cool Account
5. URIs de redirecionamento É necessário pelo menos um URI de redirecionamento. É usado para validar o domínio de redirecionamento após uma autenticação bem-sucedida. ex. https://www.cool-site.com
6. URIs de redirecionamento pós-logout (Opcional) URLs para onde os utilizadores podem ser redirecionados após efetuarem logout. Isto garante que os utilizadores aterrem numa página conhecida após o fim da sessão.
7. Clique no botão Guardar para continuar.

Será redirecionado de volta para a sua lista de aplicações. Verá a sua nova app na lista e terá acesso à chave secreta da app apenas esta vez. Certifique-se de copiá-la e guardá-la num local seguro.

Atualizar app

Terá de atualizar a sua app se algum dos seus URIs de redirecionamento mudar ou se quiser adicionar ou remover um URI.

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

1. Clique no link Ações da app que quer atualizar.
2. Clique no botão Atualizar em Ações.
3. Faça as alterações na app.
4. Clique no botão Guardar para continuar.

Será redirecionado de volta para a sua lista de aplicações.

Remover app

Cuidado

Por favor, não elimine a app que criámos automaticamente para si para garantir que todas as funcionalidades funcionem para a sua conta.

Se não precisar mais de uma app, pode removê-la.

Para remover uma app, faça o seguinte:

1. Clique no link Ações da app que quer atualizar.
2. Clique no botão Remover em Ações.
3. Clique no botão OK para confirmar a eliminação.

Será redirecionado de volta para a sua lista de aplicações.