Hoppa till innehåll

Partner-API

Wink Partner-API är det autentiserade, högkapacitetsgränssnittet för integratörer att fråga bokningsbar reseinventarie — samma utbud som driver våra inbäddningsbara widgets och offentliga bläddringsendpoints, exponerat som ett förstklassigt programmatisk gränssnitt. Där de kostnadsfria Web Components och offentliga bläddringsendpoints är avsedda för lättviktig, användarvänlig inbäddning, är Partner-API:et byggt för system som söker, prissätter och bokar i stor skala. Åtkomst är autentiserad per integratör och debiteras per användning, så du betalar bara för den trafik du faktiskt skickar.

Ett API-anrop = en förfrågan. Mätanvändning debiteras per 1 000 förfrågningar.

GratisBetaldEnterprise
Pris0 $AnvändningsbaseratKontakta oss
Bäst förUtvärdering & lågvolymsintegrationerBetala per användning i stor skalaAnpassad volym & förhandlade villkor
Förfrågningar per minut30 (60 burst)ObegränsatObegränsat
Förfrågningar per månad10 000ObegränsatObegränsat
API-svarstid (P95)Under 500 msUnder 500 ms
Pris per 1 000 förfrågningarGratis1,00 $Anpassat
Look-to-book-överskridande (per 1 000 överskjutande sökningar över 5 000:1)2,00 $Anpassat
Svar vid hastighetsbegränsning429 (paus / månatlig hård stopp)IngenIngen
Service Level Agreement
Prioriterad support
Dedikerad onboarding

Få en API-nyckel · Starta mätbaserad fakturering · Kontakta försäljning

Två gränssnitt tjänar bokningsbar inventarie, och de motsvarar de två nivåerna ovan:

Partner Integrator API är gRPC, inte REST. Du anropar det med en genererad klient över HTTP/2 på partner.wink.travel:443, med en bearer-token och det konto du anropar för:

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

Referenssidan ovan dokumenterar varje tjänst, meddelande och felstatus, och schemat är också tillgängligt i realtid via serverreflektion, så grpcurl, Postman och Insomnia kan upptäcka det utan något att ladda ner.

Om du hellre vill generera en klient i förväg finns .proto-källfiler publicerade på github.com/wink-travel/partner-api-proto.

Hur användning och begränsningar fungerar

Section titled “Hur användning och begränsningar fungerar”

Gratisnivån är utformad för att låta dig bygga, testa och köra måttlig produktionstrafik utan kostnad.

  • Hastighetsbegränsning — 30 förfrågningar per minut, med en burst på 60 förfrågningar. Kortvariga toppar över den hållna takten absorberas av burst-tillåtelsen. Om du överskrider den svarar API:et med HTTP 429 (För många förfrågningar) och tillämpar en 5-minuters paus innan din nyckel återupptar trafik. Backa och försök igen efter pausfönstret istället för att överbelasta endpointen.
  • Månadsquota — 10 000 förfrågningar per kalendermånad. När du når månadstaket returnerar API:et HTTP 429 för resten av månaden — ett hårt stopp — tillsammans med ett meddelande som uppmanar dig att prenumerera på Betald nivå för att fortsätta. Räknaren återställs i början av nästa kalendermånad.

Gratisnivån inkluderar inte Service Level Agreement eller prioriterad support.

Betald nivå tar bort månadstaket och paus vid hastighetsbegränsning, och debiterar dig bara för det du använder.

  • Mätade förfrågningar — 1,00 $ per 1 000 förfrågningar. Det finns inget månatligt tak för förfrågningar och ingen hastighetsbegränsning vid normal användning; du debiteras på faktisk volym.

  • Look-to-book-överskridande — 2,00 $ per 1 000 överskjutande sökningar. För att hålla utbudet hälsosamt mäter vi förhållandet mellan sökningar (“looks”) och bekräftade bokningar. Du har rätt till 5 000 sökningar per bokning innan överskridande tillämpas. Överskjutande sökningar beräknas som:

    överskott = max(0, sökningar − bokningar × 5 000)

    Överskridande debiteras sedan med 2,00 $ per 1 000 överskjutande sökningar. Integrationer som konverterar väl drabbas sällan av överskridande; avgiften gäller endast trafik som söker mycket mer än den bokar.

Betald nivå inkluderar Service Level Agreement som beskrivs nedan — ett åtagande om 99,9 % drifttid och ett P95-svarstidsmål under 500 ms — samt prioriterad, allvarlighetsbaserad support.

Giltighetsdatum: 5 juli 2026 · Version 1.0

