Gå til indhold

Sådan opretter og bruger du et API-token

API-tokens giver et andet system mulighed for at oprette forbindelse til din TicketingHub-konto. Du skal have administratoradgang for at administrere dem.

Hvad kan jeg bruge et API-token til?

  • Sende TicketingHub-data til rapporteringssoftware eller et datalager.
  • Give en tilpasset partnerplatform adgang til at læse produkter og priser.
  • Opbygge en serverbaseret bookingoplevelse, der kontrollerer tilgængelighed i realtid.

Et API-token opretter ikke en indbygget forbindelse til Google Sheets. Se Sådan eksporterer du TicketingHub-data og opretter forbindelse til andre værktøjer for at vælge mellem CSV-eksport, Zapier, webhooks og API-adgang.

Aktivér API-adgang

  1. Gå til Indstillinger → Funktioner.
  2. Slå API-adgang til.

Denne indstilling kan administreres direkte af dig. Når du har aktiveret den, vises API-tokens under Indstillinger.

Opret et token

  1. Gå til Indstillinger → API-tokens.
  2. Vælg Generér API-token.
  3. Angiv et navn, der identificerer det system, som bruger tokenet.
  4. Vælg Leverandør-API (V2) til leverandøradministration, Widget-API til tilgængelighed og booking eller OCTO-API for at oprette forbindelse til systemer, der understøtter OCTO-standarden.
  5. Hvis du har valgt Leverandør-API (V2) eller OCTO-API, kan du vælge Kun læseadgang, hvis integrationen kun skal kunne se data. Denne mulighed gælder ikke for Widget-API-tokens.
  6. Tilføj eventuelt en udløbsdato, og generér derefter tokenet.
  7. Kopiér tokenet med det samme, og opbevar det sikkert. Hele tokenet vises kun én gang.

Brug tokenet

Send tokenet i Authorization-headeren for hver API-anmodning:

Authorization: Bearer YOUR_TOKEN

Brug kun API-tokens i sikre serverbaserede systemer. Indsæt ikke et token i webstedskode, e-mails, chatbeskeder eller delte dokumenter.

Tilbagekald et token

Gå til Indstillinger → API-tokens, og vælg Tilbagekald ud for tokenet. Tilbagekaldelsen træder i kraft med det samme, så det tilsluttede system holder op med at fungere, indtil det bruger et erstatningstoken.

Alle administratorer på kontoen får en e-mail, når et token oprettes, så et uventet token hurtigt bliver opdaget. Se Sikkerhedsmails fra TicketingHub. Opret et separat token til hver integration, giv kun den nødvendige adgang, og tilbagekald tokens, der ikke længere er i brug. Til hændelsesbaserede opdateringer kan du i stedet bruge webhooks eller Zapier-integrationen.