Partner-API

Die Wink Partner-API ist der authentifizierte, leistungsstärkere Weg für Integratoren, buchbare Reisebestände abzufragen – derselbe Bestand, der unsere einbettbaren Widgets und öffentlichen Browse-Endpunkte antreibt, als erstklassige programmatische Schnittstelle bereitgestellt. Während die kostenlosen Web Components und öffentlichen Browse-Endpunkte für leichtgewichtige, nutzerorientierte Einbettungen gedacht sind, ist die Partner-API für Systeme gebaut, die in großem Umfang suchen, Preise ermitteln und buchen. Der Zugriff ist pro Integrator authentifiziert und wird nutzungsabhängig abgerechnet, sodass Sie nur für den tatsächlich gesendeten Traffic zahlen.

Pläne & Preise

Die Nutzung wird in Hotelnächten gemessen: ein Hotel, das für eine Übernachtung bepreist wird – nicht ein API-Aufruf. Eine Suche, die 20 Hotels für einen 3-Nächte-Aufenthalt zurückgibt, entspricht 60 Hotelnächten aus einer einzigen Anfrage. Content- und Lookup-Aufrufe (Zielortsuche und Autovervollständigung) sind die Ausnahme: Jeder kostet eine Einheit pro Aufruf, egal was zurückgegeben wird. Account-Endpunkte sind kostenlos. Preise sind die maßgebliche Quelle für die Raten.

	Kostenlos	Bezahlt	Enterprise
Preis	0 $	Nutzungsabhängig	Kontaktieren Sie uns
Am besten geeignet für	Evaluierung & Integrationen mit geringem Volumen	Pay-as-you-go-Durchsatz in großem Maßstab	Individuelles Volumen & verhandelte Konditionen
Einheiten pro Monat	10.000	Unbegrenzt	Unbegrenzt
API-Antwortzeit (P95)	—	Unter 500 ms	Unter 500 ms
Preis pro Einheit (Hotelnacht)	Kostenlos	0,0001 $	Individuell
Antwort bei Erreichen des monatlichen Kontingents	429 bis zum 1. des Folgemonats (UTC)	Abgerechnet, nicht blockiert	Nach Vereinbarung
Service Level Agreement	—	✓	✓
Priorisierter Support	—	✓	✓
Dediziertes Onboarding	—	—	✓

API-Schlüssel anfordern · Metered Billing starten · Vertrieb kontaktieren

API-Referenz

Zwei Oberflächen bedienen buchbare Bestände und entsprechen den beiden oben genannten Stufen:

