Katalóg udalostí webhookov

Táto stránka uvádza všetky udalosti webhooku, na ktoré sa môžete prihlásiť na Wink. Pre inštrukcie na nastavenie si pozrite Sprievodcu integráciou webhookov alebo stránku správy webhookov.

Ako sa prihlásiť na odber

1. Prejdite do Aplikácie > Webhooky vo vašom portáli.
2. Vytvorte webhook a vyberte udalosti, ktoré chcete prijímať — alebo nechajte zoznam prázdny, aby ste prijímali všetky udalosti.
3. Wink pošle podpísaný HTTP POST na váš endpoint vždy, keď nastane udalosť. Pozrite si Integráciu webhookov pre informácie o obálke, hlavičkách, overovaní podpisu a opakovaných pokusoch.

Každý typ udalosti

Táto tabuľka je generovaná z katalógu udalostí platformy pri zostavovaní, takže vždy zodpovedá API. Typy udalostí označené ako doručené odkazujú na ich referenčnú stránku v Webhooks API, ktorá dokumentuje presné JSON telo (WebhookEnvelope s udalosťou-špecifickým object), hlavičky Wink-* a politiku opakovaných pokusov. Typy udalostí, ktoré nie sú doručované, existujú interne (platby, kniha účtov, synchronizácia správcu kanálov, …), ale momentálne sa neposielajú odberateľom webhookov.

Príjemcovia uvádza, kto udalosť prijíma: SUPPLIER (hotel), AFFILIATE (predajca s aktívnym predajným kanálom do hotela), AGENT (cestovná kancelária, ktorá vykonala rezerváciu) alebo SELF (spravujúca entita, ktorej sa udalosť týka). Každý príjemca dostáva rovnaký tvar zaťaženia; detail špecifický pre rolu je za URL links.self v zaťažení.

account.*

Udalosť	Popis	Doručené	Príjemcovia
account.details.updated	The account's details changed.	nedoručené	—
account.managers.update	The account's manager list changed.	✓ doručené	SELF
account.task.complete	An onboarding task was completed.	nedoručené	—
account.task.create	An onboarding task was created for the account.	nedoručené	—
account.task.remove	An onboarding task was removed.	nedoručené	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	nedoručené	—
account.task.update	An onboarding task was updated.	nedoručené	—
account.under_review	The account was placed under review.	nedoručené	—

activity.*

Udalosť	Popis	Doručené	Príjemcovia
activity.created	An activity was created.	✓ doručené	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ doručené	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ doručené	AFFILIATE, SUPPLIER

add_on.*

Udalosť	Popis	Doručené	Príjemcovia
add_on.created	An add-on was created.	✓ doručené	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ doručené	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ doručené	AFFILIATE, SUPPLIER

booking.*

Udalosť	Popis	Doručené	Príjemcovia
booking.cancelled	A booking was cancelled.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	nedoručené	—
booking.initialize.request	A booking initialisation (checkout) was requested.	nedoručené	—
booking.payout.complete	A payout for a booking completed.	nedoručené	—
booking.payout.create	A payout for a booking was created.	nedoručené	—
booking.processing	A booking is being processed.	nedoručené	—
booking.refund.error	A booking was refunded because of a processing error.	nedoručené	—
booking.refund.full	A booking was fully refunded.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ doručené	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ doručené	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	nedoručené	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	nedoručené	—

channel-manager.*

Udalosť	Popis	Doručené	Príjemcovia
channel-manager.update	A channel manager pushed an update.	nedoručené	—
channel-manager.update.availability	A channel manager pushed an availability update.	nedoručené	—
channel-manager.update.rate	A channel manager pushed a rate update.	nedoručené	—

email.*

Udalosť	Popis	Doručené	Príjemcovia
email.correspondence	An email correspondence was recorded.	nedoručené	—

internal.*

Udalosť	Popis	Doručené	Príjemcovia
internal.payment.failed	A payment failed (internal).	nedoručené	—
internal.payment.processing	A payment is processing (internal).	nedoručené	—
internal.payment.succeeded	A payment succeeded (internal).	nedoručené	—

ledger.*

Udalosť	Popis	Doručené	Príjemcovia
ledger.entry.create	A ledger entry was created.	nedoručené	—

managing_entity.*

