Katalog zdarzeń webhook

Ta strona zawiera listę wszystkich zdarzeń webhook, na które możesz się zapisać na Wink. Instrukcje konfiguracji znajdziesz w Przewodniku integracji webhook lub na stronie zarządzania webhookami.

Jak się zapisać

1. Przejdź do Aplikacje > Webhooki w swoim portalu.
2. Utwórz webhook i wybierz zdarzenia, które chcesz otrzymywać — lub pozostaw listę pustą, aby otrzymywać każde zdarzenie.
3. Wink wysyła podpisany HTTP POST do twojego endpointu za każdym razem, gdy zdarzenie wystąpi. Zobacz Integrację webhook dla informacji o kopercie, nagłówkach, weryfikacji podpisu i ponownych próbach.

Wszystkie typy zdarzeń

Ta tabela jest generowana z katalogu zdarzeń platformy podczas budowania, więc zawsze odpowiada API. Typy zdarzeń oznaczone jako dostarczone linkują do ich strony referencyjnej w Webhooks API, która dokumentuje dokładne ciało JSON (WebhookEnvelope z event-specyficznym object), nagłówki Wink-* oraz politykę ponownych prób. Typy zdarzeń, które nie są dostarczane, istnieją wewnętrznie (płatności, księga, synchronizacja channel-managera, …) ale obecnie nie są wysyłane do subskrybentów webhook.

Odbiorcy wskazuje, kto otrzymuje zdarzenie: SUPPLIER (hotel), AFFILIATE (reseller z aktywnym kanałem sprzedaży do hotelu), AGENT (biuro podróży, które dokonało rezerwacji) lub SELF (podmiot zarządzający, którego dotyczy zdarzenie). Każdy odbiorca otrzymuje ten sam kształt payloadu; szczegóły specyficzne dla roli znajdują się pod URL links.self w payloadzie.

account.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
account.details.updated	The account's details changed.	niedostarczone	—
account.managers.update	The account's manager list changed.	✓ dostarczone	SELF
account.task.complete	An onboarding task was completed.	niedostarczone	—
account.task.create	An onboarding task was created for the account.	niedostarczone	—
account.task.remove	An onboarding task was removed.	niedostarczone	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	niedostarczone	—
account.task.update	An onboarding task was updated.	niedostarczone	—
account.under_review	The account was placed under review.	niedostarczone	—

activity.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
activity.created	An activity was created.	✓ dostarczone	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

add_on.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
add_on.created	An add-on was created.	✓ dostarczone	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

booking.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
booking.cancelled	A booking was cancelled.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	niedostarczone	—
booking.initialize.request	A booking initialisation (checkout) was requested.	niedostarczone	—
booking.payout.complete	A payout for a booking completed.	niedostarczone	—
booking.payout.create	A payout for a booking was created.	niedostarczone	—
booking.processing	A booking is being processed.	niedostarczone	—
booking.refund.error	A booking was refunded because of a processing error.	niedostarczone	—
booking.refund.full	A booking was fully refunded.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ dostarczone	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ dostarczone	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	niedostarczone	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	niedostarczone	—

channel-manager.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
channel-manager.update	A channel manager pushed an update.	niedostarczone	—
channel-manager.update.availability	A channel manager pushed an availability update.	niedostarczone	—
channel-manager.update.rate	A channel manager pushed a rate update.	niedostarczone	—

email.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
email.correspondence	An email correspondence was recorded.	niedostarczone	—

internal.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
internal.payment.failed	A payment failed (internal).	niedostarczone	—
internal.payment.processing	A payment is processing (internal).	niedostarczone	—
internal.payment.succeeded	A payment succeeded (internal).	niedostarczone	—

ledger.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
ledger.entry.create	A ledger entry was created.	niedostarczone	—

managing_entity.*

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

master_rate.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
master_rate.created	A master rate was created.	✓ dostarczone	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

meeting_room.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
meeting_room.created	A meeting room was created.	✓ dostarczone	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

payee.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
payee.create	A payee was created.	niedostarczone	—
payee.create.failure	Creating a payee failed.	niedostarczone	—
payee.update	A payee was updated.	niedostarczone	—
payee.update.failure	Updating a payee failed.	niedostarczone	—

perk.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
perk.deleted	A perk was deleted.	niedostarczone	—
perk.updated	A perk was updated.	niedostarczone	—

property.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
property.address.updated	A property's address changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ dostarczone	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ dostarczone	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ dostarczone	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ dostarczone	AFFILIATE, SUPPLIER
property.updated	A property was updated.	niedostarczone	—
property.welcome_text.updated	A property's welcome text changed.	✓ dostarczone	AFFILIATE, SUPPLIER

rate_modifier.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
rate_modifier.updated	A rate modifier was updated.	niedostarczone	—

rate_plan.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
rate_plan.created	A rate plan was created.	✓ dostarczone	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

restaurant.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
restaurant.created	A restaurant was created.	✓ dostarczone	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

room_type.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
room_type.created	A room type was created.	✓ dostarczone	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

sales_channel.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ dostarczone	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

spa.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
spa.created	A spa was created.	✓ dostarczone	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

special_rate.*

Zdarzenie	Opis	Dostarczone	Odbiorcy
special_rate.created	A promotion (special rate) was created.	✓ dostarczone	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ dostarczone	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ dostarczone	AFFILIATE, SUPPLIER

Wskazówka

Na początku podczas rozwoju subskrybuj wszystkie zdarzenia. Gdy zrozumiesz, które payloady są potrzebne twojemu systemowi, zawęź subskrypcje, aby zmniejszyć szum. Wyślij sobie testowe zdarzenie z Aplikacje > Webhooki (lub POST …/webhook/{id}/test), aby potwierdzić swój endpoint i weryfikację podpisu przed uruchomieniem na żywo.

Dalsza lektura

• Przewodnik integracji webhook — Kroki konfiguracji i najlepsze praktyki.
• Webhooki — Zarządzaj swoimi subskrypcjami webhook.
• Aplikacje — Zarządzaj poświadczeniami API.
• Buduj na Wink — Przegląd platformy dla deweloperów.