Katalog dogodkov Webhook

Ta stran navaja vse dogodke webhook, na katere se lahko naročite na Wink. Za navodila za nastavitev si oglejte Vodnik za integracijo Webhook ali stran za upravljanje Webhookov.

Kako se naročiti

1. Pojdite na Applications > Webhooks v vašem portalu.
2. Ustvarite webhook in izberite dogodke, ki jih želite prejemati — ali pustite seznam prazen, da prejemate vse dogodke.
3. Wink pošlje podpisan HTTP POST na vašo končno točko vsakič, ko se dogodek zgodi. Oglejte si Integracijo Webhook za ovojnico, glave, preverjanje podpisa in ponovitve.

Vsaka vrsta dogodka

Ta tabela je ustvarjena iz kataloga dogodkov platforme ob gradnji, zato vedno ustreza API-ju. Vrste dogodkov, označene kot dostavljene, so povezane z njihovo referenčno stranjo v Webhooks API, ki dokumentira natančno JSON telo (WebhookEnvelope z dogodkovno-specifičnim object), Wink-* glave in politiko ponovnih poskusov. Vrste dogodkov, ki niso dostavljene, obstajajo interno (plačila, knjigovodstvo, sinhronizacija kanalov channel-manager, …), vendar trenutno niso poslane naročnikom webhookov.

Prejemniki pove, kdo prejme dogodek: SUPPLIER (hotel), AFFILIATE (prodajalec z aktivnim prodajnim kanalom do hotela), AGENT (potovalna agencija, ki je opravila rezervacijo) ali SELF (upravljajoči subjekt, na katerega se dogodek nanaša). Vsak prejemnik prejme enako obliko vsebine; podrobnosti, specifične za vlogo, so za URL-jem links.self v vsebini.

account.*

Dogodek	Opis	Dostavljeno	Prejemniki
account.details.updated	The account's details changed.	ni dostavljeno	—
account.managers.update	The account's manager list changed.	✓ dostavljeno	SELF
account.task.complete	An onboarding task was completed.	ni dostavljeno	—
account.task.create	An onboarding task was created for the account.	ni dostavljeno	—
account.task.remove	An onboarding task was removed.	ni dostavljeno	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	ni dostavljeno	—
account.task.update	An onboarding task was updated.	ni dostavljeno	—
account.under_review	The account was placed under review.	ni dostavljeno	—

activity.*

Dogodek	Opis	Dostavljeno	Prejemniki
activity.created	An activity was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

add_on.*

Dogodek	Opis	Dostavljeno	Prejemniki
add_on.created	An add-on was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

booking.*

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

channel-manager.*

Dogodek	Opis	Dostavljeno	Prejemniki
channel-manager.update	A channel manager pushed an update.	ni dostavljeno	—
channel-manager.update.availability	A channel manager pushed an availability update.	ni dostavljeno	—
channel-manager.update.rate	A channel manager pushed a rate update.	ni dostavljeno	—

email.*

Dogodek	Opis	Dostavljeno	Prejemniki
email.correspondence	An email correspondence was recorded.	ni dostavljeno	—

internal.*

Dogodek	Opis	Dostavljeno	Prejemniki
internal.payment.failed	A payment failed (internal).	ni dostavljeno	—
internal.payment.processing	A payment is processing (internal).	ni dostavljeno	—
internal.payment.succeeded	A payment succeeded (internal).	ni dostavljeno	—

ledger.*

Dogodek	Opis	Dostavljeno	Prejemniki
ledger.entry.create	A ledger entry was created.	ni dostavljeno	—

managing_entity.*

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

master_rate.*

Dogodek	Opis	Dostavljeno	Prejemniki
master_rate.created	A master rate was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

meeting_room.*

Dogodek	Opis	Dostavljeno	Prejemniki
meeting_room.created	A meeting room was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

payee.*

Dogodek	Opis	Dostavljeno	Prejemniki
payee.create	A payee was created.	ni dostavljeno	—
payee.create.failure	Creating a payee failed.	ni dostavljeno	—
payee.update	A payee was updated.	ni dostavljeno	—
payee.update.failure	Updating a payee failed.	ni dostavljeno	—

perk.*

Dogodek	Opis	Dostavljeno	Prejemniki
perk.deleted	A perk was deleted.	ni dostavljeno	—
perk.updated	A perk was updated.	ni dostavljeno	—

property.*

Dogodek	Opis	Dostavljeno	Prejemniki
property.address.updated	A property's address changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ dostavljeno	AFFILIATE, SUPPLIER
property.updated	A property was updated.	ni dostavljeno	—
property.welcome_text.updated	A property's welcome text changed.	✓ dostavljeno	AFFILIATE, SUPPLIER

rate_modifier.*

Dogodek	Opis	Dostavljeno	Prejemniki
rate_modifier.updated	A rate modifier was updated.	ni dostavljeno	—

rate_plan.*

Dogodek	Opis	Dostavljeno	Prejemniki
rate_plan.created	A rate plan was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

restaurant.*

Dogodek	Opis	Dostavljeno	Prejemniki
restaurant.created	A restaurant was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

room_type.*

Dogodek	Opis	Dostavljeno	Prejemniki
room_type.created	A room type was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

sales_channel.*

Dogodek	Opis	Dostavljeno	Prejemniki
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

spa.*

Dogodek	Opis	Dostavljeno	Prejemniki
spa.created	A spa was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

special_rate.*

Dogodek	Opis	Dostavljeno	Prejemniki
special_rate.created	A promotion (special rate) was created.	✓ dostavljeno	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ dostavljeno	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ dostavljeno	AFFILIATE, SUPPLIER

Tip

Začnite z naročanjem na vse dogodke med razvojem. Ko razumete, katere vsebine vaš sistem potrebuje, zožite naročnine, da zmanjšate šum. Pošljite si testni dogodek iz Applications > Webhooks (ali POST …/webhook/{id}/test), da potrdite svojo končno točko in preverjanje podpisa pred začetkom delovanja.

Nadaljnje branje

• Vodnik za integracijo Webhook — koraki nastavitve in najboljše prakse.
• Webhooki — upravljanje vaših naročnin na webhooke.
• Applications — upravljanje API poverilnic.
• Build on Wink — pregled platforme za razvijalce.