Wijzigingen en versies

#Versies

De versie staat in het adres: /api/v1. Een flow of integratie die op v1 is gebouwd, hoeft niet opnieuw gebouwd te worden als AttendBeacon verandert. Binnen v1 geldt daarom:

• Er komt bij, er gaat nooit iets af. Nieuwe bewerkingen, nieuwe velden in antwoorden, nieuwe optionele parameters, nieuwe waarden in een lijst, zoals een webhooktype of een foutcode. Schrijf code die negeert wat ze niet kent.
• Nooit hernoemd of verwijderd: een veld, een bewerking, een scope, een foutcode of een webhooktype, als het eenmaal is uitgebracht.
• Een brekende wijziging is v2. Die wordt hier en per e-mail aan elke werkruimte met een sleutel aangekondigd, minstens zes maanden voordat v1 verandert, en v1 blijft die zes maanden werken.
• Wat verouderd is, staat als deprecated gemarkeerd in de OpenAPI-beschrijving en wordt hier vermeld, met de datum waarop het verdwijnt.

Geen wijzigingen in deze zin: de volgorde van velden in een body, de tekst van detail (vertak op code), nieuwe response-headers, en het rechtzetten van een antwoord dat deze documentatie tegensprak.

De OpenAPI 3.1-beschrijving op /api/v1/openapi.json is de API zoals hij nu is; info.version verandert bij elke toevoeging.

#2026-10-15: v1.1, het ontwikkelaarsplatform

• Scopes per onderdeel. De scopes van een sleutel zijn nu een onderdeel plus een toegang (events:read, attendees:write), en persoonsgegevens hebben een eigen scope, people:read. Bestaande sleutels houden precies wat ze konden.
• Sleutels verlopen en worden gelogd. Een sleutel kan na 30, 90, 180 of 365 dagen verlopen. Elke aanroep staat in Activiteit van sleutels, weigeringen inbegrepen.
• Problem details. Weigeringen zijn RFC 9457 application/problem+json met een vaste code; error blijft naast detail staan voor flows die eerder zijn gebouwd.
• Cursors en synchronisatie. Elke lijst antwoordt met nextCursor en hasMore; lijsten van dingen die veranderen, nemen updatedSince. page en pageSize werken nog waar ze al werkten.
• Veilige herhalingen en wijzigingen. Idempotency-Key op elke POST; ETag op afzonderlijke resources, If-None-Match en If-Match.
• Headers voor de limiet. RateLimit, RateLimit-Policy en X-RateLimit-* op elk antwoord, Retry-After bij een 429.
• Nieuwe bewerkingen: de werkruimte; conceptevenementen maken, hun basisgegevens wijzigen en ze publiceren; statistieken van een evenement en het verkooptempo; tickettypes (en ze wijzigen), extra's en kortingscodes (en ze maken); een bestelling; deelnemers zoeken; tellingen bij de deur; sessies (en ze toevoegen en wijzigen), zalen, tracks en sprekers; sponsors en sponsorniveaus; voorstellen voor de call for speakers; crew en diensten; enquêtes, hun resultaten en beoordelingen van sessies; facturen en creditnota's; het overzicht van het budget; de ranglijst van de deelkit; community's en hun leden; webhook-endpoints, hun afleveringen, tests en geheimen, en de eventtypes met de schema's van hun payload.
• Modules. Een uitgezette module van een evenement antwoordt 409 moduleOff op zijn endpoints. Dat geldt nu ook voor deuren, deurscans en inchecken (de module Inchecken) en voor leads (de module Leads), die eerder wel antwoordden.
• Mensen. Zonder people:read zijn deelnemers, kopers, crew en leden id's; leads en deelnemers zoeken vereisen die scope. Iemand die de eigen gegevens heeft verwijderd, is erased, zonder iets persoonlijks.
• Beschrijvingen. /api/v1/openapi.json is nu OpenAPI 3.1, met voorbeelden en elke weigering; de Swagger 2.0-beschrijving die Power Platform importeert, staat op /api/v1/swagger.json.
• De MCP-server op /mcp, voor AI-assistenten.

#2026-10-12: v1.0

• Evenementen, deelnemers met hun antwoorden, bestellingen en deurscans van een werkruimte, met updatedSince.
• Iemand registreren met een gratis ticket, een ticket annuleren en iemand inchecken.
• Abonnementen voor Power Automate, Zapier en Make (/hooks), en webhooks ondertekend volgens Standard Webhooks.
• Registratievragen met hun JSON-schema, tickettypes, deuren en recente leads, voor de keuzelijsten en velden van flows.