AttendBeacon
Arbeitsbereich öffnen

Mehr

Änderungsprotokoll und Versionierung

Was sich an der API wann geändert hat und wie AttendBeacon sie ändert, ohne zu zerstören, was Sie gebaut haben.

Versionierung

Die Version steht in der Adresse: /api/v1. Ein Flow oder eine Integration auf Basis von v1 wird nicht neu gebaut, wenn AttendBeacon sich ändert. Innerhalb von v1 gilt deshalb:

  • Hinzugefügt, nie weggenommen. Neue Operationen, neue Felder in Antworten, neue optionale Parameter, neue Werte einer Liste wie ein Webhook-Typ oder ein Fehlercode. Schreiben Sie Code, der ignoriert, was er nicht kennt.
  • Nie umbenannt oder entfernt: ein Feld, eine Operation, ein Scope, ein Fehlercode oder ein Webhook-Typ, sobald er ausgeliefert ist.
  • Eine inkompatible Änderung ist v2. Sie wird hier und per E-Mail an jeden Arbeitsbereich mit einem Schlüssel mindestens sechs Monate vor der Änderung von v1 angekündigt, und v1 funktioniert in diesen sechs Monaten weiter.
  • Was veraltet ist, wird in der OpenAPI-Beschreibung als deprecated markiert und hier aufgeführt, mit dem Datum, an dem es wegfällt.

Keine Änderungen in diesem Sinne sind: die Reihenfolge der Felder in einem Body, der Text von detail (verzweigen Sie anhand von code), neue Antwort-Header und die Korrektur einer Antwort, die dieser Dokumentation widersprach.

Die OpenAPI-3.1-Beschreibung unter /api/v1/openapi.json ist die API, wie sie jetzt ist; info.version ändert sich mit jeder Ergänzung.

15.10.2026: v1.1, die Entwicklerplattform

  • Scopes pro Bereich. Die Scopes eines Schlüssels bestehen jetzt aus einem Bereich und einer Zugriffsart (events:read, attendees:write), und personenbezogene Daten haben einen eigenen Scope, people:read. Zuvor erstellte Schlüssel behalten genau das, was sie konnten.
  • Schlüssel laufen ab und werden protokolliert. Ein Schlüssel kann nach 30, 90, 180 oder 365 Tagen ablaufen. Jeder Aufruf steht in der Aktivität der Schlüssel, auch die abgelehnten.
  • Problem Details. Ablehnungen sind application/problem+json nach RFC 9457 mit einem stabilen code; error bleibt neben detail für Flows erhalten, die vorher gebaut wurden.
  • Cursor und Synchronisierung. Jede Liste antwortet mit nextCursor und hasMore; Listen veränderlicher Einträge nehmen updatedSince an. page und pageSize funktionieren weiterhin dort, wo sie es bisher taten.
  • Sichere Wiederholungen und Änderungen. Idempotency-Key bei jedem POST; ETag bei einzelnen Ressourcen, If-None-Match und If-Match.
  • Ratenlimit-Header. RateLimit, RateLimit-Policy und X-RateLimit-* in jeder Antwort, Retry-After bei einem 429.
  • Neue Operationen: der Arbeitsbereich; Veranstaltungsentwürfe erstellen, ihre Grunddaten ändern und sie veröffentlichen; Veranstaltungsstatistik und Verkaufstempo; Ticketarten (und ihre Änderung), Zusatzleistungen und Rabattcodes (und ihre Erstellung); eine einzelne Bestellung; Suche nach Teilnehmenden; Zahlen an den Türen; Sessions (und ihr Hinzufügen und Ändern), Räume, Tracks und Vortragende; Sponsoren und Sponsorenstufen; Einreichungen beim Call for Speakers; Helferteam und Schichten; Umfragen, ihre Ergebnisse und Session-Bewertungen; Rechnungen und Gutschriften; die Budgetzusammenfassung; die Rangliste des Teilen-Kits; Communities und ihre Mitglieder; Webhook-Endpunkte, ihre Zustellungen, Tests und Geheimnisse sowie die Ereignistypen mit ihren Nutzlast-Schemas.
  • Module. Ein ausgeschaltetes Modul einer Veranstaltung antwortet an seinen Endpunkten mit 409 moduleOff. Das gilt auch für Türen, Türscans und das Einchecken (das Check-in-Modul) und für Leads (das Leads-Modul), die bisher geantwortet haben.
  • Personen. Ohne people:read sind Teilnehmende, Käufer, Helferteam und Mitglieder nur IDs; Leads und die Suche nach Teilnehmenden brauchen den Scope. Wer seine Daten gelöscht hat, ist erased, ohne personenbezogene Daten.
  • Beschreibungen. /api/v1/openapi.json ist jetzt OpenAPI 3.1, mit Beispielen und jeder Ablehnung; die Swagger-2.0-Beschreibung, die Power Platform importiert, liegt unter /api/v1/swagger.json.
  • Der MCP-Server unter /mcp, für KI-Assistenten.

12.10.2026: v1.0

  • Veranstaltungen, Teilnehmende mit ihren Antworten, Bestellungen und Türscans eines Arbeitsbereichs, mit updatedSince.
  • Jemanden mit einem kostenlosen Ticket anmelden, ein Ticket stornieren und jemanden einchecken.
  • Abonnements für Power Automate, Zapier und Make (/hooks) und nach Standard Webhooks signierte Webhooks.
  • Anmeldefragen, ihr JSON-Schema, Ticketarten, Türen und aktuelle Leads, für die Auswahllisten und Felder von Flows.

Die Anleitungen und diese Website sind in Ihrer Sprache. Die Beschreibungen in der API-Referenz selbst sind auf Englisch, so wie die API selbst spricht.