Detta Service Level Agreement (”SLA”) fastställer tillgänglighetsåtagandet, servicekrediter och supportmål som Wink (“Wink”, “vi”, “oss”) tillhandahåller en kund (“Kund”, “du”) för det autentiserade Wink Partner-API:et (”Partner-API” eller ”Tjänsten”) på nivåer där ett SLA anges gälla. Detta SLA är införlivat i och styrs av avtalet mellan dig och Wink under vilket du får tillgång till Partner-API:et (”Avtalet”), och gäller så länge du upprätthåller en aktiv, betald Partner-API-prenumeration i gott skick. Stora begrepp som inte definieras här har den betydelse som anges i Avtalet.

  1. ”Drifttid” betyder de perioder då Partner-API:et är tillgängligt för att ta emot och framgångsrikt svara på korrekt formulerade, autentiserade förfrågningar.
  2. ”Nertid” betyder varje period, mätt i minuter, då Partner-API:et inte lyckas svara framgångsrikt på korrekt formulerade, autentiserade förfrågningar, exklusive perioder som omfattas av undantagen i avsnitt 4. Isolerade fel som påverkar en obetydlig andel förfrågningar är inte i sig Nertid.
  3. ”Månatlig drifttidsprocent” betyder, för en given kalendermånad, det totala antalet minuter i den månaden minus totala Nertid-minuter, dividerat med det totala antalet minuter i den månaden, uttryckt i procent.
  4. ”Schemalagd underhåll” betyder planerat underhåll av Tjänsten för vilket Wink har gett förhandsbesked i enlighet med avsnitt 4.
  5. ”Servicekredit” betyder en kredit, beräknad som en procentandel av de avgifter som du betalat eller ska betala för Partner-API:et under den berörda kalendermånaden, som tillämpas mot framtida Partner-API-avgifter som det enda och exklusiva medlet vid uteblivet uppfyllande av Drifttidsåtagandet.
  6. ”Svarstid” betyder den tid som förflyter mellan att Wink mottar en korrekt formulerad, autentiserad förfrågan vid Winks tjänstegräns och den punkt då Wink börjar returnera svaret, exklusive nätverkstransport och eventuell klienttid utanför Winks kontroll.

Wink ska använda kommersiellt rimliga ansträngningar för att göra Partner-API:et tillgängligt med en månatlig drifttidsprocent på minst 99,9 % under varje kalendermånad under avtalsperioden (”Drifttidsåtagandet”). Drifttidsåtagandet mäts vid Winks tjänstegräns och exkluderar faktorer utanför Winks rimliga kontroll, inklusive de som beskrivs i avsnitt 4. Winks övervakningssystem är den auktoritativa källan för mätning av månatlig drifttidsprocent och svarstid.

Wink siktar dessutom på en 95:e percentil (P95) svarstid under 500 millisekunder för framgångsrika, korrekt formulerade, autentiserade förfrågningar, mätt vid Winks tjänstegräns över varje kalendermånad (”Prestandamålet”). Prestandamålet exkluderar faktorerna i avsnitt 4, förfrågningar som returnerar applikationsnivåfel orsakade av förfrågan själv, samt ovanligt stora eller komplexa batchförfrågningar. Prestandamålet är ett serviceobjektiv; Servicekrediterna i avsnitt 3 gäller vid uteblivet uppfyllande av Drifttidsåtagandet och är det enda och exklusiva medlet vid tillgänglighetsbrister.

Om den månatliga drifttidsprocenten understiger Drifttidsåtagandet under någon kalendermånad kan du vara berättigad till en Servicekredit beräknad som en procentandel av de Partner-API-avgifter du betalat eller ska betala för den månaden, enligt följande skala:

Månatlig drifttidsprocentServicekredit
Under 99,9 % men minst 99,0 %10 %
Under 99,0 % men minst 95,0 %25 %
Under 95,0 %50 %
  1. Ansökan om kredit. För att få en Servicekredit måste du skriftligen ansöka till Wink inom trettio (30) dagar efter slutet av den kalendermånad då bristen inträffade. Ansökan måste innehålla datum och tider för varje Nertid-incident du gör anspråk på samt eventuella rimligt tillgängliga loggar eller bevis. Ansökningar efter denna tidsfrist är inte berättigade.
  2. Kreditens form. Godkända Servicekrediter tillämpas mot framtida Partner-API-avgifter och har inget kontantvärde. De är inte återbetalningar och betalas inte ut annat än där tillämplig lag kräver det.
  3. Maximal kredit. Totala Servicekrediter för någon enskild kalendermånad får inte överstiga 50 % av de Partner-API-avgifter du betalat eller ska betala för den månaden.
  4. Enda och exklusiva medel. Servicekrediter är ditt enda och exklusiva medel vid uteblivet uppfyllande av Drifttidsåtagandet eller annan tillgänglighetsbrist i Partner-API:et.

