Partner API

Ang Wink Partner API ay ang authenticated, mas mataas na throughput na paraan para sa mga integrator upang mag-query ng bookable travel inventory — ang parehong supply na nagpapatakbo sa aming mga embeddable widgets at public browse endpoints, na inilalantad bilang isang first-class na programmatic interface. Kung saan ang libreng Web Components at public browse endpoints ay para sa magaan, human-facing embedding, ang Partner API ay ginawa para sa mga sistema na naghahanap, nagpepresyo, at nagbu-book sa malaking sukat. Ang access ay authenticated bawat integrator at sinisingil batay sa paggamit, kaya babayaran mo lamang ang trapiko na talagang ipinapadala mo.

Mga Plano at Presyo

Ang paggamit ay sinusukat sa hotel-nights: isang hotel na pinresyohan para sa isang gabi ng pananatili — hindi isang API call. Ang isang paghahanap na nagbabalik ng 20 hotel para sa 3-gabing pananatili ay 60 hotel-nights mula sa isang request. Ang Content at Lookup (paghahanap ng destinasyon at autocomplete) na mga tawag ay eksepsyon: bawat isa ay nagkakahalaga ng isang unit bawat tawag, kahit ano pa ang ibalik nito. Libre ang mga account endpoints. Ang Presyo ang pinagmumulan ng katotohanan para sa rate.

	Libre	Bayad	Enterprise
Presyo	$0	Batay sa paggamit	Makipag-ugnayan sa amin
Pinakamainam para sa	Pagsusuri at mababang dami ng integrasyon	Pay-as-you-go throughput sa malaking sukat	Custom na dami at napagkasunduang mga termino
Mga yunit bawat buwan	10,000	Walang limitasyon	Walang limitasyon
Oras ng tugon ng API (P95)	—	Mas mababa sa 500 ms	Mas mababa sa 500 ms
Presyo bawat yunit (hotel-night)	Libre	$0.0001	Custom
Tugon sa buwanang allowance	429 hanggang sa unang araw ng susunod na buwan (UTC)	Sinisingil, hindi hinaharangan	Ayon sa kasunduan
Service Level Agreement	—	✓	✓
Priority support	—	✓	✓
Dedicated onboarding	—	—	✓

Kumuha ng API key · Simulan ang metered billing · Makipag-ugnayan sa sales

Sanggunian ng API

Dalawang surface ang nagsisilbi sa bookable inventory, at tumutugma ito sa dalawang tier sa itaas:

