Partner-API

De Wink Partner-API is de geauthenticeerde, hogere doorvoersnelheid manier voor integrators om boekbare reisvoorraad op te vragen — dezelfde voorraad die onze in te sluiten widgets en openbare browse-eindpunten aandrijft, beschikbaar gesteld als een eersteklas programmeerbare interface. Waar de gratis Web Components en openbare browse-eindpunten bedoeld zijn voor lichte, mensgerichte insluiting, is de Partner-API gebouwd voor systemen die op schaal zoeken, prijzen en boeken. Toegang is geauthenticeerd per integrator en wordt per gebruik gefactureerd, zodat je alleen betaalt voor het verkeer dat je daadwerkelijk verzendt.

Plannen & prijzen

Gebruik wordt gemeten in hotelnachten: één hotel geprijsd voor één overnachting — niet één API-aanroep. Een zoekopdracht die 20 hotels retourneert voor een verblijf van 3 nachten is 60 hotelnachten vanuit één enkele aanvraag. Content- en Lookup-aanroepen (bestemmingszoekopdracht en autocomplete) zijn de uitzondering: elk kost één eenheid per oproep, ongeacht wat het retourneert. Account-eindpunten zijn gratis. Prijzen zijn de bron van waarheid voor het tarief.

	Gratis	Betaald	Enterprise
Prijs	€0	Gebruik-gebaseerd	Neem contact op
Geschikt voor	Evaluatie & integraties met laag volume	Pay-as-you-go doorvoer op schaal	Aangepast volume & onderhandelde voorwaarden
Eenheden per maand	10.000	Onbeperkt	Onbeperkt
API-responstijd (P95)	—	Onder 500 ms	Onder 500 ms
Prijs per eenheid (hotelnacht)	Gratis	€0,0001	Aangepast
Reactie bij maandelijkse limiet	429 tot de 1e van volgende maand (UTC)	Gefactureerd, niet geblokkeerd	Volgens overeenkomst
Service Level Agreement	—	✓	✓
Prioriteitsondersteuning	—	✓	✓
Toegewijde onboarding	—	—	✓

Vraag een API-sleutel aan · Start metered billing · Contact sales

API-referentie

Twee interfaces bedienen boekbare voorraad, en ze corresponderen met de twee bovenstaande niveaus:

