Naar de inhoud

Beginnen

Een sleutel aanvragen

Een token voor de REST-API maak je zelf, in het portaal van je organisatie. Het kost niets. Voor de MCP-server heb je geen token nodig: daar log je in met OAuth.

Zo maak je een token

  1. Log in op partyppl.nl met je e-mailadres en de code die je krijgt. Nog geen account? Dat maak je bij het inloggen.
  2. Maak een organisatie aan op partyppl.nl/organiser/start, of laat je toevoegen aan een bestaande. Tokens maken kan als Eigenaar of Beheerder.
  3. Open API in het portaal: partyppl.nl/organiser/api. Geef het token een naam waaraan je het later herkent, bijvoorbeeld de naam van je app.
  4. Kies de rechten. Voor de openbare agenda is read genoeg. De andere rechten staan bij Authenticatie.
  5. Kopieer het token meteen. Het begint met ppl_live_ en je ziet het één keer: wij bewaren alleen een hash. Zet het in je wachtwoordmanager of in de secrets van je server, nooit in code die in een browser of app draait.

Beheren en intrekken

Op dezelfde pagina zie je per token wanneer het voor het laatst gebruikt is, hoeveel verzoeken het vandaag en deze maand deed en wat zijn dagbudget is. Uitgelekt of niet meer nodig? Trek het daar in; het werkt meteen niet meer. Maak voor elke app een eigen token, dan trek je er één in zonder de rest stil te leggen.

Wat je token met de API doet, zie je ook zelf: GET /v1/me zegt welke organisatie en welke rechten het heeft en hoeveel het vandaag per endpoint gebruikte. Zie Token.

Voor een assistent: geen token

Wie Claude of een andere MCP-client koppelt, logt in met zijn PartyPPL-account (OAuth) en kiest namens wie: Alleen lezen kan iedereen, een organisatie kan wie er lid van is. Zie MCP en Claude.

Het recht admin

Het recht admin bestaat alleen op tokens van het platform zelf, gemaakt door het PartyPPL-team in /admin/api. Een organisatie kan het niet aanvragen, en een token van een organisatie dat het toch draagt, wordt geweigerd.

Bijgewerkt