• Kostenlos — Consumer / Booking Engine API (REST, /api/public/**): anonym, browser- und widget-orientiert. Booking Engine Referenz durchsuchen →
• Bezahlt — Partner Integrator API (gRPC, wink.partner.v1): authentifiziert, nutzungsabhängig, für Server-zu-Server-Integration in großem Maßstab gebaut. Integrator Referenz durchsuchen →

Die Partner Integrator API ist gRPC, nicht REST. Sie wird mit einem generierten Client über HTTP/2 bei partner.wink.travel:443 aufgerufen, wobei ein Bearer-Token und das Konto, für das Sie anfragen, übergeben werden:

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

Die oben verlinkte Referenzseite dokumentiert jeden Service, jede Nachricht und jeden Fehlerstatus, und das Schema ist auch zur Laufzeit über Server-Reflection verfügbar, sodass grpcurl, Postman und Insomnia es ohne Download entdecken.

Wenn Sie lieber einen Client im Voraus generieren möchten, sind die .proto-Quelldateien veröffentlicht unter github.com/wink-travel/partner-api-proto.

Wie Nutzung und Limits funktionieren

Kostenlose Stufe

Die kostenlose Stufe ist so konzipiert, dass Sie damit bauen, testen und moderaten Produktionstraffic ohne Kosten betreiben können.

• Kein veröffentliches Limit pro Minute. Wink überwacht die Anfrageraten und kann Fair-Use-Limits anwenden, um den Dienst zu schützen. Wenn Sie einen HTTP 429 (Too Many Requests) erhalten, warten Sie die im Retry-After-Header angegebene Anzahl Sekunden, bevor Sie es erneut versuchen.
• Monatliches Kontingent – 10.000 Einheiten pro Kalendermonat. Das Kontingent wird pro Konto gewährt und am 1. jedes Monats (UTC) zurückgesetzt. Sobald Sie es erreichen, erhält ein Konto ohne Pay-as-you-go-Abrechnung HTTP 429 bis zum 1. des nächsten Monats – ein harter Stopp mit Retry-After-Header und einer Nachricht, die zur Buchung der bezahlten Stufe einlädt. Ein angemeldetes Konto arbeitet weiter und wird für die Nutzung über das Kontingent hinaus abgerechnet.

Die kostenlose Stufe beinhaltet kein Service Level Agreement oder priorisierten Support.

Bezahlte Stufe

Die bezahlte Stufe hebt die monatliche Obergrenze auf und berechnet nur die tatsächliche Nutzung.

• Gemessene Hotelnächte – 0,0001 $ pro Hotelnacht. Es gibt keine monatliche Obergrenze; Sie zahlen nach tatsächlichem Volumen. Wink kann weiterhin Fair-Use-Limits zum Schutz des Dienstes anwenden. Such- und Inventaraufrufe werden pro bepreister Hotelnacht abgerechnet; Content- und Lookup-Aufrufe jeweils mit einer Einheit, daher hält das Bündeln der Anfragen die Kosten niedrig.

Die bezahlte Stufe beinhaltet das unten beschriebene Service Level Agreement – eine Verfügbarkeitsgarantie von 99,9 % und ein P95-Antwortzeit-Ziel unter 500 ms – sowie priorisierten, nach Schweregrad gestaffelten Support.

Service Level Agreement

Gültig ab: 5. Juli 2026 · Version 1.0

Dieses Service Level Agreement (das „SLA“) legt die Verfügbarkeitsverpflichtung, Servicegutschriften und Supportziele fest, die Wink („Wink“, „wir“, „uns“) einem Kunden („Kunde“, „Sie“) für die authentifizierte Wink Partner-API (die „Partner-API“ oder „Dienst“) auf Stufen, für die ein SLA gilt, bietet. Dieses SLA ist Bestandteil und wird durch die Vereinbarung zwischen Ihnen und Wink geregelt, unter der Sie auf die Partner-API zugreifen (die „Vereinbarung“), und gilt so lange, wie Sie ein aktives, bezahltes Partner-API-Abonnement in gutem Stand halten. Großgeschriebene Begriffe, die hier nicht definiert sind, haben die Bedeutung, die ihnen in der Vereinbarung zugewiesen wird.

1. Definitionen

1. „Verfügbarkeit“ bezeichnet die Zeiträume, in denen die Partner-API verfügbar ist, um ordnungsgemäß formatierte, authentifizierte Anfragen anzunehmen und erfolgreich zu beantworten.
2. „Ausfallzeit“ bezeichnet jeden Zeitraum, gemessen in Minuten, in dem die Partner-API nicht erfolgreich auf ordnungsgemäß formatierte, authentifizierte Anfragen antwortet, ausgenommen Zeiträume, die unter die Ausschlüsse in Abschnitt 4 fallen. Einzelne Fehler, die nur einen unbedeutenden Bruchteil der Anfragen betreffen, gelten nicht als Ausfallzeit.
3. „Monatlicher Verfügbarkeitsprozentsatz“ bezeichnet für einen Kalendermonat die Gesamtzahl der Minuten in diesem Monat minus der Ausfallzeit-Minuten, geteilt durch die Gesamtzahl der Minuten in diesem Monat, ausgedrückt als Prozentsatz.
4. „Geplante Wartung“ bezeichnet geplante Wartungsarbeiten am Dienst, für die Wink eine Vorankündigung gemäß Abschnitt 4 gegeben hat.
5. „Servicegutschrift“ bezeichnet eine Gutschrift, berechnet als Prozentsatz der von Ihnen für die Partner-API im betroffenen Kalendermonat gezahlten oder zahlbaren Gebühren, die als einziges und ausschließliches Mittel für eine Nichterfüllung der Verfügbarkeitsverpflichtung auf zukünftige Partner-API-Gebühren angerechnet wird.
6. „Antwortzeit“ bezeichnet die verstrichene Zeit zwischen dem Eingang einer ordnungsgemäß formatierten, authentifizierten Anfrage an der Dienstgrenze von Wink und dem Zeitpunkt, an dem Wink beginnt, die Antwort zurückzugeben, ohne Netzwerklatenz und jegliche clientseitige Zeit außerhalb von Winks Kontrolle.

2. Verfügbarkeits- & Leistungsversprechen

Wink wird sich nach kommerziell angemessenen Anstrengungen bemühen, die Partner-API mit einem monatlichen Verfügbarkeitsprozentsatz von mindestens 99,9 % während jedes Kalendermonats der Laufzeit bereitzustellen (das „Verfügbarkeitsversprechen“). Das Verfügbarkeitsversprechen wird an der Dienstgrenze von Wink gemessen und schließt Faktoren aus, die außerhalb von Winks angemessener Kontrolle liegen, einschließlich der in Abschnitt 4 beschriebenen. Die Überwachungssysteme von Wink sind die maßgebliche Quelle zur Messung des monatlichen Verfügbarkeitsprozentsatzes und der Antwortzeit.

Wink strebt außerdem eine 95. Perzentil (P95) Antwortzeit von unter 500 Millisekunden für erfolgreiche, ordnungsgemäß formatierte, authentifizierte Anfragen an, gemessen an der Dienstgrenze von Wink über jeden Kalendermonat (das „Leistungsziel“). Das Leistungsziel schließt die in Abschnitt 4 beschriebenen Faktoren, Anfragen, die Anwendungsfehler aufgrund der Anfrage selbst zurückgeben, sowie ungewöhnlich große oder komplexe Batch-Anfragen aus. Das Leistungsziel ist ein Serviceziel; die in Abschnitt 3 genannten Servicegutschriften gelten für Nichterfüllungen des Verfügbarkeitsversprechens und sind das einzige und ausschließliches Mittel bei Verfügbarkeitsmängeln.

3. Servicegutschriften

Fällt der monatliche Verfügbarkeitsprozentsatz in einem Kalendermonat unter das Verfügbarkeitsversprechen, können Sie Anspruch auf eine Servicegutschrift haben, die als Prozentsatz der von Ihnen für diesen Monat gezahlten oder zahlbaren Partner-API-Gebühren berechnet wird, gemäß folgender Staffelung:

Monatlicher Verfügbarkeitsprozentsatz	Servicegutschrift
Unter 99,9 % aber mindestens 99,0 %	10 %
Unter 99,0 % aber mindestens 95,0 %	25 %
Unter 95,0 %	50 %

1. Gutschrift beantragen. Um eine Servicegutschrift zu erhalten, müssen Sie Wink innerhalb von dreißig (30) Tagen nach Ende des Kalendermonats, in dem der Ausfall auftrat, eine schriftliche Forderung vorlegen. Die Forderung muss die Daten und Zeiten jedes Ausfallereignisses enthalten, für das Sie eine Gutschrift beantragen, sowie alle Ihnen vernünftigerweise verfügbaren unterstützenden Protokolle oder Nachweise. Nach Ablauf dieser Frist eingereichte Forderungen sind nicht berechtigt.
2. Form der Gutschrift. Genehmigte Servicegutschriften werden auf zukünftige Partner-API-Gebühren angerechnet und haben keinen Barwert. Sie sind keine Rückerstattungen und werden nur ausgezahlt, wenn dies gesetzlich vorgeschrieben ist.
3. Maximale Gutschrift. Die insgesamt für einen einzelnen Kalendermonat gewährten Servicegutschriften überschreiten nicht 50 % der von Ihnen für diesen Monat gezahlten oder zahlbaren Partner-API-Gebühren.
4. Alleiniges und ausschließliches Mittel. Servicegutschriften sind Ihr alleiniges und ausschließliches Mittel für jegliches Versäumnis von Wink, das Verfügbarkeitsversprechen zu erfüllen oder sonstige Verfügbarkeitsmängel der Partner-API.

4. Ausschlüsse

Das Verfügbarkeitsversprechen und daraus resultierende Servicegutschriften gelten nicht, und Ausfallzeiten schließen nicht ein, jegliche Nichtverfügbarkeit, Aussetzung, Verschlechterung oder Leistungsprobleme, die entstehen aus oder im Zusammenhang stehen mit:

1. Geplanter Wartung, für die Wink eine Vorankündigung gegeben hat, sofern diese rechtzeitig über einen Kanal erfolgt, den Wink üblicherweise zur Kommunikation mit Kunden nutzt;
2. Höherer Gewalt oder anderen Ursachen außerhalb von Winks angemessener Kontrolle, einschließlich Naturkatastrophen, Regierungsmaßnahmen, Netzwerk- oder Versorgungsunterbrechungen sowie Denial-of-Service- oder anderen böswilligen Angriffen;
3. Problemen, die durch Ihr Verhalten oder Unterlassen, Ihre Ausrüstung, Software oder Ihr Netzwerk oder durch einen Drittanbieter-Dienst, -Produkt oder -Anbieter verursacht werden, der nicht unter direkter Kontrolle von Wink steht;
4. Ihrem Missbrauch des Dienstes oder Verstoß gegen die Vereinbarung, dieses SLA, die Nutzungsbedingungen oder geltende Ratenlimits, einschließlich Traffic, den Wink vernünftigerweise als übermäßig, automatisierten Missbrauch oder betrügerisch einstuft; und
5. jeglicher Aussetzung oder Beendigung Ihres Zugangs, die ordnungsgemäß gemäß der Vereinbarung erfolgt, einschließlich Aussetzung wegen Nichtzahlung.

5. Support- & Reaktionsziele

Wink bietet Support für die Partner-API während der regulären Geschäftszeiten, ausgenommen lokale Feiertage. Wink wird sich nach kommerziell angemessenen Anstrengungen bemühen, ordnungsgemäß eingereichte Supportanfragen innerhalb der folgenden Zielreaktionszeiten anzuerkennen, basierend auf der von Ihnen zugewiesenen und von Wink vernünftigerweise bestätigten Schwere:

Schweregrad	Beschreibung	Ziel für erste Antwort
Sev 1 — Kritisch	Partner-API ist in Produktion ausgefallen oder unbrauchbar ohne Workaround.	4 Stunden
Sev 2 — Groß	Wesentliche Funktion beeinträchtigt oder verschlechtert; Workaround vorhanden.	1 Werktag
Sev 3 — Klein	Allgemeine Fragen, kleinere Probleme oder Feature-Anfragen.	2 Werktage

Zielreaktionszeiten beschreiben, wann Wink die erste Kontaktaufnahme anstrebt; sie sind keine Garantie für die Lösungszeit. Priorisierter Support und schweregradbasierte Ziele gelten auf Stufen, für die sie als enthalten angegeben sind.

6. Daten & Sicherheit

Wink unterhält kommerziell angemessene administrative, technische und organisatorische Maßnahmen zum Schutz der Vertraulichkeit, Integrität und Verfügbarkeit der über die Partner-API verarbeiteten Daten und überprüft diese Maßnahmen regelmäßig. Die Verarbeitung personenbezogener Daten durch Wink unterliegt der Datenschutzerklärung und etwaigen Datenverarbeitungsbedingungen in der Vereinbarung. Sie sind verantwortlich für die Sicherung Ihrer eigenen API-Zugangsdaten, für die rechtmäßige Nutzung aller abgerufenen Daten und für die unverzügliche Benachrichtigung von Wink bei einem vermuteten Missbrauch der Zugangsdaten.

7. Haftungsbeschränkung

Servicegutschriften sind das alleinige und ausschließliches Mittel für jegliche Nichtverfügbarkeit oder Nichterfüllung des Verfügbarkeitsversprechens und werden anstelle jeglicher anderer Haftung für solche Versäumnisse gewährt. Soweit in diesem SLA nicht ausdrücklich anders angegeben, wird die Partner-API „wie verfügbar“ bereitgestellt. Soweit gesetzlich zulässig, ist die Gesamthaftung von Wink aus oder im Zusammenhang mit dem Dienst auf das in der Vereinbarung festgelegte Maß beschränkt, und Wink haftet nicht für indirekte, beiläufige, besondere, Folgeschäden oder Strafschäden oder für entgangene Gewinne, Einnahmen, Daten oder Goodwill, selbst wenn auf die Möglichkeit solcher Schäden hingewiesen wurde.

8. Laufzeit, Änderungen & Beendigung

Dieses SLA gilt, solange Sie ein aktives Partner-API-Abonnement auf einer Stufe haben, für die das SLA gilt. Wink kann dieses SLA von Zeit zu Zeit aktualisieren; wesentliche Änderungen werden über einen Kanal kommuniziert, den Wink üblicherweise zur Kundenkommunikation nutzt, und die weitere Nutzung der Partner-API nach Inkrafttreten einer Aktualisierung gilt als Zustimmung zum aktualisierten SLA. Dieses SLA endet automatisch mit der Beendigung oder dem Ablauf der Vereinbarung oder Ihres Partner-API-Abonnements. Abschnitte, die ihrer Natur nach über die Beendigung hinaus gelten sollten – einschließlich angesammelter, aber nicht beanspruchter Servicegutschriften, Haftungsbeschränkungen und Definitionen – bleiben bestehen.