• Gratis — Consumer / Booking Engine API (REST, /api/public/**): anoniem, browser- en widgetgericht. Bekijk de Booking Engine-referentie →
• Betaald — Partner Integrator API (gRPC, wink.partner.v1): geauthenticeerd, gebruik-gemeten, gebouwd voor server-naar-server integratie op schaal. Bekijk de Integrator-referentie →

De Partner Integrator API is gRPC, geen REST. Je roept deze aan met een gegenereerde client via HTTP/2 op partner.wink.travel:443, waarbij je een bearer token en het account waarvoor je aanroept meestuurt:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

De referentiepagina hierboven documenteert elke service, bericht en foutstatus, en het schema is ook beschikbaar tijdens runtime via serverreflectie, zodat grpcurl, Postman en Insomnia het ontdekken zonder iets te hoeven downloaden.

Als je liever vooraf een client genereert, zijn de .proto bronbestanden gepubliceerd op github.com/wink-travel/partner-api-proto.

Hoe gebruik en limieten werken

Gratis niveau

Het Gratis niveau is ontworpen om je in staat te stellen te bouwen, testen en bescheiden productieverkeer te draaien zonder kosten.

• Geen gepubliceerde limiet per minuut. Wink monitort het aantal aanvragen en kan fair-use limieten toepassen om de service te beschermen. Als je een HTTP 429 (Too Many Requests) ontvangt, wacht dan het aantal seconden in de Retry-After header voordat je het opnieuw probeert.
• Maandelijkse limiet — 10.000 eenheden per kalendermaand. De limiet wordt per account toegekend en reset op de 1e van elke maand (UTC). Zodra je deze bereikt, ontvangt een account dat niet is ingeschreven voor pay-as-you-go facturering HTTP 429 tot de 1e van de volgende maand — een harde stop, met een Retry-After header en een bericht dat je uitnodigt om over te stappen naar het Betaalde niveau. Een ingeschreven account blijft werken en wordt gefactureerd voor gebruik boven de limiet.

Het Gratis niveau bevat geen Service Level Agreement of prioriteitsondersteuning.

Betaald niveau

Het Betaalde niveau verwijdert het maandelijkse plafond en factureert je alleen voor wat je gebruikt.

• Gemeten hotelnachten — €0,0001 per hotelnacht. Er is geen maandelijk plafond; je wordt gefactureerd op basis van het werkelijke volume. Wink kan nog steeds fair-use limieten toepassen om de service te beschermen. Zoek- en voorraadaanroepen worden per geprijsde hotelnacht gefactureerd; Content- en Lookup-aanroepen worden per eenheid gefactureerd, dus het bundelen van je aanvragen houdt de rekening laag.

Het Betaalde niveau bevat de hieronder beschreven Service Level Agreement — een uptime-verplichting van 99,9% en een P95-responstijddoel onder 500 ms — en prioriteits- en op ernst gebaseerde ondersteuning.

Service Level Agreement

Ingangsdatum: 5 juli 2026 · Versie 1.0

Deze Service Level Agreement (de “SLA”) beschrijft de beschikbaarheidsverplichting, servicecredits en ondersteuningsdoelen die Wink (“Wink”, “wij”, “ons”) biedt aan een klant (“Klant”, “jij”) voor de geauthenticeerde Wink Partner-API (de “Partner-API” of “Service”) op niveaus waarvoor een SLA van toepassing is verklaard. Deze SLA is opgenomen in en wordt beheerst door de overeenkomst tussen jou en Wink waaronder je toegang hebt tot de Partner-API (de “Overeenkomst”), en is van toepassing zolang je een actieve, betaalde Partner-API-abonnement in goede staat onderhoudt. Hoofdletters die hier niet zijn gedefinieerd, hebben de betekenis die eraan wordt gegeven in de Overeenkomst.

1. Definities

1. “Uptime” betekent de perioden waarin de Partner-API beschikbaar is om correct gevormde, geauthenticeerde verzoeken te accepteren en succesvol te beantwoorden.
2. “Downtime” betekent elke periode, gemeten in minuten, waarin de Partner-API niet succesvol reageert op correct gevormde, geauthenticeerde verzoeken, met uitzondering van elke periode die valt onder de Uitsluitingen zoals beschreven in Sectie 4. Geïsoleerde fouten die een onbeduidend deel van de verzoeken beïnvloeden, zijn op zichzelf geen Downtime.
3. “Maandelijkse Uptime Percentage” betekent, voor een gegeven kalendermaand, het totaal aantal minuten in die maand minus het totaal aantal Downtime-minuten, gedeeld door het totaal aantal minuten in die maand, uitgedrukt als een percentage.
4. “Geplande Onderhoud” betekent gepland onderhoud van de Service waarvoor Wink vooraf kennisgeving heeft gegeven in overeenstemming met Sectie 4.
5. “Service Credit” betekent een tegoed, berekend als een percentage van de door jou betaalde of te betalen vergoedingen voor de Partner-API in de getroffen kalendermaand, dat wordt toegepast op toekomstige Partner-API-kosten als de enige en exclusieve remedie voor het niet nakomen van de Uptime-verplichting.
6. “Responstijd” betekent de verstreken tijd tussen het ontvangen van een correct gevormd, geauthenticeerd verzoek bij de servicegrens van Wink en het moment waarop Wink begint met het retourneren van de respons, exclusief netwerktransit en enige client-side tijd buiten de controle van Wink.

2. Beschikbaarheid & Prestatieverplichting

Wink zal commercieel redelijke inspanningen leveren om de Partner-API beschikbaar te maken met een Maandelijkse Uptime Percentage van ten minste 99,9% gedurende elke kalendermaand van de looptijd (de “Uptime-verplichting”). De Uptime-verplichting wordt gemeten bij de servicegrens van Wink en sluit factoren buiten de redelijke controle van Wink uit, waaronder die beschreven in Sectie 4. De monitoringsystemen van Wink zijn de gezaghebbende bron voor het meten van het Maandelijkse Uptime Percentage en de Responstijd.

Wink streeft verder naar een 95e percentiel (P95) Responstijd van onder 500 milliseconden voor succesvolle, correct gevormde, geauthenticeerde verzoeken, gemeten bij de servicegrens van Wink over elke kalendermaand (het “Prestatie-doel”). Het Prestatie-doel sluit de factoren beschreven in Sectie 4 uit, verzoeken die applicatiefouten retourneren veroorzaakt door het verzoek zelf, en ongewoon grote of complexe batchverzoeken. Het Prestatie-doel is een service-objectief; de Service Credits in Sectie 3 zijn van toepassing op het niet halen van de Uptime-verplichting en zijn de enige en exclusieve remedie voor beschikbaarheidstekorten.

3. Service Credits

Als het Maandelijkse Uptime Percentage onder de Uptime-verplichting valt in een kalendermaand, kom je mogelijk in aanmerking voor een Service Credit berekend als een percentage van de door jou betaalde of te betalen Partner-API-kosten voor die maand, volgens de volgende schaal:

Maandelijks Uptime Percentage	Service Credit
Lager dan 99,9% maar gelijk aan of hoger dan 99,0%	10%
Lager dan 99,0% maar gelijk aan of hoger dan 95,0%	25%
Lager dan 95,0%	50%

1. Claimen van een tegoed. Om een Service Credit te ontvangen, moet je binnen dertig (30) dagen na het einde van de kalendermaand waarin het tekort zich voordeed een schriftelijke claim indienen bij Wink. De claim moet de data en tijden van elk Downtime-incident bevatten waarvoor je claimt en eventuele redelijk beschikbare ondersteunende logs of bewijzen. Claims die na deze termijn worden ingediend, komen niet in aanmerking.
2. Vorm van het tegoed. Goedgekeurde Service Credits worden toegepast op toekomstige Partner-API-kosten en hebben geen contante waarde. Ze zijn geen terugbetalingen en worden niet uitbetaald, behalve waar wettelijk vereist.
3. Maximaal tegoed. De totale Service Credits die voor een enkele kalendermaand worden toegekend, zullen niet meer bedragen dan 50% van de door jou betaalde of te betalen Partner-API-kosten voor die maand.
4. Enige en exclusieve remedie. Service Credits zijn je enige en exclusieve remedie voor elk falen van Wink om te voldoen aan de Uptime-verplichting of enige andere beschikbaarheidstekort van de Partner-API.

4. Uitsluitingen

De Uptime-verplichting en eventuele resulterende Service Credits zijn niet van toepassing op, en Downtime omvat niet, enige onbeschikbaarheid, opschorting, degradatie of prestatieprobleem dat voortkomt uit of verband houdt met:

1. Gepland onderhoud waarvoor Wink vooraf kennisgeving heeft gegeven, mits deze kennisgeving tijdig is gedaan via een kanaal dat Wink normaal gebruikt om met klanten te communiceren;
2. Overmacht of andere oorzaken buiten de redelijke controle van Wink, waaronder natuurrampen, overheidsmaatregelen, netwerk- of nutsstoringen, en denial-of-service of andere kwaadaardige aanvallen;
3. problemen veroorzaakt door jouw handelingen of nalatigheden, jouw apparatuur, software of netwerk, of door enige derde partij service, product of aanbieder die niet onder directe controle van Wink valt;
4. jouw misbruik van de Service of schending van de Overeenkomst, deze SLA, de acceptabele gebruiksvoorwaarden, of toepasselijke snelheidslimieten, inclusief verkeer dat Wink redelijkerwijs als excessief beschouwt, geautomatiseerd misbruik of frauduleus verkeer; en
5. enige opschorting of beëindiging van jouw toegang die correct is uitgevoerd onder de Overeenkomst, inclusief opschorting wegens niet-betaling.

5. Ondersteuning & Reactiedoelen

Wink biedt ondersteuning voor de Partner-API tijdens standaard kantooruren, met uitzondering van lokale feestdagen. Wink zal commercieel redelijke inspanningen leveren om correct ingediende ondersteuningsverzoeken te erkennen binnen de volgende streefreactietijden, gebaseerd op de door jou toegewezen ernst en die Wink redelijkerwijs bevestigt:

Ernst	Beschrijving	Streefreactie eerste contact
Sev 1 — Kritiek	Partner-API is uitgevallen of onbruikbaar in productie zonder workaround.	4 uur
Sev 2 — Groot	Belangrijke functie is beperkt of gedegradeerd; er is een workaround.	1 werkdag
Sev 3 — Klein	Algemene vragen, kleine problemen of functieverzoeken.	2 werkdagen

Streefreactietijden beschrijven wanneer Wink streeft naar initieel contact; het zijn geen garanties voor oplostijd. Prioriteitsondersteuning en op ernst gebaseerde doelen gelden op niveaus waar deze zijn opgenomen.

6. Gegevens & Beveiliging

Wink onderhoudt commercieel redelijke administratieve, technische en organisatorische maatregelen die zijn ontworpen om de vertrouwelijkheid, integriteit en beschikbaarheid van gegevens die via de Partner-API worden verwerkt te beschermen, en beoordeelt deze maatregelen periodiek. De verwerking van persoonsgegevens door Wink wordt beheerst door het Privacybeleid en eventuele gegevensverwerkingsovereenkomsten in de Overeenkomst. Jij blijft verantwoordelijk voor het beveiligen van je eigen API-referenties, voor het wettelijk gebruik van alle gegevens die je opvraagt, en voor het tijdig informeren van Wink bij vermoedens van credentialcompromis.

7. Beperking van Aansprakelijkheid

Service Credits zijn de enige en exclusieve remedie voor enige onbeschikbaarheid of het niet nakomen van de Uptime-verplichting, en worden verstrekt in plaats van enige andere aansprakelijkheid die voortvloeit uit een dergelijk falen. Behalve zoals uitdrukkelijk vermeld in deze SLA, wordt de Partner-API geleverd “zoals beschikbaar”. Voor zover toegestaan door toepasselijke wetgeving, is de totale aansprakelijkheid van Wink voortvloeiend uit of verband houdend met de Service beperkt zoals uiteengezet in de Overeenkomst, en is Wink niet aansprakelijk voor enige indirecte, incidentele, speciale, gevolg- of bestraffende schade, of voor gederfde winst, omzet, gegevens of goodwill, zelfs indien gewaarschuwd voor de mogelijkheid van dergelijke schade.

8. Looptijd, Wijzigingen & Beëindiging

Deze SLA is van toepassing zolang je een actief Partner-API-abonnement hebt op een niveau waarvoor de SLA van toepassing is verklaard. Wink kan deze SLA van tijd tot tijd bijwerken; materiële wijzigingen worden gecommuniceerd via een kanaal dat Wink normaal gebruikt om klanten te bereiken, en voortgezet gebruik van de Partner-API nadat een update van kracht is geworden, betekent acceptatie van de bijgewerkte SLA. Deze SLA eindigt automatisch bij beëindiging of afloop van de Overeenkomst of van je Partner-API-abonnement. Secties die naar hun aard de beëindiging moeten overleven — inclusief opgebouwde maar niet geclaimde Service Credit-geschiktheid, beperking van aansprakelijkheid en definities — blijven van kracht.