Webhook įvykių katalogas

Šiame puslapyje pateikiami visi webhook įvykiai, kuriems galite užsiprenumeruoti Wink. Nustatymo instrukcijoms žr. Webhook integracijos vadovą arba Webhook valdymo puslapį.

Kaip užsiprenumeruoti

1. Eikite į Applications > Webhooks savo portale.
2. Sukurkite webhook ir pasirinkite įvykius, kuriuos norite gauti — arba palikite sąrašą tuščią, kad gautumėte visus įvykius.
3. Wink kiekvieną kartą, kai įvykis įvyksta, siunčia pasirašytą HTTP POST į jūsų galinį tašką. Žr. Webhook integraciją dėl paketo, antraščių, parašo patikrinimo ir pakartojimų.

Visi įvykių tipai

Ši lentelė sugeneruota iš platformos įvykių katalogo statymo metu, todėl visada atitinka API. Įvykių tipai, pažymėti kaip pristatomi, turi nuorodą į jų aprašymo puslapį Webhooks API, kuriame dokumentuojamas tikslus JSON turinys (WebhookEnvelope su įvykiui specifiniu object), Wink-* antraštės ir pakartojimų politika. Įvykių tipai, kurie nėra pristatomi, egzistuoja viduje (mokėjimai, apskaita, kanalo valdytojo sinchronizacija ir kt.), bet šiuo metu nėra siunčiami webhook prenumeratoriams.

Gavėjai nurodo, kas gauna įvykį: SUPPLIER (viešbutis), AFFILIATE (perpardavėjas su aktyviu pardavimo kanalu į viešbutį), AGENT (kelionių agentūra, kuri atliko užsakymą) arba SELF (valdymo subjektas, apie kurį yra įvykis). Kiekvienas gavėjas gauna tą patį duomenų paketo formatą; rolės specifinė informacija yra už paketo links.self URL.

account.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
account.details.updated	The account's details changed.	nepristatyta	—
account.managers.update	The account's manager list changed.	✓ pristatyta	SELF
account.task.complete	An onboarding task was completed.	nepristatyta	—
account.task.create	An onboarding task was created for the account.	nepristatyta	—
account.task.remove	An onboarding task was removed.	nepristatyta	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	nepristatyta	—
account.task.update	An onboarding task was updated.	nepristatyta	—
account.under_review	The account was placed under review.	nepristatyta	—

activity.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
activity.created	An activity was created.	✓ pristatyta	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

add_on.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
add_on.created	An add-on was created.	✓ pristatyta	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

booking.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
booking.cancelled	A booking was cancelled.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	nepristatyta	—
booking.initialize.request	A booking initialisation (checkout) was requested.	nepristatyta	—
booking.payout.complete	A payout for a booking completed.	nepristatyta	—
booking.payout.create	A payout for a booking was created.	nepristatyta	—
booking.processing	A booking is being processed.	nepristatyta	—
booking.refund.error	A booking was refunded because of a processing error.	nepristatyta	—
booking.refund.full	A booking was fully refunded.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ pristatyta	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ pristatyta	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	nepristatyta	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	nepristatyta	—

channel-manager.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
channel-manager.update	A channel manager pushed an update.	nepristatyta	—
channel-manager.update.availability	A channel manager pushed an availability update.	nepristatyta	—
channel-manager.update.rate	A channel manager pushed a rate update.	nepristatyta	—

email.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
email.correspondence	An email correspondence was recorded.	nepristatyta	—

internal.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
internal.payment.failed	A payment failed (internal).	nepristatyta	—
internal.payment.processing	A payment is processing (internal).	nepristatyta	—
internal.payment.succeeded	A payment succeeded (internal).	nepristatyta	—

ledger.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
ledger.entry.create	A ledger entry was created.	nepristatyta	—

managing_entity.*

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

master_rate.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
master_rate.created	A master rate was created.	✓ pristatyta	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

meeting_room.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
meeting_room.created	A meeting room was created.	✓ pristatyta	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

payee.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
payee.create	A payee was created.	nepristatyta	—
payee.create.failure	Creating a payee failed.	nepristatyta	—
payee.update	A payee was updated.	nepristatyta	—
payee.update.failure	Updating a payee failed.	nepristatyta	—

perk.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
perk.deleted	A perk was deleted.	nepristatyta	—
perk.updated	A perk was updated.	nepristatyta	—

property.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
property.address.updated	A property's address changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ pristatyta	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ pristatyta	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ pristatyta	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ pristatyta	AFFILIATE, SUPPLIER
property.updated	A property was updated.	nepristatyta	—
property.welcome_text.updated	A property's welcome text changed.	✓ pristatyta	AFFILIATE, SUPPLIER

rate_modifier.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
rate_modifier.updated	A rate modifier was updated.	nepristatyta	—

rate_plan.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
rate_plan.created	A rate plan was created.	✓ pristatyta	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

restaurant.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
restaurant.created	A restaurant was created.	✓ pristatyta	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

room_type.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
room_type.created	A room type was created.	✓ pristatyta	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

sales_channel.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ pristatyta	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

spa.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
spa.created	A spa was created.	✓ pristatyta	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

special_rate.*

Įvykis	Aprašymas	Pristatyta	Gavėjai
special_rate.created	A promotion (special rate) was created.	✓ pristatyta	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ pristatyta	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ pristatyta	AFFILIATE, SUPPLIER

Tip

Pradėkite nuo visų įvykių prenumeratos kūrimo vystymo metu. Kai suprasite, kokių duomenų jūsų sistema reikalauja, susiaurinkite prenumeratas triukšmui sumažinti. Išsiųskite sau testinį įvykį iš Applications > Webhooks (arba POST …/webhook/{id}/test), kad patvirtintumėte savo galinį tašką ir parašo patikrinimą prieš paleidžiant gyvai.

Tolimesnė literatūra

• Webhook integracijos vadovas — Nustatymo žingsniai ir geriausios praktikos.
• Webhooks — Valdykite savo webhook prenumeratas.
• Applications — Valdykite API kredencialus.
• Build on Wink — Platformos apžvalga kūrėjams.