• Libre — Consumer / Booking Engine API (REST, /api/public/**): anonymous, browser- at widget-facing. I-browse ang Booking Engine reference →
• Bayad — Partner Integrator API (gRPC, wink.partner.v1): authenticated, usage-metered, ginawa para sa server-to-server integration sa malaking sukat. I-browse ang Integrator reference →

Ang Partner Integrator API ay gRPC, hindi REST. Tatawagan mo ito gamit ang generated client sa HTTP/2 sa partner.wink.travel:443, na nagpapasa ng bearer token at ang account na tinatawagan mo:

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

Ang reference page sa itaas ay nagdodokumento ng bawat serbisyo, mensahe at error status, at ang schema ay available din sa runtime sa pamamagitan ng server reflection, kaya grpcurl, Postman at Insomnia ay natutuklasan ito nang walang kailangang i-download.

Kung nais mong gumawa ng client nang maaga, ang mga .proto source files ay inilathala sa github.com/wink-travel/partner-api-proto.

Paano gumagana ang paggamit at mga limitasyon

Libreng tier

Ang Libreng tier ay idinisenyo upang payagan kang bumuo, mag-test, at magpatakbo ng katamtamang production traffic nang walang bayad.

• Walang inilathalang limitasyon kada minuto. Binabantayan ng Wink ang mga rate ng request at maaaring magpatupad ng fair-use limits upang protektahan ang serbisyo. Kung makatanggap ka ng HTTP 429 (Too Many Requests), maghintay ng bilang ng segundo na nasa Retry-After header bago subukang muli.
• Buwanang allowance — 10,000 yunit bawat kalendaryong buwan. Ang allowance ay ibinibigay bawat account at nire-reset sa unang araw ng bawat buwan (UTC). Kapag naabot mo ito, ang account na hindi naka-enroll sa pay-as-you-go billing ay makakatanggap ng HTTP 429 hanggang sa unang araw ng susunod na buwan — isang hard stop, na may Retry-After header at mensaheng nag-aanyaya sa iyo na mag-subscribe sa Bayad na tier. Ang naka-enroll na account ay patuloy na gagana at sisingilin para sa paggamit lampas sa allowance.

Ang Libreng tier ay hindi kasama ang Service Level Agreement o priority support.

Bayad na tier

Ang Bayad na tier ay nag-aalis ng buwanang limitasyon at sinisingil ka lamang para sa aktwal na paggamit.

• Metered hotel-nights — $0.0001 bawat hotel-night. Walang buwanang limitasyon; sinisingil ka batay sa aktwal na dami. Maaaring magpatupad pa rin ang Wink ng fair-use limits upang protektahan ang serbisyo. Ang mga tawag sa paghahanap at imbentaryo ay sinisingil bawat hotel-night na pinresyohan; ang Content at Lookup calls ay sinisingil ng isang yunit bawat isa, kaya ang pag-batch ng iyong mga request ay nakababawas sa singil.

Kasama sa Bayad na tier ang Service Level Agreement na inilalarawan sa ibaba — isang 99.9% uptime commitment at P95 response-time target na mas mababa sa 500 ms — at priority, severity-based support.

Service Level Agreement

Petsa ng bisa: 5 Hulyo 2026 · Bersyon 1.0

Itinatakda ng Service Level Agreement na ito (ang “SLA”) ang commitment sa availability, service credits, at mga target ng suporta na ibinibigay ng Wink (“Wink”, “kami”, “amin”) sa isang customer (“Customer”, “ikaw”) para sa authenticated na Wink Partner API (ang “Partner API” o “Serbisyo”) sa mga tier kung saan sinasabi na may SLA. Ang SLA na ito ay bahagi ng at pinamamahalaan ng kasunduan sa pagitan mo at ng Wink kung saan mo ina-access ang Partner API (ang “Kasunduan”), at nalalapat hangga’t pinananatili mo ang isang aktibo, bayad na Partner API subscription na nasa mabuting katayuan. Ang mga capitalized na termino na hindi tinukoy dito ay may kahulugang ibinigay sa Kasunduan.

1. Mga Kahulugan

1. “Uptime” ay nangangahulugang mga panahon kung kailan ang Partner API ay available upang tanggapin at matagumpay na tumugon sa maayos na pormadong, authenticated na mga request.
2. “Downtime” ay anumang panahon, sinusukat sa minuto, kung kailan ang Partner API ay nabibigo na matagumpay na tumugon sa maayos na pormadong, authenticated na mga request, hindi kasama ang anumang panahon na sakop ng mga Exclusions na inilalahad sa Seksyon 4. Ang mga isolated na error na nakakaapekto sa maliit na bahagi ng mga request ay hindi, sa kanilang sarili, Downtime.
3. “Monthly Uptime Percentage” ay nangangahulugang, para sa isang kalendaryong buwan, ang kabuuang bilang ng mga minuto sa buwan na iyon minus ang kabuuang Downtime minuto, hinati sa kabuuang bilang ng mga minuto sa buwan na iyon, na ipinapahayag bilang porsyento.
4. “Scheduled Maintenance” ay nangangahulugang planadong maintenance ng Serbisyo kung saan ang Wink ay nagbigay ng paunang abiso alinsunod sa Seksyon 4.
5. “Service Credit” ay nangangahulugang isang credit, na kinakalkula bilang porsyento ng mga bayad o babayaran mo para sa Partner API sa apektadong kalendaryong buwan, na inilalapat laban sa mga susunod na bayarin sa Partner API bilang tanging lunas para sa kabiguan na matugunan ang Uptime Commitment.
6. “Response Time” ay nangangahulugang ang lumipas na oras mula sa pagtanggap ng Wink ng maayos na pormadong, authenticated na request sa hangganan ng serbisyo ng Wink hanggang sa puntong nagsisimula ang Wink na ibalik ang tugon, hindi kasama ang network transit at anumang oras sa client-side na wala sa kontrol ng Wink.

2. Commitment sa Availability at Performance

Gagamit ang Wink ng komersyal na makatwirang pagsisikap upang gawing available ang Partner API sa isang Monthly Uptime Percentage na hindi bababa sa 99.9% sa bawat kalendaryong buwan ng termino (ang “Uptime Commitment”). Sinusukat ang Uptime Commitment sa hangganan ng serbisyo ng Wink at hindi kasama ang anumang mga salik na wala sa makatwirang kontrol ng Wink, kabilang ang mga inilalarawan sa Seksyon 4. Ang mga sistema ng pagmamanman ng Wink ang opisyal na pinagmumulan ng tala para sa pagsukat ng Monthly Uptime Percentage at Response Time.

Nagtatakda rin ang Wink ng 95th-percentile (P95) Response Time na mas mababa sa 500 milliseconds para sa matagumpay, maayos na pormadong, authenticated na mga request, sinusukat sa hangganan ng serbisyo ng Wink sa bawat kalendaryong buwan (ang “Performance Target”). Hindi kasama sa Performance Target ang mga salik na inilalarawan sa Seksyon 4, mga request na nagbabalik ng application-level errors na sanhi ng mismong request, at hindi pangkaraniwan na malalaki o kumplikadong batch requests. Ang Performance Target ay isang layunin ng serbisyo; ang mga Service Credit sa Seksyon 3 ay nalalapat sa mga kabiguan na matugunan ang Uptime Commitment at ang tanging lunas para sa mga kakulangan sa availability.

3. Service Credits

Kung ang Monthly Uptime Percentage ay bumaba sa ibaba ng Uptime Commitment sa anumang kalendaryong buwan, maaari kang maging karapat-dapat sa isang Service Credit na kinakalkula bilang porsyento ng mga bayad o babayaran mo para sa Partner API sa buwan na iyon, ayon sa sumusunod na talaan:

Monthly Uptime Percentage	Service Credit
Mas mababa sa 99.9% ngunit nasa o higit sa 99.0%	10%
Mas mababa sa 99.0% ngunit nasa o higit sa 95.0%	25%
Mas mababa sa 95.0%	50%

1. Pag-claim ng credit. Upang makatanggap ng Service Credit, dapat kang magsumite ng nakasulat na claim sa Wink sa loob ng tatlumpung (30) araw mula sa katapusan ng kalendaryong buwan kung kailan nangyari ang kakulangan. Dapat isama sa claim ang mga petsa at oras ng bawat insidente ng Downtime na inaangkin mo at anumang sumusuportang mga log o ebidensyang makatwirang magagamit sa iyo. Ang mga claim na isinumite pagkatapos ng panahong ito ay hindi karapat-dapat.
2. Porma ng credit. Ang mga aprubadong Service Credit ay inilalapat laban sa mga susunod na bayarin sa Partner API at walang halaga sa pera. Hindi ito mga refund at hindi babayaran maliban kung kinakailangan ng naaangkop na batas.
3. Pinakamataas na credit. Ang kabuuang Service Credits na iginawad para sa anumang isang kalendaryong buwan ay hindi lalampas sa 50% ng mga bayad o babayaran mo para sa Partner API sa buwan na iyon.
4. Tanging lunas. Ang mga Service Credit ay ang iyong tanging lunas para sa anumang kabiguan ng Wink na matugunan ang Uptime Commitment o anumang iba pang kakulangan sa availability ng Partner API.

4. Mga Eksepsyon

Ang Uptime Commitment at anumang nagresultang Service Credits ay hindi nalalapat, at ang Downtime ay hindi kasama, ang anumang kawalan ng availability, suspensyon, pagbaba ng kalidad, o isyu sa performance na nagmumula o may kaugnayan sa:

1. Scheduled Maintenance kung saan ang Wink ay nagbigay ng paunang abiso, basta ang abiso ay ibinigay nang makatwirang maaga sa pamamagitan ng channel na karaniwang ginagamit ng Wink upang makipag-ugnayan sa mga customer;
2. mga pangyayaring force majeure o iba pang mga sanhi na wala sa makatwirang kontrol ng Wink, kabilang ang mga natural na kalamidad, mga kilos ng gobyerno, pagkabigo ng network o utility, at denial-of-service o iba pang malisyosong pag-atake;
3. mga isyu na sanhi ng mga kilos o kapabayaan ng iyong bahagi, iyong kagamitan, software, o network, o ng anumang third-party na serbisyo, produkto, o provider na hindi direktang kontrolado ng Wink;
4. ang iyong pang-aabuso sa Serbisyo o paglabag sa Kasunduan, SLA na ito, mga tuntunin ng katanggap-tanggap na paggamit, o mga naaangkop na limitasyon sa rate, kabilang ang trapikong makatwirang tinutukoy ng Wink bilang labis, automated abuse, o pandaraya; at
5. anumang suspensyon o pagwawakas ng iyong access na maayos na isinagawa alinsunod sa Kasunduan, kabilang ang suspensyon dahil sa hindi pagbabayad.

5. Mga Target sa Suporta at Tugon

Nagbibigay ang Wink ng suporta para sa Partner API sa karaniwang oras ng negosyo, hindi kasama ang mga lokal na pampublikong pista opisyal. Gagamit ang Wink ng komersyal na makatwirang pagsisikap upang kilalanin ang maayos na naisumite na mga kahilingan sa suporta sa loob ng mga sumusunod na target na oras ng tugon, batay sa severity na iyong itinalaga at makatwirang kinumpirma ng Wink:

Severity	Paglalarawan	Target na unang tugon
Sev 1 — Kritikal	Ang Partner API ay bumaba o hindi magamit sa produksyon nang walang workaround.	4 na oras
Sev 2 — Malaki	Malaking bahagi ng feature ang naapektuhan o bumaba ang kalidad; may workaround.	1 araw ng negosyo
Sev 3 — Maliit	Pangkalahatang mga tanong, maliliit na isyu, o mga kahilingan sa feature.	2 araw ng negosyo

Ang mga target na oras ng tugon ay naglalarawan kung kailan nilalayon ng Wink na makipag-ugnayan sa unang pagkakataon; hindi ito garantiya ng oras ng resolusyon. Ang priority support at severity-based na mga target ay nalalapat sa mga tier kung saan sinasabi na kasama ito.

6. Data at Seguridad

Pinananatili ng Wink ang komersyal na makatwirang mga administratibo, teknikal, at organisasyonal na hakbang na idinisenyo upang protektahan ang pagiging kumpidensyal, integridad, at availability ng data na pinoproseso sa pamamagitan ng Partner API, at nire-review ang mga hakbang na ito pana-panahon. Ang pagproseso ng Wink ng personal na data ay pinamamahalaan ng Privacy Policy at anumang mga termino sa pagproseso ng data sa Kasunduan. Mananatili kang responsable sa pag-secure ng iyong sariling mga kredensyal sa API, para sa legal na paggamit ng anumang data na iyong makukuha, at para sa agarang pag-abiso sa Wink ng anumang pinaghihinalaang kompromiso ng kredensyal.

7. Limitasyon ng Pananagutan

Ang mga Service Credit ay ang tanging lunas para sa anumang kawalan ng availability o kabiguan na matugunan ang Uptime Commitment, at ibinibigay bilang kapalit ng anumang iba pang pananagutan na nagmumula sa naturang kabiguan. Maliban kung tahasang nakasaad sa SLA na ito, ang Partner API ay ibinibigay “as available”. Sa pinakamalawak na saklaw na pinapayagan ng naaangkop na batas, ang kabuuang pananagutan ng Wink na nagmumula o may kaugnayan sa Serbisyo ay limitado ayon sa itinakda sa Kasunduan, at hindi mananagot ang Wink para sa anumang hindi direktang, incidental, espesyal, consequential, o punitive damages, o para sa nawalang kita, kita, data, o goodwill, kahit na naabisuhan tungkol sa posibilidad ng mga naturang pinsala.

8. Termino, Mga Pagbabago at Pagwawakas

Ang SLA na ito ay nalalapat hangga’t mayroon kang aktibong Partner API subscription sa tier kung saan sinasabi na nalalapat ang SLA. Maaaring i-update ng Wink ang SLA na ito paminsan-minsan; ang mga mahahalagang pagbabago ay ipapaalam sa pamamagitan ng channel na karaniwang ginagamit ng Wink upang maabot ang mga customer, at ang patuloy na paggamit ng Partner API pagkatapos magkabisa ang update ay nangangahulugang pagtanggap sa na-update na SLA. Ang SLA na ito ay awtomatikong nagtatapos kapag nagwakas o nag-expire ang Kasunduan o ang iyong Partner API subscription. Ang mga seksyon na ayon sa kanilang kalikasan ay dapat manatili pagkatapos ng pagwawakas — kabilang ang naipon ngunit hindi na-claim na karapatan sa Service Credit, limitasyon ng pananagutan, at mga kahulugan — ay mananatili.