API-Änderungsprotokoll

Wir erweitern die API, ohne sie zu brechen: Neue Endpunkte, neue optionale Parameter und neue Antwortfelder können jederzeit erscheinen, ignorieren Sie also Felder, die Sie nicht kennen. Nichts wird an Ort und Stelle entfernt oder im Typ geändert. Alles, was eine Integration brechen würde, wird hier mindestens 12 Monate vorher angekündigt, mit Deprecation- und Sunset-Headern an den betroffenen Operationen und einer E-Mail an die Workspace-Inhaber, und das alte Format funktioniert diesen ganzen Zeitraum weiter. Die vollständigen Regeln stehen unter API-Versionierung und Abkündigung.

Einträge sind gruppiert als Hinzugefügt, Geändert, Abgekündigt und Entfernt. Bisher wurde nichts abgekündigt oder entfernt.

2026-11-06

Hinzugefügt

• Offizielle Client-Bibliotheken für PHP (helpfalcon/helpfalcon-php), Node.js (@helpfalcon/api) und Python (helpfalcon), generiert aus dem OpenAPI-Dokument, und eine Postman-Sammlung. Siehe Client-Bibliotheken.
• Profiles- und Events-API in der Zendesk-kompatiblen API, im Format von Zendesk: PUT /zd/api/v2/user_profiles?identifier=, GET /zd/api/v2/users/{user_id}/profiles, POST /zd/api/v2/user_profiles/events, GET /zd/api/v2/users/{user_id}/events und mehr. Profile aus mehreren Systemen werden über E-Mail, Telefon oder externe ID einem Kunden zugeordnet.
• App-Marktplatz: Entwickler reichen Apps, die auf dem App-Framework gebaut sind, zur Prüfung ein; Admins installieren geprüfte Apps mit einem Klick.
• Konfiguration als Code: GET und POST /zd/api/v2/helpfalcon/config.yaml holen und übertragen Felder, Formulare, Regeln, SLAs und Ansichten eines Kontos als YAML, mit Probelauf.
• Zendesk-kompatible API: Nutzer aktualisieren, show_many und löschen; Organisationen anlegen, aktualisieren, löschen und suchen; Zufriedenheitsbewertungen; Makros mit Anwenden; Ansichten mit Ausführen und Zählern; Suchexport.

1.0.0

• Erste öffentliche Version der REST-API (/api), dokumentiert in der API-Referenz, und der Zendesk-kompatiblen API (/zd/api/v2).