Skip to content

Partner-API

Wink Partner-API er den autentiserte, høyere gjennomstrømningsmåten for integratorer å hente bookbart reiseinventar — det samme tilbudet som driver våre innebygde widgets og offentlige søkeendepunkter, eksponert som et førsteklasses programmert grensesnitt. Der de gratis Web Components og offentlige søkeendepunktene er ment for lettvekts, menneskevendt innbygging, er Partner-API bygget for systemer som søker, priser og booker i stor skala. Tilgang er autentisert per integrator og faktureres per bruk, så du betaler kun for trafikken du faktisk sender.

Bruk måles i hotellnetter: ett hotell priset for én natt opphold — ikke én API-forespørsel. Et søk som returnerer 20 hoteller for et 3-netters opphold er 60 hotellnetter fra én enkelt forespørsel. Content- og Lookup-kall (destinasjonssøk og autofullføring) er unntaket: hvert koster én enhet per kall, uansett hva det returnerer. Kontoendepunkter er gratis. Priser er sannhetskilden for satsene.

GratisBetaltEnterprise
Pris0 $BruksbasertKontakt oss
Best forEvaluering og lavvolumsintegrasjonerBetal-etter-bruk gjennomstrømning i stor skalaTilpasset volum og forhandlede vilkår
Enheter per måned10 000UbegrensetUbegrenset
API-responstid (P95)—Under 500 msUnder 500 ms
Pris per enhet (hotellnatt)Gratis0,0001 $Tilpasset
Respons ved månedlig kvote429 til 1. i neste måned (UTC)Fakturert, ikke blokkertEtter avtale
Tjenestenivåavtale—✓✓
Prioritert support—✓✓
Dedikert onboarding——✓

Få en API-nøkkel · Start målt fakturering · Kontakt salg

To grensesnitt betjener bookbart inventar, og de samsvarer med de to nivåene ovenfor:

Partner Integrator API er gRPC, ikke REST. Du kaller det med en generert klient over HTTP/2 på partner.wink.travel:443, med en bearer-token og kontoen du kaller for:

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

Referansesiden ovenfor dokumenterer hver tjeneste, melding og feilstatus, og skjemaet er også tilgjengelig i kjøretid gjennom serverrefleksjon, så grpcurl, Postman og Insomnia oppdager det uten noe å laste ned.

Hvis du heller vil generere en klient på forhånd, er .proto-kildefilene publisert på github.com/wink-travel/partner-api-proto.

Gratisnivået er designet for å la deg bygge, teste og kjøre moderat produksjonstrafikk uten kostnad.

  • Ingen publisert per-minutt-grense. Wink overvåker forespørselsrater og kan anvende rimelige bruksgrenser for å beskytte tjenesten. Hvis du mottar en HTTP 429 (For mange forespørsler), vent det antall sekunder som står i Retry-After-headeren før du prøver igjen.
  • Månedlig kvote — 10 000 enheter per kalendermåned. Kvoten gis per konto og nullstilles den 1. i hver måned (UTC). Når du når den, vil en konto som ikke er påmeldt betalt fakturering motta HTTP 429 til 1. i neste måned — en hard stopp, med Retry-After-header og en melding som inviterer deg til å abonnere på Betalt nivå. En påmeldt konto fortsetter å fungere og faktureres for bruk utover kvoten.

Gratisnivået inkluderer ikke tjenestenivåavtale eller prioritert support.

Betaltnivået fjerner den månedlige taket og fakturerer deg kun for det du bruker.

  • Målt hotellnetter — 0,0001 $ per hotellnatt. Det finnes ingen månedlig grense; du faktureres etter faktisk volum. Wink kan fortsatt anvende rimelige bruksgrenser for å beskytte tjenesten. Søke- og inventarkall faktureres per priset hotellnatt; Content- og Lookup-kall faktureres én enhet hver, så å samle forespørslene dine holder regningen nede.

Betaltnivået inkluderer tjenestenivåavtalen beskrevet nedenfor — en 99,9 % oppetidsforpliktelse og et P95-responstidsmål under 500 ms — og prioritert, alvorlighetsbasert support.

Ikrafttredelsesdato: 5. juli 2026 · Versjon 1.0

