Die MACH ProForms GmbH setzt bei der Produktstrategie auf den API-First Ansatz. D.h., dass perspektivisch alle Funktionen über eine API erreichbar und ansteuerbar sind.

Übersicht der API's

Aktuelle API's

• Die Dokumentation zum Anlegen von „API-Keys“ für Nutzung der Schnittstellen
• Die Dokumentation der „Server-Information-API“
• Die Dokumentation der „Search-API“
• Die Dokumentation der „Release-API“
• Die Dokumentation der „Submission-API“
• Die Dokumentation der „Error-API“

Veraltete API's

• Die Dokumentation der „Search-API-Metaform“
• Die Dokumentation der „Massenverarbeitung von Formular-Eingängen-API“
• Die Dokumentation der „CMS-Schnittstelle“
• Die Dokumentation der „PDF Structure-API“

Versionierung

Grundsätzlich legen wir unsere API's für eine möglichst lange Betriebsphase und somit für eine lange Versionskompatibilität aus. Im Nachfolgenden finden Sie unsere Vorgehensweise im Detail.

Wir behalten (soweit technisch möglich) immer die zwei Versionen online. Sobald eine neue Version hinzukommt, wird die älteste Version mit einem zeitlichen Horizont von mindestens 6 Monaten abgekündigt. Nach der Abkündigung wird die Version und alle beinhalteten Minor-Versionen nicht mehr erreichbar sein.

Eine neue Major-Version kann Änderungen beinhalten, welche nicht mehr abwärtskompatibel sein müssen. Dies sind z.B.:

• Zugang
• Endpunkte
• Parameter
• Response

Eine neue Minor-Version ist per Definition abwärtskompatibel zur Major-Version. Dabei können Sie aber folgende Dinge ändern:

• Zusätzliche Endpunkte
• Weitere Parameter für eine Abfrage (z.B. Filterfunktion)
• Erweitertes Response (weitere Ausgaben in der Antwort)

Versionshistorie

Zu jeder API finden Sie als Unterknoten jeweils den "Release-Notes"-Artikel. Beispiel Submission-API.