Каталог на Webhook Събития

Тази страница изброява всички webhook събития, на които можете да се абонирате в Wink. За инструкции за настройка вижте Ръководството за интеграция на Webhook или страницата за управление на Webhooks.

Как да се абонирате

1. Отидете в Applications > Webhooks в портала си.
2. Създайте webhook и изберете събитията, които искате да получавате — или оставете списъка празен, за да получавате всички събития.
3. Wink изпраща подписан HTTP POST към вашия endpoint всеки път, когато събитието се случи. Вижте Webhook Integration за информация относно плика, заглавките, проверката на подписа и повторните опити.

Всеки тип събитие

Тази таблица се генерира от каталога със събития на платформата по време на компилация, така че винаги съответства на API-то. Типовете събития, маркирани като доставени, са свързани с тяхната референтна страница в Webhooks API, която документира точния JSON body (WebhookEnvelope с event-специфичен object), Wink-* заглавките и политиката за повторни опити. Типовете събития, които не се доставят, съществуват вътрешно (плащания, ledger, синхронизация с channel-manager и др.), но в момента не се изпращат на абонатите на webhook.

Получатели показва кой получава събитието: SUPPLIER (хотелът), AFFILIATE (препродавател с активен продажбен канал към хотела), AGENT (туристическата агенция, направила резервацията) или SELF (управляващият субект, за когото е събитието). Всеки получател получава една и съща форма на payload; детайлите, специфични за ролята, са зад URL адреса links.self в payload-а.

account.*

Събитие	Описание	Доставено	Получатели
account.details.updated	The account's details changed.	не е доставено	—
account.managers.update	The account's manager list changed.	✓ доставено	SELF
account.task.complete	An onboarding task was completed.	не е доставено	—
account.task.create	An onboarding task was created for the account.	не е доставено	—
account.task.remove	An onboarding task was removed.	не е доставено	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	не е доставено	—
account.task.update	An onboarding task was updated.	не е доставено	—
account.under_review	The account was placed under review.	не е доставено	—

activity.*

Събитие	Описание	Доставено	Получатели
activity.created	An activity was created.	✓ доставено	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ доставено	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ доставено	AFFILIATE, SUPPLIER

add_on.*

Събитие	Описание	Доставено	Получатели
add_on.created	An add-on was created.	✓ доставено	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ доставено	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ доставено	AFFILIATE, SUPPLIER

booking.*

Събитие	Описание	Доставено	Получатели
booking.cancelled	A booking was cancelled.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	не е доставено	—
booking.initialize.request	A booking initialisation (checkout) was requested.	не е доставено	—
booking.payout.complete	A payout for a booking completed.	не е доставено	—
booking.payout.create	A payout for a booking was created.	не е доставено	—
booking.processing	A booking is being processed.	не е доставено	—
booking.refund.error	A booking was refunded because of a processing error.	не е доставено	—
booking.refund.full	A booking was fully refunded.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ доставено	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ доставено	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	не е доставено	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	не е доставено	—

channel-manager.*

Събитие	Описание	Доставено	Получатели
channel-manager.update	A channel manager pushed an update.	не е доставено	—
channel-manager.update.availability	A channel manager pushed an availability update.	не е доставено	—
channel-manager.update.rate	A channel manager pushed a rate update.	не е доставено	—

email.*

Събитие	Описание	Доставено	Получатели
email.correspondence	An email correspondence was recorded.	не е доставено	—

internal.*

Събитие	Описание	Доставено	Получатели
internal.payment.failed	A payment failed (internal).	не е доставено	—
internal.payment.processing	A payment is processing (internal).	не е доставено	—
internal.payment.succeeded	A payment succeeded (internal).	не е доставено	—

ledger.*

Събитие	Описание	Доставено	Получатели
ledger.entry.create	A ledger entry was created.	не е доставено	—

managing_entity.*

