Skip to content
TicketingHub Help

Sut i sefydlu webhooks

Mae webhooks yn anfon digwyddiadau TicketingHub dethol i system arall wrth iddynt ddigwydd.

Cyn i chi ddechrau

  • Rhaid galluogi webhooks ar gyfer eich cyfrif TicketingHub. Cysylltwch â TicketingHub os nad yw’r adran Webhooks ar gael.
  • Mae angen mynediad gweinyddwr neu reolwr arnoch.
  • Rhaid i’r system sy’n derbyn ddarparu URL HTTPS cyhoeddus.

Ychwanegu webhook

  1. Ewch i Gosodiadau → Uwch.
  2. Dewch o hyd i Webhooks a dewiswch Golygu.
  3. Dewiswch Webhook newydd.
  4. Rhowch yr URL HTTPS a fydd yn derbyn y digwyddiadau.
  5. Dewiswch y mathau o ddigwyddiadau i’w hanfon, megis archeb sydd wedi’i chadarnhau neu ei chanslo.
  6. Dewisol: rhowch gyfrinach gryf fel y gall y system sy’n derbyn wirio pob cais.
  7. Crëwch y webhook, yna cynhaliwch un o’r digwyddiadau a ddewiswyd i’w brofi.

Os byddwch yn ychwanegu cyfrinach, bydd TicketingHub yn llofnodi pob cais ac yn anfon y llofnod ym mhennyn X-TicketingHub-Signature-256. Dylai eich datblygwr wirio’r llofnod hwn cyn derbyn y data.

Cadw’r webhook yn weithredol

Dylai’r system sy’n derbyn ymateb yn brydlon gyda statws 2xx llwyddiannus. Mae TicketingHub yn ailgeisio danfoniadau sy’n dod i ben oherwydd terfyn amser neu sy’n dychwelyd ymateb aflwyddiannus. Caiff endpoint sy’n parhau i fethu ei analluogi’n awtomatig; trwsiwch y system sy’n derbyn, yna ewch yn ôl i’r dudalen Webhooks a’i galluogi eto.

Mae TicketingHub ond yn anfon digwyddiadau i gyfeiriadau cyhoeddus. Os yw’r URL yn pwyntio at gyfeiriad rhwydwaith preifat, megis gweinydd y tu mewn i’ch rhwydwaith eich hun, nid yw TicketingHub yn anfon y digwyddiad ac mae’n analluogi’r webhook ar unwaith. Mae’r dudalen Webhooks yn dangos “Mae’r URL yn pwyntio at gyfeiriad rhwydwaith preifat” ac mae gweinyddwyr eich cyfrif yn cael e-bost. Newidiwch yr URL i gyfeiriad HTTPS cyhoeddus, yna galluogwch y webhook eto.

Dewiswch y digwyddiadau sydd eu hangen arnoch yn unig, ac osgowch ddefnyddio URL profi mewn cyfrif gweithredol. I anfon digwyddiadau i Zapier heb adeiladu eich derbynnydd eich hun, gweler Sut i gysylltu TicketingHub â Zapier. I adeiladu integreiddiad sydd hefyd yn gofyn am ddata gan TicketingHub, gweler Sut i greu a defnyddio tocyn API.