Партньорско API

Wink Партньорско API е удостоверен, с по-висок капацитет начин за интегратори да заявяват налично за резервация туристическо съдържание — същият ресурс, който захранва нашите вградими джаджи и публични крайни точки за разглеждане, предоставен като първокласен програмируем интерфейс. Докато безплатните Web Components и публичните крайни точки за разглеждане са предназначени за леки, насочени към човека вграждания, Партньорското API е създадено за системи, които търсят, ценообразуват и резервират в мащаб. Достъпът е удостоверен за всеки интегратор и се таксува според използването, така че плащате само за трафика, който действително изпращате.

Планове и ценообразуване

Използването се измерва в нощувки в хотел: един хотел, ценообразуван за една нощувка — не за едно API повикване. Търсене, което връща 20 хотела за 3 нощувки, е 60 нощувки от една заявка. Извикванията за съдържание и търсене (търсене на дестинация и автодовършване) са изключение: всяко струва по една единица на повикване, независимо какво връща. Крайни точки за акаунти са безплатни. Ценообразуването е източникът на истината за тарифата.

	Безплатно	Платено	Корпоративно
Цена	$0	Според използването	Свържете се с нас
Подходящо за	Оценка и интеграции с нисък обем	Плащане според използването в мащаб	Персонализиран обем и договорени условия
Единици на месец	10,000	Неограничено	Неограничено
Време за отговор на API (P95)	—	Под 500 ms	Под 500 ms
Цена на единица (нощувка в хотел)	Безплатно	$0.0001	Персонализирано
Отговор при месечния лимит	429 до 1-во число на следващия месец (UTC)	Таксуване, без блокиране	Според споразумение
Споразумение за ниво на обслужване	—	✓	✓
Приоритетна поддръжка	—	✓	✓
Посветено въвеждане	—	—	✓

Вземете API ключ · Започнете таксуване според използването · Свържете се с продажбите

API справочник

Два интерфейса обслужват наличното за резервация съдържание и съответстват на двата горни плана:

