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 aplicação já está criada quando cria uma nova conta. Usamos essa aplicação para alguns cenários de reserva.

Não pode reutilizar esta aplicação. Por favor, crie novas aplicações conforme precisar.

Exemplo de entrada de aplicação

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 aplicação

Como não pode aceder à chave secreta da aplicação 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 aplicação, 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 aplicação 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 aplicações 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 as APIs do Wink sem a presença de um utilizador.

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

1. Na página das aplicações, clique no botão Criar nova aplicação.
2. Nome Dê um nome à sua aplicação. ex. Aplicação Fixe
3. Tipo de cliente Escolha SPA para aplicações web ou MACHINE_2_MACHINE para integrações servidor.
4. Nome da entidade Associe a sua aplicação a uma das suas contas existentes. ex. Conta Fixe
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.site-fixe.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 aplicação na lista e terá acesso à chave secreta da aplicação apenas desta vez. Certifique-se de copiá-la e guardá-la num local seguro.

Atualizar aplicação

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

Para atualizar uma aplicação existente, faça o seguinte:

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

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

Remover aplicação

Cuidado

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

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

Para remover uma aplicação, faça o seguinte:

1. Clique no link Ações da aplicação 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.