Een andere tool koppelen via de 10Seat Partner API

Met de 10Seat Partner API kan een extern systeem — een kassa, een marketingtool, een groepswebsite, een maatwerkapp — jouw 10Seat-gegevens lezen en schrijven. De toegang werkt met een API-sleutel die 10Seat voor jouw bedrijf uitgeeft en die alleen werkt voor je eigen locaties.

Waar vind je het

Er is geen scherm voor API-sleutels in de backoffice. Sleutels worden door 10Seat aangemaakt. De openbare API-documentatie staat op partner.10seat.com/docs. Je ontwikkelaar of integratiepartner gebruikt die documentatie; jij hoeft alleen toegang aan te vragen.

Wat het doet

Afhankelijk van de rechten die 10Seat aan de sleutel geeft, kan een gekoppelde tool:

• Reserveringen: reserveringen opvragen, één reservering ophalen, een reservering aanmaken, een reservering annuleren.
• Locaties: je locaties opvragen en de gegevens van een locatie lezen.
• Cadeaubonnen: een bon valideren en een bon inwisselen.
• Kassagegevens (Lightspeed-zaken): bestellingen opvragen en een bestelling lezen; menucategorieën, producten en voorraad lezen. Producten aanmaken of wijzigen kan alleen voor partners die 10Seat daarvoor heeft goedgekeurd.

Elke sleutel is aan jouw bedrijf gekoppeld. Hij kan worden beperkt tot specifieke locaties, en het kan een testsleutel zijn (alleen voor testlocaties, nooit voor je live gegevens) of een livesleutel.

Zo vraag je toegang aan

1. Bepaal welke tool toegang nodig heeft en wat die moet kunnen doen (bijvoorbeeld “reserveringen aanmaken vanaf onze groepswebsite” of “de bestellingen van vandaag lezen”).
2. Neem contact op met de support van 10Seat met: de naam van de tool of partner, welke locaties nodig zijn en wat er gelezen of gewijzigd moet worden.
3. 10Seat maakt de sleutel voor jouw bedrijf aan met alleen de rechten die die tool nodig heeft, en geeft hem aan jou of je integratiepartner. Integratiepartners die met meerdere restaurants werken, beheren hun sleutels in het 10Seat-partnerportaal.
4. Je ontwikkelaar of partner volgt de documentatie om te koppelen.

Goed om te weten

• Behandel een API-sleutel als een wachtwoord. Iedereen die hem heeft, kan hem gebruiken met de rechten die hij heeft gekregen.
• Een sleutel werkt alleen voor locaties van jouw bedrijf; aanvragen voor andere locaties worden geweigerd.
• Als een sleutel uitlekt, of je stopt met een partner, neem dan contact op met de support van 10Seat om de sleutel te laten vervangen of uitschakelen.
• Wil je dat een AI-assistent je gegevens leest in plaats van een extern systeem? Zie “Een AI-assistent koppelen met MCP-toegang”.

Problemen oplossen

Onze partner krijgt “Access denied for this location” of “Location does not belong to this API key company” De sleutel is beperkt tot andere locaties, of de locatie hoort bij een ander bedrijf. Vraag de support van 10Seat om de locatie aan de sleutel toe te voegen.

Onze partner krijgt “Test API keys cannot access live restaurant data” Ze gebruiken een testsleutel op je live locatie. Ze hebben een live sleutel nodig — vraag het aan de support van 10Seat.

Onze partner krijgt “Invalid or inactive API key” De sleutel is onjuist, vervangen of uitgeschakeld. Neem contact op met de support van 10Seat.

De partner kan reserveringen lezen maar niet aanmaken De sleutel heeft geen recht om reserveringen te schrijven. Vraag de support van 10Seat om de rechten van de sleutel na te kijken.