Безплатно — Потребителско / API на Резервационния двигател (REST, /api/public/**): анонимно, насочено към браузър и джаджи. Разгледайте справочника на Резервационния двигател →
Платено — Партньорско интеграторско API (gRPC, wink.partner.v1): удостоверено, с измерено използване, създадено за интеграция сървър към сървър в мащаб. Разгледайте справочника за интегратори →

Партньорското интеграторско API е gRPC, не REST. Извиквате го с генериран клиент през HTTP/2 на partner.wink.travel:443, като подавате bearer token и акаунта, за който правите заявката:

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

Горната справочна страница документира всяка услуга, съобщение и статус на грешка, а схемата е налична и по време на изпълнение чрез сървърна рефлексия, така че grpcurl, Postman и Insomnia я откриват без нужда от изтегляне.

Ако предпочитате да генерирате клиент предварително, .proto изходните файлове са публикувани на github.com/wink-travel/partner-api-proto.

Как работят използването и ограниченията

Безплатен план

Безплатният план е предназначен да ви позволи да изграждате, тествате и управлявате умерен производствен трафик без разходи.

Няма публикуван лимит на повикванията в минута. Wink следи честотата на заявките и може да приложи ограничения за справедливо използване, за да защити услугата. Ако получите HTTP 429 (Твърде много заявки), изчакайте броя секунди, посочен в заглавката Retry-After, преди да опитате отново.
Месечен лимит — 10,000 единици на календарен месец. Лимитът се предоставя на акаунт и се нулира на 1-во число всеки месец (UTC). След достигане на лимита, акаунт, който не е записан за таксуване според използването, получава HTTP 429 до 1-во число на следващия месец — твърдо спиране, с Retry-After заглавка и съобщение, което ви кани да се абонирате за Платения план. Записан акаунт продължава да работи и се таксува за използване над лимита.

Безплатният план не включва Споразумение за ниво на обслужване или приоритетна поддръжка.

Платен план

Платеният план премахва месечния таван и ви таксува само за това, което използвате.

Измерени нощувки в хотел — $0.0001 на нощувка. Няма месечен таван; таксувате се според реалния обем. Wink може все пак да приложи ограничения за справедливо използване, за да защити услугата. Търсенията и извикванията за наличност се таксуват на база ценообразувани нощувки; извикванията за съдържание и търсене се таксуват по една единица всяко, така че групирането на заявките намалява сметката.

Платеният план включва Споразумението за ниво на обслужване, описано по-долу — ангажимент за 99.9% време на работа и цел за време за отговор P95 под 500 ms — и приоритетна поддръжка, базирана на сериозността.

Споразумение за ниво на обслужване

В сила от: 5 юли 2026 · Версия 1.0

Това Споразумение за ниво на обслужване (SLA) определя ангажимента за наличност, кредити за услуга и цели за поддръжка, които Wink („Wink“, „ние“, „нас“) предоставя на клиент („Клиент“, „вие“) за удостовереното Партньорско API на Wink („Партньорско API“ или „Услугата“) на планове, за които е посочено, че SLA се прилага. Това SLA е включено в и се управлява от споразумението между вас и Wink, по силата на което имате достъп до Партньорското API („Споразумението“), и важи докато поддържате активен, платен абонамент за Партньорско API в добро състояние. Термини с главни букви, които не са дефинирани тук, имат значението, дадено им в Споразумението.

1. Дефиниции

„Време на работа“ означава периодите, през които Партньорското API е достъпно за приемане и успешно отговаряне на правилно формирани, удостоверени заявки.
„Време на прекъсване“ означава всеки период, измерен в минути, през който Партньорското API не успява да отговори успешно на правилно формирани, удостоверени заявки, с изключение на периоди, попадащи в изключенията, описани в Раздел 4. Изолирани грешки, засягащи незначителна част от заявките, сами по себе си не се считат за Време на прекъсване.
„Месечен процент време на работа“ означава за даден календарен месец общия брой минути в месеца минус общото време на прекъсване в минути, разделено на общия брой минути в месеца, изразено като процент.
„Планирана поддръжка“ означава планирана поддръжка на Услугата, за която Wink е предоставил предварително известие съгласно Раздел 4.
„Кредит за услуга“ означава кредит, изчислен като процент от таксите, платени или дължими от вас за Партньорското API през засегнатия календарен месец, който се прилага към бъдещи такси за Партньорското API като единствено и изключително средство за обезщетение при неизпълнение на ангажимента за време на работа.
„Време за отговор“ означава изминалото време между получаването от Wink на правилно формирана, удостоверена заявка на границата на услугата на Wink и момента, в който Wink започва да връща отговора, без да се включва времето за мрежов трансфер и всяко време на клиентската страна извън контрола на Wink.

2. Ангажимент за наличност и производителност

Wink ще полага търговски разумни усилия да направи Партньорското API достъпно с Месечен процент време на работа поне 99.9% през всеки календарен месец от срока („Ангажимент за време на работа“). Ангажиментът за време на работа се измерва на границата на услугата на Wink и изключва фактори извън разумния контрол на Wink, включително описаните в Раздел 4. Системите за мониторинг на Wink са авторитетният източник за измерване на Месечния процент време на работа и Времето за отговор.

Wink също така цели 95-ти перцентил (P95) време за отговор под 500 милисекунди за успешни, правилно формирани, удостоверени заявки, измерено на границата на услугата на Wink през всеки календарен месец („Цел за производителност“). Целта за производителност изключва факторите, описани в Раздел 4, заявки, които връщат грешки на ниво приложение, причинени от самата заявка, и необичайно големи или сложни пакетни заявки. Целта за производителност е цел на услугата; Кредитите за услуга в Раздел 3 се прилагат при неизпълнение на Ангажимента за време на работа и са единственото и изключително средство за обезщетение при недостъпност.

3. Кредити за услуга

Ако Месечният процент време на работа падне под Ангажимента за време на работа през някой календарен месец, може да имате право на Кредит за услуга, изчислен като процент от таксите за Партньорското API, платени или дължими от вас за този месец, според следната скала:

Месечен процент време на работа	Кредит за услуга
Под 99.9%, но не по-нисък от 99.0%	10%
Под 99.0%, но не по-нисък от 95.0%	25%
Под 95.0%	50%

Искане на кредит. За да получите Кредит за услуга, трябва да подадете писмено искане до Wink в рамките на тридесет (30) дни след края на календарния месец, в който е настъпило недостигането. Искането трябва да включва дати и часове на всеки инцидент на Време на прекъсване, за който претендирате, както и всякакви налични логове или доказателства. Искания, подадени след този срок, не са допустими.
Форма на кредита. Одобрените Кредити за услуга се прилагат към бъдещи такси за Партньорското API и нямат парична стойност. Те не са възстановяване на суми и няма да бъдат изплащани, освен ако не е изисквано от приложимото законодателство.
Максимален кредит. Общата сума на Кредитите за услуга за един календарен месец няма да надвишава 50% от таксите за Партньорското API, платени или дължими от вас за този месец.
Единствено и изключително средство за обезщетение. Кредитите за услуга са вашето единствено и изключително средство за обезщетение при неизпълнение от страна на Wink на Ангажимента за време на работа или при всяко друго недостъпност на Партньорското API.

4. Изключения

Ангажиментът за време на работа и евентуалните Кредити за услуга не се прилагат, а Времето на прекъсване не включва, всяка недостъпност, спиране, влошаване или проблем с производителността, произтичащи от или свързани с:

Планирана поддръжка, за която Wink е дал предварително известие, при условие че такова известие е предоставено с разумен предварителен срок чрез канал, който Wink обичайно използва за комуникация с клиенти;
Събития от форсмажорен характер или други причини извън разумния контрол на Wink, включително природни бедствия, действия на правителството, прекъсвания на мрежи или услуги, и атаки тип отказ от услуга или други злонамерени действия;
проблеми, причинени от ваши действия или пропуски, вашето оборудване, софтуер или мрежа, или от всяка третата страна услуга, продукт или доставчик, който не е под пряк контрол на Wink;
вашето злоупотреба с Услугата или нарушение на Споразумението, това SLA, правилата за приемливо използване или приложимите ограничения на честотата, включително трафик, който Wink разумно определя като прекомерен, автоматизирана злоупотреба или измама; и
всяко спиране или прекратяване на вашия достъп, правилно осъществено съгласно Споразумението, включително спиране за неплащане.

5. Поддръжка и цели за отговор

Wink предоставя поддръжка за Партньорското API през стандартното работно време, с изключение на местни официални празници. Wink ще полага търговски разумни усилия да потвърди получаването на правилно подадени заявки за поддръжка в следните целеви времена за отговор, базирани на сериозността, която вие зададете и Wink разумно потвърди:

Сериозност	Описание	Целеви първоначален отговор
Sev 1 — Критична	Партньорското API е недостъпно или неизползваемо в продукция без заобиколно решение.	4 часа
Sev 2 — Основна	Значително нарушена или влошена функционалност; има заобиколно решение.	1 работен ден
Sev 3 — Незначителна	Общи въпроси, дребни проблеми или заявки за функции.	2 работни дни

Целевите времена за отговор описват кога Wink се стреми да осъществи първоначален контакт; те не гарантират време за разрешаване. Приоритетната поддръжка и целите, базирани на сериозността, се прилагат на планове, за които е посочено, че са включени.

6. Данни и сигурност

Wink поддържа търговски разумни административни, технически и организационни мерки, предназначени да защитят поверителността, цялостта и наличността на данните, обработвани чрез Партньорското API, и преглежда тези мерки периодично. Обработката на лични данни от Wink се управлява от Политиката за поверителност и всички условия за обработка на данни в Споразумението. Вие оставате отговорни за защитата на собствените си API идентификационни данни, за законното използване на всички данни, които извличате, и за своевременното уведомяване на Wink при подозрение за компрометиране на идентификационните данни.

7. Ограничение на отговорността

Кредитите за услуга са единственото и изключително средство за обезщетение при всяка недостъпност или неизпълнение на Ангажимента за време на работа и се предоставят вместо всякаква друга отговорност, произтичаща от такова неизпълнение. С изключение на изрично посоченото в това SLA, Партньорското API се предоставя „както е“. До максималната степен, разрешена от приложимото законодателство, общата отговорност на Wink, произтичаща от или свързана с Услугата, е ограничена както е посочено в Споразумението, и Wink не носи отговорност за косвени, случайни, специални, последващи или наказателни щети, или за загуба на печалби, приходи, данни или добра воля, дори ако е бил уведомен за възможността от такива щети.

8. Срок, промени и прекратяване

Това SLA важи докато имате активен абонамент за Партньорско API на план, за който е посочено, че SLA се прилага. Wink може да актуализира това SLA от време на време; съществени промени ще бъдат съобщени чрез канал, който Wink обичайно използва за комуникация с клиенти, а продължаването на използването на Партньорското API след влизане в сила на актуализацията означава приемане на обновеното SLA. Това SLA се прекратява автоматично при прекратяване или изтичане на Споразумението или на вашия абонамент за Партньорско API. Раздели, които по своята същност трябва да останат в сила след прекратяване — включително натрупаната, но непотърсена възможност за Кредит за услуга, ограничението на отговорността и дефинициите — остават в сила.