Skip to content
TicketingHub Help

Sut i greu a defnyddio tocyn API

Mae tocynnau API yn caniatáu i system arall gysylltu â’ch cyfrif TicketingHub. Rhaid bod gennych fynediad gweinyddwr i’w rheoli.

At beth y gallaf ddefnyddio tocyn API?

  • Anfon data TicketingHub at feddalwedd adroddiadau neu warws data.
  • Caniatáu i blatfform partner pwrpasol ddarllen cynhyrchion a phrisiau.
  • Creu profiad archebu ochr y gweinydd sy’n gwirio argaeledd byw.

Nid yw tocyn API yn creu cysylltiad Google Sheets adeiledig. Gweler Sut i allforio data TicketingHub a chysylltu offer eraill i ddewis rhwng allforion CSV, Zapier, webhooks a mynediad API.

Galluogi mynediad API

  1. Ewch i Gosodiadau → Nodweddion.
  2. Trowch Mynediad API ymlaen.

Mae hwn yn osodiad hunanwasanaeth. Ar ôl i chi ei alluogi, bydd Tocynnau API yn ymddangos yn Gosodiadau.

Creu tocyn

  1. Ewch i Gosodiadau → Tocynnau API.
  2. Dewiswch Cynhyrchu tocyn API.
  3. Rhowch enw sy’n nodi’r system sy’n defnyddio’r tocyn.
  4. Dewiswch Supplier API (V2) ar gyfer rheoli cyflenwyr, Widget API ar gyfer argaeledd ac archebu, neu OCTO API ar gyfer cysylltu systemau sy’n defnyddio safon OCTO.
  5. Os gwnaethoch ddewis Supplier API (V2) neu OCTO API, gallwch ddewis Darllen yn unig pan mai dim ond gweld data sydd ei angen ar yr integreiddiad. Nid yw’r opsiwn hwn yn berthnasol i docynnau Widget API.
  6. Ychwanegwch ddyddiad dod i ben os oes angen, yna cynhyrchwch y tocyn.
  7. Copïwch y tocyn ar unwaith a’i storio’n ddiogel. Dim ond unwaith y dangosir y tocyn llawn.

Defnyddio’r tocyn

Anfonwch y tocyn ym mhennyn Authorization pob cais API:

Authorization: Bearer YOUR_TOKEN

Defnyddiwch docynnau API mewn systemau ochr y gweinydd diogel yn unig. Peidiwch â rhoi tocyn yng nghod gwefan, negeseuon e-bost, negeseuon sgwrsio na dogfennau a rennir.

Dirymu tocyn

Ewch i Gosodiadau → Tocynnau API a dewiswch Dirymu wrth ymyl y tocyn. Daw’r dirymiad i rym ar unwaith, felly bydd y system gysylltiedig yn rhoi’r gorau i weithio nes iddi ddefnyddio tocyn newydd yn ei le.

Crëwch docyn ar wahân ar gyfer pob integreiddiad, defnyddiwch y mynediad sydd ei angen arno yn unig, a dirymwch docynnau nad ydynt yn cael eu defnyddio mwyach. Ar gyfer diweddariadau seiliedig ar ddigwyddiadau, efallai y byddai’n well gennych ddefnyddio webhooks neu integreiddiad Zapier.