Applicaties

Applicaties geven je als ontwikkelaar toegang tot alle functies van Wink. Je kunt toegang krijgen tot dezelfde data en zelfs de eigen functies van Wink uitbreiden. Je kunt ervoor kiezen om de OAuth2-server van Wink te gebruiken om je reiswebsite te authenticeren, net zoals je Google of Facebook zou gebruiken. Op die manier kun je de functies van Wink uitbreiden naar je eigen website of applicatie.

Opmerking

Je eerste app is al aangemaakt wanneer je een nieuw account aanmaakt. We gebruiken deze app voor enkele boekingsscenario’s.

Je kunt deze app niet hergebruiken. Maak nieuwe apps aan wanneer je ze nodig hebt.

Voorbeeld van een applicatie-invoer

Opmerking

Een applicatie die op Wink is gegenereerd, kan voor alle API-eindpunten worden gebruikt.

1. Selecteer het account waarmee je wilt werken via Accounts.
2. Klik onderaan de accountkaart op Acties en kies Account beheren.
3. Klik op het tabblad Applicaties op de volgende pagina.
4. In dit gedeelte worden al je applicaties weergegeven.
5. Draai of verwijder een bestaande app, of maak een nieuwe aan.

App maken

Omdat je geen toegang hebt tot de geheime sleutel van de app die wij voor je hebben gemaakt, moet je je eigen app aanmaken. Je kunt hier een applicatie maken zonder eerst een accommodatie of bedrijf in te stellen — het is niet gebonden aan een specifiek account.

Clienttypes

Bij het maken van een applicatie kies je een clienttype dat bepaalt hoe de app authenticatie uitvoert. Dit kan later niet worden gewijzigd — als je een ander type nodig hebt, maak dan een nieuwe applicatie aan.

• Webapplicatie — Een server-gerenderde app die veilig een clientgeheim kan bewaren (authorization code flow).
• Single-page app (SPA) — Een browserapp zonder backend; gebruikt PKCE, zonder clientgeheim.
• Mobiele app — Een native iOS/Android-app; gebruikt PKCE met roterende refresh tokens.
• Machine-to-machine — Een backendservice die namens zichzelf handelt (client credentials); geen gebruikersaanmelding.

Hier zijn de stappen om een applicatie te maken:

1. Klik op de app-pagina op de knop Nieuwe applicatie maken.
2. Naam Geef je app een naam. bijv. Coole App
3. Clienttype Kies het type dat overeenkomt met hoe je app authenticatie uitvoert — zie Clienttypes hierboven.
4. Redirect-URI’s Minimaal één redirect-URI is vereist. Deze wordt gebruikt om het redirect-domein te valideren na een succesvolle authenticatie. Niet gebruikt voor machine-to-machine apps. bijv. https://www.coole-site.com
5. Post-logout redirect-URI’s (optioneel) URL’s waar gebruikers na uitloggen naartoe kunnen worden geleid. Laat leeg om de redirect-URI’s hierboven opnieuw te gebruiken.
6. Scopes Kies waartoe deze applicatie namens jou toegang heeft — zie Scopes kiezen hieronder.
7. Klik op de knop Applicatie maken om door te gaan.

Je wordt teruggeleid naar je lijst met applicaties en er verschijnt een eenmalige dialoog met de nieuwe Client ID en Client secret. Kopieer het geheim nu en sla het veilig op — het wordt nooit meer getoond en kan later niet worden teruggehaald (alleen roteren voor een nieuwe).

Scopes kiezen

Elke applicatie draagt altijd de Aanmelden (OpenID Connect) scopes (openid, profile, email, offline_access) — deze bevestigen de identiteit van de gebruiker en houden deze ingelogd, dus ze zijn aangevinkt en vergrendeld; ze zijn geen keuze.

Alles wat ernaast staat is opt-in. De overige scopes zijn gegroepeerd in dezelfde functionele secties zoals gedocumenteerd in Scopes — Account, Voorraad & tarieven, Boekingen, Marketing & promoties, Accommodatie-inhoud, Analyse & rapportages, Channel manager-integraties, Betalingen, en Boekhouding & grootboek — elk met een duidelijke beschrijving van wat het ontgrendelt. Gebruik de links Alles / Geen boven de lijst om alle optionele scopes tegelijk te selecteren of te deselecteren.

Opmerking

Betalingen en Boekhouding & grootboek zijn gemarkeerd als Gevoelig omdat ze geldstromen beheren — geef deze alleen aan applicaties die specifiek betalingen of het grootboek moeten kunnen benaderen.

Twee scope-families worden bewust niet aangeboden op dit formulier:

• mcp.* — AI-agent toegang tot het Model Context Protocol transport, dat apart wordt geregeld en alleen voor machine-to-machine clients is.
• Administrator-niveau scopes (administrator.*) — platformniveau toegang die niet per applicatie wordt toegekend.

Zodra een app is aangemaakt, tonen zowel dit tabblad als Toestemmingsapps de verleende scopes gegroepeerd per sectie (bijv. “Boekingen: booking.read”), zodat je in één oogopslag kunt zien wat een app kan doen zonder deze te openen.

Referenties roteren

Als een clientgeheim mogelijk is gelekt, of je gewoon nieuwe referenties wilt, roteer ze dan in plaats van de app opnieuw te maken:

1. Zoek de app in je lijst met applicaties en klik op Roteer.
2. Bevestig de dialoog — de huidige Client ID en secret werken direct niet meer.
3. Kopieer de nieuwe Client ID en secret uit de eenmalige dialoog voordat je deze sluit.

Roteer behoudt de naam van de app, het clienttype, redirect-URI’s en scopes — alleen de referenties veranderen.

App verwijderen

Opgepast

Verwijder alsjeblieft niet de app die we automatisch voor je hebben aangemaakt om te zorgen dat alle functies voor je account werken.

Als je een app niet meer nodig hebt, kun je deze verwijderen. Dit is permanent — de referenties worden direct ingetrokken en kunnen niet worden hersteld.

1. Zoek de app in je lijst met applicaties en klik op Verwijderen.
2. Bevestig de dialoog om de applicatie permanent te verwijderen.