Drifttidsåtagandet och eventuella Servicekrediter gäller inte, och Nertid inkluderar inte, någon otillgänglighet, avstängning, försämring eller prestandaproblem som uppstår från eller relaterar till:

  1. Schemalagt underhåll för vilket Wink har gett förhandsbesked, förutsatt att sådant besked ges inom rimlig tid i förväg via en kanal som Wink normalt använder för kundkommunikation;
  2. Force majeure-händelser eller andra orsaker utanför Winks rimliga kontroll, inklusive naturkatastrofer, myndighetsåtgärder, nätverks- eller elavbrott samt denial-of-service eller andra illvilliga attacker;
  3. problem orsakade av dina handlingar eller underlåtenheter, din utrustning, programvara eller nätverk, eller av någon tredjeparts tjänst, produkt eller leverantör som inte är under Winks direkta kontroll;
  4. ditt missbruk av Tjänsten eller brott mot Avtalet, detta SLA, användarvillkoren eller tillämpliga hastighetsbegränsningar, inklusive trafik som Wink rimligen bedömer som överdriven, automatiserat missbruk eller bedrägligt; och
  5. någon avstängning eller uppsägning av din åtkomst som korrekt genomförts enligt Avtalet, inklusive avstängning för utebliven betalning.

Wink tillhandahåller support för Partner-API:et under ordinarie kontorstid, exklusive lokala helgdagar. Wink ska använda kommersiellt rimliga ansträngningar för att bekräfta korrekt inlämnade supportärenden inom följande målsatta svarstider, baserat på den allvarlighetsgrad du anger och som Wink rimligen bekräftar:

AllvarlighetsgradBeskrivningMålsatt första svar
Sev 1 — KritiskPartner-API:et är nere eller oanvändbart i produktion utan lösning.4 timmar
Sev 2 — StorViktig funktion är nedsatt eller försämrad; en lösning finns.1 arbetsdag
Sev 3 — MindreAllmänna frågor, mindre problem eller funktionsönskemål.2 arbetsdagar

Målsatta svarstider beskriver när Wink avser att ta första kontakt; de är inga garantier för lösningstid. Prioriterad support och allvarlighetsbaserade mål gäller på nivåer där de anges ingå.

Wink upprätthåller kommersiellt rimliga administrativa, tekniska och organisatoriska åtgärder för att skydda konfidentialitet, integritet och tillgänglighet för data som behandlas via Partner-API:et, och granskar dessa åtgärder regelbundet. Winks behandling av personuppgifter styrs av Integritetspolicyn och eventuella databehandlingsvillkor i Avtalet. Du ansvarar för att säkra dina egna API-uppgifter, för laglig användning av all data du hämtar och för att omedelbart meddela Wink om misstänkt kompromettering av uppgifter.

Servicekrediter är det enda och exklusiva medlet vid otillgänglighet eller uteblivet uppfyllande av Drifttidsåtagandet, och ges istället för annat ansvar som kan uppstå vid sådan brist. Om inte annat uttryckligen anges i detta SLA tillhandahålls Partner-API:et på en “som tillgänglig” basis. I den mån tillämplig lag tillåter det är Winks samlade ansvar som uppstår ur eller relaterar till Tjänsten begränsat enligt Avtalet, och Wink ansvarar inte för indirekta, tillfälliga, särskilda, följdskador eller straffskador, eller för förlorad vinst, intäkter, data eller goodwill, även om möjligheten till sådana skador har påpekats.

Detta SLA gäller så länge du har en aktiv Partner-API-prenumeration på en nivå där SLA anges gälla. Wink kan uppdatera detta SLA från tid till annan; väsentliga ändringar kommuniceras via en kanal som Wink normalt använder för kundkontakt, och fortsatt användning av Partner-API:et efter att en uppdatering trätt i kraft utgör godkännande av det uppdaterade SLA:et. Detta SLA upphör automatiskt vid uppsägning eller utgång av Avtalet eller din Partner-API-prenumeration. Avsnitt som av sin natur bör överleva uppsägning — inklusive intjänad men ej utnyttjad Servicekredit, ansvarsbegränsning och definitioner — gäller fortsatt.