Събитие	Описание	Доставено	Получатели
managing_entity.account_representative.updated	The account representative changed.	не е доставено	—
managing_entity.agent.email.notification	An email notification was sent to the account's agent.	не е доставено	—
managing_entity.agent.updated	The account's travel-agent details changed.	не е доставено	—
managing_entity.city.updated	The account's address or city changed.	✓ доставено	SELF
managing_entity.created	A managing entity (account) was created.	✓ доставено	SELF
managing_entity.deleted	The account was deleted.	✓ доставено	SELF
managing_entity.information.updated	The account's general information changed.	✓ доставено	SELF
managing_entity.logo.updated	The account's logo changed.	✓ доставено	SELF
managing_entity.managed_by.updated	The entity managing this account on its behalf changed.	✓ доставено	SELF
managing_entity.manager.accepted	An invited manager accepted the invitation.	не е доставено	—
managing_entity.manager.added	A manager was added to the account.	✓ доставено	SELF
managing_entity.manager.email.notification	An email notification was sent to an account manager.	не е доставено	—
managing_entity.manager.invited	A manager was invited to the account.	✓ доставено	SELF
managing_entity.manager.owner.set	The account owner was set.	✓ доставено	SELF
managing_entity.manager.rejected	An invited manager rejected the invitation.	не е доставено	—
managing_entity.manager.removed	A manager was removed from the account.	✓ доставено	SELF
managing_entity.name.updated	The account's display name changed.	не е доставено	—
managing_entity.place_id.updated	The account's Google Place ID changed.	✓ доставено	SELF
managing_entity.profile_picture.updated	The account's profile picture changed.	✓ доставено	SELF
managing_entity.status.updated	The account's platform status changed (e.g. approved, suspended).	✓ доставено	SELF
managing_entity.subscription.changed	The account's platform subscription changed.	не е доставено	—
managing_entity.subscription.invoice.changed	The status of a subscription invoice changed.	✓ доставено	SELF
managing_entity.subscription.provisioned	A platform subscription was provisioned for the account.	✓ доставено	SELF
managing_entity.unique_id.updated	The account's short unique id changed.	✓ доставено	SELF
managing_entity.url_name.updated	The account's URL name (slug) changed.	✓ доставено	SELF

master_rate.*

Събитие	Описание	Доставено	Получатели
master_rate.created	A master rate was created.	✓ доставено	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ доставено	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ доставено	AFFILIATE, SUPPLIER

meeting_room.*

Събитие	Описание	Доставено	Получатели
meeting_room.created	A meeting room was created.	✓ доставено	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ доставено	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ доставено	AFFILIATE, SUPPLIER

payee.*

Събитие	Описание	Доставено	Получатели
payee.create	A payee was created.	не е доставено	—
payee.create.failure	Creating a payee failed.	не е доставено	—
payee.update	A payee was updated.	не е доставено	—
payee.update.failure	Updating a payee failed.	не е доставено	—

perk.*

Събитие	Описание	Доставено	Получатели
perk.deleted	A perk was deleted.	не е доставено	—
perk.updated	A perk was updated.	не е доставено	—

property.*

Събитие	Описание	Доставено	Получатели
property.address.updated	A property's address changed.	✓ доставено	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ доставено	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ доставено	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ доставено	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ доставено	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ доставено	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ доставено	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ доставено	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ доставено	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ доставено	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ доставено	AFFILIATE, SUPPLIER
property.updated	A property was updated.	не е доставено	—
property.welcome_text.updated	A property's welcome text changed.	✓ доставено	AFFILIATE, SUPPLIER

rate_modifier.*

Събитие	Описание	Доставено	Получатели
rate_modifier.updated	A rate modifier was updated.	не е доставено	—

rate_plan.*

Събитие	Описание	Доставено	Получатели
rate_plan.created	A rate plan was created.	✓ доставено	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ доставено	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ доставено	AFFILIATE, SUPPLIER

restaurant.*

Събитие	Описание	Доставено	Получатели
restaurant.created	A restaurant was created.	✓ доставено	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ доставено	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ доставено	AFFILIATE, SUPPLIER

room_type.*

Събитие	Описание	Доставено	Получатели
room_type.created	A room type was created.	✓ доставено	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ доставено	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ доставено	AFFILIATE, SUPPLIER

sales_channel.*

Събитие	Описание	Доставено	Получатели
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ доставено	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ доставено	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ доставено	AFFILIATE, SUPPLIER

spa.*

Събитие	Описание	Доставено	Получатели
spa.created	A spa was created.	✓ доставено	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ доставено	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ доставено	AFFILIATE, SUPPLIER

special_rate.*

Събитие	Описание	Доставено	Получатели
special_rate.created	A promotion (special rate) was created.	✓ доставено	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ доставено	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ доставено	AFFILIATE, SUPPLIER

Tip

Започнете с абониране за всички събития по време на разработка. След като разберете кои payload-и са необходими на вашата система, стеснете абонаментите, за да намалите шума. Изпратете си тестово събитие от Applications > Webhooks (или POST …/webhook/{id}/test), за да потвърдите вашия endpoint и проверката на подписа преди да пуснете в продукция.

Допълнително четиво

• Ръководство за интеграция на Webhook — Стъпки за настройка и добри практики.
• Webhooks — Управление на вашите webhook абонаменти.
• Applications — Управление на API креденшъли.
• Build on Wink — Преглед на платформата за разработчици.