Endringslogg og versjonering

#Versjonering

Versjonen står i adressen: /api/v1. En flyt eller en integrasjon bygget på v1 bygges ikke om når AttendBeacon endres, så innenfor v1 gjelder dette:

• Lagt til, aldri tatt bort. Nye operasjoner, nye felt i svar, nye valgfrie parametere, nye verdier i en liste, for eksempel en webhook-type eller en feilkode. Skriv kode som ignorerer det den ikke kjenner.
• Aldri omdøpt eller fjernet: et felt, en operasjon, et omfang, en feilkode eller en webhook-type, når det først er levert.
• En endring som ødelegger, blir v2. Den kunngjøres her og på e-post til hvert arbeidsområde med en nøkkel minst seks måneder før v1 endres, og v1 fortsetter å virke i de seks månedene.
• Det som avvikles, merkes deprecated i OpenAPI-beskrivelsen og føres opp her, med datoen det forsvinner.

Dette regnes ikke som endringer: rekkefølgen på feltene i et innhold, teksten i detail (forgren på code), nye svarheadere, og retting av et svar som var i strid med denne dokumentasjonen.

OpenAPI 3.1-beskrivelsen på /api/v1/openapi.json er API-et slik det er nå; info.version endres ved hvert tillegg.

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

• Omfang per område. En nøkkels omfang er nå et område og en tilgang (events:read, attendees:write), og personopplysninger har sitt eget omfang, people:read. Nøkler opprettet før kan nøyaktig det de kunne.
• Nøkler utløper og logges. En nøkkel kan utløpe etter 30, 90, 180 eller 365 dager. Hvert kall står i Nøklenes aktivitet, avvisninger inkludert.
• Problemdetaljer. Avvisninger er RFC 9457 application/problem+json med en stabil code; error blir værende ved siden av detail for flyter som er bygget tidligere.
• Pekere og synkronisering. Hver liste svarer med nextCursor og hasMore; lister over ting som endres, tar updatedSince. page og pageSize virker fortsatt der de gjorde det.
• Trygge nye forsøk og endringer. Idempotency-Key på hver POST; ETag på enkeltressurser, If-None-Match og If-Match.
• Headere for kallgrensen. RateLimit, RateLimit-Policy og X-RateLimit-* på hvert svar, Retry-After med en 429.
• Nye operasjoner: arbeidsområdet; opprette arrangementsutkast, endre det grunnleggende og publisere dem; arrangementsstatistikk og salgstempo; billettyper (og endring av dem), tillegg og rabattkoder (og oppretting av dem); en bestilling; søk etter deltakere; tall ved inngangene; økter (og å legge til og endre dem), rom, spor og foredragsholdere; sponsorer og sponsornivåer; forslag til invitasjonen til foredragsholdere; mannskap og vakter; spørreundersøkelser, resultatene deres og vurderinger av økter; fakturaer og kreditnotaer; budsjettoversikten; delingspakkens toppliste; fellesskap og medlemmene deres; webhook-endepunkter, leveringene deres, tester og hemmeligheter, og hendelsestypene med skjemaene for innholdet.
• Moduler. En modul som er slått av for et arrangement, svarer 409 moduleOff på endepunktene sine. Dette gjelder også innganger, skanninger ved inngangene og innsjekking (innsjekkingsmodulen) og leads (leads-modulen), som svarte før.
• Personer. Uten people:read er deltakere, kjøpere, mannskap og medlemmer ID-er; leads og søk etter deltakere krever omfanget. Noen som har slettet dataene sine, er erased, uten noe personlig.
• Beskrivelser. /api/v1/openapi.json er nå OpenAPI 3.1, med eksempler og alle avvisninger; Swagger 2.0-beskrivelsen som Power Platform importerer, ligger på /api/v1/swagger.json.
• MCP-serveren på /mcp, for KI-assistenter.

#2026-10-12: v1.0

• Arrangementer, deltakere med svarene sine, bestillinger og skanninger ved inngangene i et arbeidsområde, med updatedSince.
• Påmelding av noen med gratisbillett, avbestilling av en billett og innsjekking av noen.
• Abonnementer for Power Automate, Zapier og Make (/hooks), og webhooks signert etter Standard Webhooks.
• Påmeldingsspørsmål, JSON-skjemaet deres, billettyper, innganger og nylige leads, for flytenes nedtrekkslister og felt.