Ga naar inhoud
TicketingHub Help

Een API-token maken en gebruiken

Met API-tokens kan een ander systeem verbinding maken met uw TicketingHub-account. U moet beheerderstoegang hebben om tokens te beheren.

Waarvoor kan ik een API-token gebruiken?

  • TicketingHub-gegevens naar rapportagesoftware of een datawarehouse sturen.
  • Een aangepast partnerplatform producten en prijzen laten lezen.
  • Een boekingservaring aan de serverzijde bouwen die de actuele beschikbaarheid controleert.

Een API-token maakt geen ingebouwde verbinding met Google Spreadsheets. Zie TicketingHub-gegevens exporteren en andere tools koppelen om te kiezen tussen CSV-exports, Zapier, webhooks en API-toegang.

API-toegang inschakelen

  1. Ga naar Instellingen → Functies.
  2. Schakel API-toegang in.

Dit is een zelfbedieningsinstelling. Nadat u deze hebt ingeschakeld, verschijnt API-tokens in Instellingen.

Een token maken

  1. Ga naar Instellingen → API-tokens.
  2. Selecteer API-token genereren.
  3. Voer een naam in waaraan u het systeem kunt herkennen dat het token gebruikt.
  4. Kies Supplier API (V2) voor leveranciersbeheer, Widget API voor beschikbaarheid en boekingen, of OCTO API voor het koppelen van systemen die de OCTO-standaard ondersteunen.
  5. Als u Supplier API (V2) of OCTO API hebt gekozen, kunt u Alleen-lezen selecteren wanneer de integratie alleen gegevens hoeft te bekijken. Deze optie is niet van toepassing op Widget API-tokens.
  6. Voeg indien nodig een vervaldatum toe en genereer het token.
  7. Kopieer het token onmiddellijk en bewaar het veilig. Het volledige token wordt slechts één keer weergegeven.

Het token gebruiken

Stuur het token mee in de header Authorization van elk API-verzoek:

Authorization: Bearer YOUR_TOKEN

Gebruik API-tokens uitsluitend in veilige systemen aan de serverzijde. Plaats een token niet in websitecode, e-mails, chatberichten of gedeelde documenten.

Een token intrekken

Ga naar Instellingen → API-tokens en selecteer Intrekken naast het token. Het intrekken wordt onmiddellijk van kracht. Het verbonden systeem werkt dan niet meer totdat het een vervangend token gebruikt.

Maak voor elke integratie een afzonderlijk token, gebruik alleen de toegang die de integratie nodig heeft en trek tokens in die niet meer worden gebruikt. Voor updates op basis van gebeurtenissen kunt u mogelijk beter webhooks of de Zapier-integratie gebruiken.