Ändringslogg och versionshantering

#Versionshantering

Versionen finns i adressen: /api/v1. Ett flöde eller en integration som bygger på v1 behöver inte byggas om när AttendBeacon ändras, så inom v1 gäller:

• Läggs till, tas aldrig bort. Nya operationer, nya fält i svar, nya valfria parametrar, nya värden i en lista som en webhook-typ eller en felkod. Skriv kod som ignorerar det den inte känner till.
• Byter aldrig namn och tas aldrig bort: ett fält, en operation, en behörighet, en felkod eller en webhook-typ, när den väl har släppts.
• En ändring som förstör är v2. Den meddelas här och via e-post till varje arbetsyta med en nyckel minst sex månader innan v1 ändras, och v1 fortsätter att fungera under de sex månaderna.
• Det som fasas ut markeras deprecated i OpenAPI-beskrivningen och listas här, med datumet då det försvinner.

Inte ändringar i den här meningen: ordningen på fälten i en brödtext, texten i detail (förgrena på code), nya svarshuvuden och rättelser av ett svar som motsade den här dokumentationen.

OpenAPI 3.1-beskrivningen på /api/v1/openapi.json är API:t som det är nu; info.version ändras vid varje tillägg.

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

• Behörigheter per område. En nyckels behörigheter är nu ett område och en åtkomst (events:read, attendees:write), och personuppgifter har en egen behörighet, people:read. Nycklar som skapats tidigare kan göra exakt det de kunde förut.
• Nycklar upphör och loggas. En nyckel kan upphöra efter 30, 90, 180 eller 365 dagar. Varje anrop finns i Nycklarnas aktivitet, avvisningar inräknade.
• Problem details. Avvisningar är RFC 9457 application/problem+json med en stabil code; error finns kvar bredvid detail för flöden som byggts tidigare.
• Markörer och synkronisering. Varje lista svarar med nextCursor och hasMore; listor med saker som ändras tar updatedSince. page och pageSize fungerar fortfarande där de gjorde det.
• Säkra omförsök och ändringar. Idempotency-Key på varje POST; ETag på enskilda resurser, If-None-Match och If-Match.
• Huvuden för anropsgränsen. RateLimit, RateLimit-Policy och X-RateLimit-* på varje svar, Retry-After vid en 429.
• Nya operationer: arbetsytan; skapa evenemangsutkast, ändra deras grunduppgifter och publicera dem; evenemangsstatistik och försäljningstakten; biljettyper (och ändra dem), tillval och rabattkoder (och skapa dem); en beställning; sök deltagare; antal per entré; sessioner (och lägga till och ändra dem), rum, spår och talare; sponsorer och sponsornivåer; förslag till talarutlysningen; personal och pass; enkäter, deras resultat och betyg på sessioner; fakturor och kreditnotor; budgetsammanfattningen; delningskitets topplista; gemenskaper och deras medlemmar; webhook-slutpunkter, deras leveranser, tester och hemligheter, och händelsetyperna med scheman för deras innehåll.
• Moduler. En avstängd modul i ett evenemang svarar 409 moduleOff på sina slutpunkter. Det gäller nu också entréer, skanningar vid entréer och incheckning (incheckningsmodulen) och leads (leadsmodulen), som svarade förut.
• Personer. Utan people:read är deltagare, köpare, personal och medlemmar id:n; leads och sökning bland deltagare kräver den. Den som har raderat sina uppgifter är erased, utan något personligt.
• Beskrivningar. /api/v1/openapi.json är nu OpenAPI 3.1, med exempel och alla avvisningar; Swagger 2.0-beskrivningen som Power Platform importerar finns på /api/v1/swagger.json.
• MCP-servern på /mcp, för AI-assistenter.

#2026-10-12: v1.0

• Evenemang, deltagare med deras svar, beställningar och skanningar vid entréer i en arbetsyta, med updatedSince.
• Anmäla någon med en gratisbiljett, avboka en biljett och checka in någon.
• Prenumerationer för Power Automate, Zapier och Make (/hooks), och webhooks signerade enligt Standard Webhooks.
• Anmälningsfrågor, deras JSON-schema, biljettyper, entréer och senaste leads, för flödenas väljare och fält.