Denne tjenestenivåavtalen (SLA) fastsetter tilgjengelighetsforpliktelsen, tjenestekreditter og supportmål som Wink (“Wink”, “vi”, “oss”) gir til en kunde (“Kunde”, “du”) for det autentiserte Wink Partner-API-et (“Partner-API” eller “Tjenesten”) på nivåer hvor en SLA er angitt å gjelde. Denne SLA-en er innlemmet i og regulert av avtalen mellom deg og Wink som gir deg tilgang til Partner-API-et (“Avtalen”), og gjelder så lenge du opprettholder et aktivt, betalt Partner-API-abonnement i god stand. Store bokstaver som ikke er definert her, har betydningen gitt i Avtalen.

  1. “Oppetid” betyr perioder hvor Partner-API-et er tilgjengelig for å motta og svare vellykket på korrekt formede, autentiserte forespørsler.
  2. “Nedetid” betyr enhver periode, målt i minutter, hvor Partner-API-et ikke svarer vellykket på korrekt formede, autentiserte forespørsler, unntatt perioder som faller innenfor unntakene i seksjon 4. Isolerte feil som påvirker en uvesentlig andel av forespørsler er ikke i seg selv nedetid.
  3. “Månedlig oppetidsprosent” betyr, for en gitt kalendermåned, totalt antall minutter i måneden minus totalt antall nedetidsminutter, delt på totalt antall minutter i måneden, uttrykt i prosent.
  4. “Planlagt vedlikehold” betyr planlagt vedlikehold av Tjenesten som Wink har gitt forhåndsvarsel om i henhold til seksjon 4.
  5. “Tjenestekreditt” betyr en kreditt, beregnet som en prosentandel av gebyrene betalt eller betalbar av deg for Partner-API-et i den berørte kalendermåneden, som brukes mot fremtidige Partner-API-gebyrer som eneste og eksklusive erstatning for manglende oppfyllelse av oppetidsforpliktelsen.
  6. “Responstid” betyr tiden som går fra Wink mottar en korrekt formet, autentisert forespørsel ved Winks tjenestegrense til tidspunktet Wink begynner å returnere svaret, ekskludert nettverkstransitt og eventuell klienttid utenfor Winks kontroll.

2. Tilgjengelighets- og ytelsesforpliktelse

Section titled “2. Tilgjengelighets- og ytelsesforpliktelse”

Wink vil bruke kommersielt rimelige anstrengelser for å gjøre Partner-API-et tilgjengelig med en månedlig oppetidsprosent på minst 99,9 % i hver kalendermåned i avtaleperioden (“Oppetidsforpliktelsen”). Oppetidsforpliktelsen måles ved Winks tjenestegrense og ekskluderer faktorer utenfor Winks rimelige kontroll, inkludert de som er beskrevet i seksjon 4. Winks overvåkingssystemer er den autoritative kilden for måling av månedlig oppetidsprosent og responstid.

Wink har videre som mål en 95. persentil (P95) responstid under 500 millisekunder for vellykkede, korrekt formede, autentiserte forespørsler, målt ved Winks tjenestegrense over hver kalendermåned (“Ytelsesmålet”). Ytelsesmålet ekskluderer faktorene beskrevet i seksjon 4, forespørsler som returnerer applikasjonsnivåfeil forårsaket av selve forespørselen, og uvanlig store eller komplekse batch-forespørsler. Ytelsesmålet er et tjenestemål; tjenestekredittene i seksjon 3 gjelder for manglende oppfyllelse av Oppetidsforpliktelsen og er eneste og eksklusive erstatning for tilgjengelighetsmangler.

Hvis den månedlige oppetidsprosenten faller under oppetidsforpliktelsen i en kalendermåned, kan du ha rett til en tjenestekreditt beregnet som en prosentandel av Partner-API-gebyrene betalt eller betalbar av deg for den måneden, i henhold til følgende trapp:

Månedlig oppetidsprosentTjenestekreditt
Under 99,9 % men på eller over 99,0 %10 %
Under 99,0 % men på eller over 95,0 %25 %
Under 95,0 %50 %
  1. Krav om kreditt. For å motta en tjenestekreditt må du sende et skriftlig krav til Wink innen tretti (30) dager etter slutten av kalendermåneden hvor mangelen oppstod. Kravet må inkludere datoer og klokkeslett for hver nedetidshendelse du krever, samt eventuelle støttelogger eller bevis som er rimelig tilgjengelig for deg. Krav sendt etter denne fristen er ikke kvalifisert.
  2. Form for kreditt. Godkjente tjenestekreditter brukes mot fremtidige Partner-API-gebyrer og har ingen kontantverdi. De er ikke refusjoner og utbetales ikke med mindre det kreves av gjeldende lov.
  3. Maksimal kreditt. Totale tjenestekreditter tildelt for en enkelt kalendermåned vil ikke overstige 50 % av Partner-API-gebyrene betalt eller betalbar av deg for den måneden.
  4. Eneste og eksklusive erstatning. Tjenestekreditter er din eneste og eksklusive erstatning for enhver manglende oppfyllelse av oppetidsforpliktelsen eller annen tilgjengelighetsmangel ved Partner-API-et.

