Ændringslog og versionering

#Versionering

Versionen står i adressen: /api/v1. Et flow eller en integration, der er bygget på v1, skal ikke bygges om, når AttendBeacon ændrer sig, så inden for v1 gælder:

• Der tilføjes, men fjernes aldrig noget. Nye operationer, nye felter i svar, nye valgfrie parametre, nye værdier i en liste som en webhook-type eller en fejlkode. Skriv kode, der ignorerer det, den ikke kender.
• Aldrig omdøbt eller fjernet: et felt, en operation, et scope, en fejlkode eller en webhook-type, når den først er udgivet.
• En ændring, der bryder noget, er v2. Den annonceres her og pr. e-mail til alle arbejdsområder med en nøgle mindst seks måneder, før v1 ændres, og v1 bliver ved med at virke i de seks måneder.
• Det, der udfases, markeres deprecated i OpenAPI-beskrivelsen og nævnes her med den dato, det forsvinder.

Ikke ændringer i denne forstand: rækkefølgen af felter i en body, teksten i detail (forgren på code), nye svar-headers og rettelse af et svar, der modsagde denne dokumentation.

OpenAPI 3.1-beskrivelsen på /api/v1/openapi.json er API'et, som det er nu; info.version ændres ved hver tilføjelse.

#2026-10-15: v1.1, udviklerplatformen

• Scopes pr. område. En nøgles scopes er nu et område og en adgang (events:read, attendees:write), og personoplysninger har deres eget scope, people:read. Nøgler oprettet før kan præcis det samme som før.
• Nøgler udløber og logges. En nøgle kan udløbe efter 30, 90, 180 eller 365 dage. Hvert kald står i Nøglernes aktivitet, afvisninger inklusive.
• Problem details. Afvisninger er RFC 9457 application/problem+json med en stabil code; error bliver ved siden af detail for flows, der er bygget før.
• Cursorer og synkronisering. Alle lister svarer med nextCursor og hasMore; lister over ting, der ændrer sig, tager updatedSince. page og pageSize virker stadig, hvor de gjorde før.
• Sikre nye forsøg og ændringer. Idempotency-Key på hver POST; ETag på enkelte ressourcer, If-None-Match og If-Match.
• Headers for kaldgrænser. RateLimit, RateLimit-Policy og X-RateLimit-* på hvert svar, Retry-After ved en 429.
• Nye operationer: arbejdsområdet; oprettelse af kladder til events, ændring af det grundlæggende og offentliggørelse; eventstatistik og salgstempo; billettyper (og ændring af dem), tilvalg og rabatkoder (og oprettelse af dem); en ordre; søgning efter deltagere; optællinger ved indgangene; sessioner (og tilføjelse og ændring af dem), lokaler, spor og oplægsholdere; sponsorer og sponsorniveauer; forslag til indkaldelsen af oplæg; eventteam og vagter; spørgeskemaer, deres resultater og bedømmelser af sessioner; fakturaer og kreditnotaer; budgetoversigten; delingskittets rangliste; fællesskaber og deres medlemmer; webhook-endpoints, deres leveringer, tests og hemmeligheder samt hændelsestyperne med deres payload-skemaer.
• Moduler. Et modul, der er slået fra for et event, svarer 409 moduleOff på sine endpoints. Det gælder også indgange, scanninger ved indgangene og indtjekning (modulet til indtjekning) og leads (modulet til leads), som svarede før.
• Personer. Uden people:read er deltagere, købere, eventteam og medlemmer id'er; leads og søgning efter deltagere kræver det. En person, der har slettet sine data, er erased, uden noget personligt.
• Beskrivelser. /api/v1/openapi.json er nu OpenAPI 3.1, med eksempler og alle afvisninger; den Swagger 2.0-beskrivelse, Power Platform importerer, ligger på /api/v1/swagger.json.
• MCP-serveren på /mcp, til AI-assistenter.

#2026-10-12: v1.0

• Et arbejdsområdes events, deltagere med deres svar, ordrer og scanninger ved indgangene, med updatedSince.
• Tilmelding af en person med en gratis billet, annullering af en billet og indtjekning af en person.
• Abonnementer til Power Automate, Zapier og Make (/hooks) og webhooks signeret efter Standard Webhooks.
• Tilmeldingsspørgsmål, deres JSON-skema, billettyper, indgange og seneste leads, til flows' vælgere og felter.