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

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

Планове и цени

Едно API повикване = една заявка. Използването се измерва и таксува на всеки 1 000 заявки.

	Безплатно	Платено	Корпоративно
Цена	$0	Според използването	Свържете се с нас
Подходящо за	Оценка и интеграции с нисък обем	Плащане според използването в мащаб	Персонализиран обем и договорени условия
Заявки в минута	30 (60 пик)	Неограничено	Неограничено
Заявки на месец	10 000	Неограничено	Неограничено
Време за отговор на API (P95)	—	Под 500 ms	Под 500 ms
Цена на 1 000 заявки	Безплатно	$1.00	Персонализирано
Надвишение на съотношението търсения към резервации (на 1 000 над 5 000:1)	—	$2.00	Персонализирано
Отговор при ограничение на честотата	429 (пауза / месечен твърд стоп)	Няма	Няма
Споразумение за ниво на обслужване	—	✓	✓
Приоритетна поддръжка	—	✓	✓
Посветено въвеждане	—	—	✓

Вземете 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.

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

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

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

Ограничение на честотата — 30 заявки в минута, с пик до 60 заявки. Кратки пикове над устойчивата скорост се поемат от разрешения пик. Ако го превишите, API отговаря с HTTP 429 (Твърде много заявки) и прилага 5-минутна пауза преди ключът ви да възобнови обслужването. Изчакайте и опитайте отново след паузата, вместо да претоварвате крайния пункт.
Месечна квота — 10 000 заявки на календарен месец. След достигане на месечния лимит, API връща HTTP 429 за остатъка от месеца — твърд стоп — заедно с съобщение, което ви кани да се абонирате за Платения план, за да продължите. Броячът се нулира в началото на следващия календарен месец.

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

Платен план

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

Таксуване на заявки — $1.00 на 1 000 заявки. Няма месечен лимит на заявките и няма ограничение на честотата при нормална употреба; таксувате се според реалния обем.
Надвишение на съотношението търсения към резервации — $2.00 на 1 000 излишни търсения. За да поддържаме здравословен ресурс, измерваме съотношението на търсения (“търсения”) към потвърдени резервации. Имате право на 5 000 търсения на резервация преди да се приложи надвишението. Излишните търсения се изчисляват като:

излишък = max(0, търсения − резервации × 5 000)

Надвишението се таксува с $2.00 на 1 000 излишни търсения. Интеграции с добра конверсия рядко имат надвишения; таксата се прилага само за трафик, който търси много повече, отколкото резервира.

Платеният план включва Споразумението за ниво на обслужване, описано по-долу — ангажимент за 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 разумно потвърди:

Сериозност	Описание	Целеви първоначален отговор
Сев 1 — Критично	Партньорското API е недостъпно или неизползваемо в продукция без заобиколно решение.	4 часа
Сев 2 — Основно	Значително нарушена или влошена функционалност; има заобиколно решение.	1 работен ден
Сев 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. Раздели, които по своята същност трябва да останат в сила след прекратяване — включително натрупаната, но непотърсена възможност за Кредити за услуга, ограничението на отговорността и дефинициите — остават в сила.