Udalosť	Popis	Doručené	Príjemcovia
managing_entity.account_representative.updated	The account representative changed.	nedoručené	—
managing_entity.agent.email.notification	An email notification was sent to the account's agent.	nedoručené	—
managing_entity.agent.updated	The account's travel-agent details changed.	nedoručené	—
managing_entity.city.updated	The account's address or city changed.	✓ doručené	SELF
managing_entity.created	A managing entity (account) was created.	✓ doručené	SELF
managing_entity.deleted	The account was deleted.	✓ doručené	SELF
managing_entity.information.updated	The account's general information changed.	✓ doručené	SELF
managing_entity.logo.updated	The account's logo changed.	✓ doručené	SELF
managing_entity.managed_by.updated	The entity managing this account on its behalf changed.	✓ doručené	SELF
managing_entity.manager.accepted	An invited manager accepted the invitation.	nedoručené	—
managing_entity.manager.added	A manager was added to the account.	✓ doručené	SELF
managing_entity.manager.email.notification	An email notification was sent to an account manager.	nedoručené	—
managing_entity.manager.invited	A manager was invited to the account.	✓ doručené	SELF
managing_entity.manager.owner.set	The account owner was set.	✓ doručené	SELF
managing_entity.manager.rejected	An invited manager rejected the invitation.	nedoručené	—
managing_entity.manager.removed	A manager was removed from the account.	✓ doručené	SELF
managing_entity.name.updated	The account's display name changed.	nedoručené	—
managing_entity.place_id.updated	The account's Google Place ID changed.	✓ doručené	SELF
managing_entity.profile_picture.updated	The account's profile picture changed.	✓ doručené	SELF
managing_entity.status.updated	The account's platform status changed (e.g. approved, suspended).	✓ doručené	SELF
managing_entity.subscription.changed	The account's platform subscription changed.	nedoručené	—
managing_entity.subscription.invoice.changed	The status of a subscription invoice changed.	✓ doručené	SELF
managing_entity.subscription.provisioned	A platform subscription was provisioned for the account.	✓ doručené	SELF
managing_entity.unique_id.updated	The account's short unique id changed.	✓ doručené	SELF
managing_entity.url_name.updated	The account's URL name (slug) changed.	✓ doručené	SELF

master_rate.*

Udalosť	Popis	Doručené	Príjemcovia
master_rate.created	A master rate was created.	✓ doručené	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ doručené	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ doručené	AFFILIATE, SUPPLIER

meeting_room.*

Udalosť	Popis	Doručené	Príjemcovia
meeting_room.created	A meeting room was created.	✓ doručené	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ doručené	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ doručené	AFFILIATE, SUPPLIER

payee.*

Udalosť	Popis	Doručené	Príjemcovia
payee.create	A payee was created.	nedoručené	—
payee.create.failure	Creating a payee failed.	nedoručené	—
payee.update	A payee was updated.	nedoručené	—
payee.update.failure	Updating a payee failed.	nedoručené	—

perk.*

Udalosť	Popis	Doručené	Príjemcovia
perk.deleted	A perk was deleted.	nedoručené	—
perk.updated	A perk was updated.	nedoručené	—

property.*

Udalosť	Popis	Doručené	Príjemcovia
property.address.updated	A property's address changed.	✓ doručené	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ doručené	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ doručené	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ doručené	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ doručené	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ doručené	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ doručené	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ doručené	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ doručené	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ doručené	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ doručené	AFFILIATE, SUPPLIER
property.updated	A property was updated.	nedoručené	—
property.welcome_text.updated	A property's welcome text changed.	✓ doručené	AFFILIATE, SUPPLIER

rate_modifier.*

Udalosť	Popis	Doručené	Príjemcovia
rate_modifier.updated	A rate modifier was updated.	nedoručené	—

rate_plan.*

Udalosť	Popis	Doručené	Príjemcovia
rate_plan.created	A rate plan was created.	✓ doručené	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ doručené	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ doručené	AFFILIATE, SUPPLIER

restaurant.*

Udalosť	Popis	Doručené	Príjemcovia
restaurant.created	A restaurant was created.	✓ doručené	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ doručené	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ doručené	AFFILIATE, SUPPLIER

room_type.*

Udalosť	Popis	Doručené	Príjemcovia
room_type.created	A room type was created.	✓ doručené	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ doručené	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ doručené	AFFILIATE, SUPPLIER

sales_channel.*

Udalosť	Popis	Doručené	Príjemcovia
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ doručené	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ doručené	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ doručené	AFFILIATE, SUPPLIER

spa.*

Udalosť	Popis	Doručené	Príjemcovia
spa.created	A spa was created.	✓ doručené	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ doručené	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ doručené	AFFILIATE, SUPPLIER

special_rate.*

Udalosť	Popis	Doručené	Príjemcovia
special_rate.created	A promotion (special rate) was created.	✓ doručené	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ doručené	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ doručené	AFFILIATE, SUPPLIER

Tip

Začnite prihlásením na všetky udalosti počas vývoja. Keď pochopíte, ktoré zaťaženia váš systém potrebuje, zúžte svoje prihlásenia, aby ste znížili šum. Pošlite si testovaciu udalosť z Aplikácie > Webhooky (alebo POST …/webhook/{id}/test), aby ste potvrdili svoj endpoint a kontrolu podpisu pred spustením do prevádzky.

Ďalšie čítanie

• Sprievodca integráciou webhookov — Kroky nastavenia a najlepšie postupy.
• Webhooky — Spravujte svoje prihlásenia na webhooky.
• Aplikácie — Spravujte API poverenia.
• Budujte na Wink — Prehľad platformy pre vývojárov.