Oppetidsforpliktelsen og eventuelle tjenestekreditter gjelder ikke, og nedetid inkluderer ikke, noen utilgjengelighet, suspensjon, degradering eller ytelsesproblem som oppstår fra eller relaterer til:

  1. Planlagt vedlikehold som Wink har gitt forhåndsvarsel om, forutsatt at slikt varsel gis med rimelig varsel via en kanal Wink normalt bruker for å kommunisere med kunder;
  2. Force majeure-hendelser eller andre årsaker utenfor Winks rimelige kontroll, inkludert naturkatastrofer, myndighetshandlinger, nettverks- eller strømbrudd, og tjenestenekt- eller andre ondsinnede angrep;
  3. problemer forårsaket av dine handlinger eller unnlatelser, ditt utstyr, programvare eller nettverk, eller av en hvilken som helst tredjeparts tjeneste, produkt eller leverandør som ikke er under Winks direkte kontroll;
  4. ditt misbruk av tjenesten eller brudd på avtalen, denne SLA-en, akseptable bruksvilkår eller gjeldende ratebegrensninger, inkludert trafikk som Wink med rimelighet anser som overdreven, automatisert misbruk eller svindel; og
  5. enhver suspensjon eller oppsigelse av din tilgang som er korrekt gjennomført i henhold til avtalen, inkludert suspensjon ved manglende betaling.

Wink tilbyr support for Partner-API-et i ordinær arbeidstid, unntatt lokale helligdager. Wink vil bruke kommersielt rimelige anstrengelser for å bekrefte mottak av korrekt innsendte supporthenvendelser innen følgende målresponstider, basert på alvorlighetsgrad du angir og Wink med rimelighet bekrefter:

AlvorlighetsgradBeskrivelseMål for første respons
Sev 1 — KritiskPartner-API er nede eller ubrukelig i produksjon uten løsning.4 timer
Sev 2 — AlvorligViktig funksjon er svekket eller degradert; en løsning finnes.1 virkedag
Sev 3 — MindreGenerelle spørsmål, mindre problemer eller funksjonsforespørsler.2 virkedager

Målresponstider beskriver når Wink sikter på å ta første kontakt; de er ikke garantier for løsningstid. Prioritert support og alvorlighetsbaserte mål gjelder på nivåer hvor de er angitt å være inkludert.

Wink opprettholder kommersielt rimelige administrative, tekniske og organisatoriske tiltak designet for å beskytte konfidensialitet, integritet og tilgjengelighet av data behandlet gjennom Partner-API-et, og gjennomgår disse tiltakene periodisk. Winks behandling av personopplysninger reguleres av Personvernerklæringen og eventuelle databehandlingsvilkår i avtalen. Du er ansvarlig for å sikre dine egne API-legitimasjoner, for lovlig bruk av data du henter, og for å varsle Wink raskt om mistenkt kompromittering av legitimasjoner.

Tjenestekreditter er den eneste og eksklusive erstatning for utilgjengelighet eller manglende oppfyllelse av oppetidsforpliktelsen, og gis i stedet for ethvert annet ansvar som oppstår fra slik manglende oppfyllelse. Med mindre uttrykkelig angitt i denne SLA-en, leveres Partner-API-et “som tilgjengelig”. I den grad gjeldende lov tillater det, er Winks samlede ansvar knyttet til tjenesten begrenset som angitt i avtalen, og Wink er ikke ansvarlig for indirekte, tilfeldige, spesielle, følgeskader eller straffeskader, eller for tapt fortjeneste, inntekter, data eller goodwill, selv om det er gitt beskjed om muligheten for slike skader.

Denne SLA-en gjelder så lenge du har et aktivt Partner-API-abonnement på et nivå hvor SLA er angitt å gjelde. Wink kan oppdatere denne SLA-en fra tid til annen; vesentlige endringer vil bli kommunisert via en kanal Wink normalt bruker for å nå kunder, og fortsatt bruk av Partner-API-et etter at en oppdatering trer i kraft utgjør aksept av den oppdaterte SLA-en. Denne SLA-en opphører automatisk ved oppsigelse eller utløp av avtalen eller ditt Partner-API-abonnement. Seksjoner som etter sin natur bør overleve oppsigelse — inkludert opptjent, men ikke krevd tjenestekredittberettigelse, ansvarsbegrensning og definisjoner — overlever.