Wiki-Quellcode von Schnittstellen
Version 98.2 von MACH formsolutions am 10.12.2024
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
91.1 | 1 | 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. |
| |
1.1 | 2 | |
| |
91.1 | 3 | ![[Schnittstellen|@Schnittstellen.jpg]] |
| 4 | |||
| |
98.2 | 5 | # Übersicht der APIs |
| |
91.1 | 6 | |
| |
98.2 | 7 | ## Aktuelle APIs |
| |
91.1 | 8 | |
| 9 | * Die Dokumentation zum Anlegen von „[[API-Keys|Main.02_FSSchnittstellen.09_API-Key]]“ für Nutzung der Schnittstellen | ||
| 10 | * Die Dokumentation der „[[Server-Information-API|Main.02_FSSchnittstellen.10_ServerInformationAPI]]“ | ||
| 11 | * Die Dokumentation der „[[Search-API|Main.02_FSSchnittstellen.03_SearchAPI]]“ | ||
| 12 | * Die Dokumentation der „[[Release-API|Main.02_FSSchnittstellen.02_ReleaseAPI]]“ | ||
| |
89.1 | 13 | * Die Dokumentation der „[[Submission-API|Main.02_FSSchnittstellen.01_SubmissionAPI]]“ |
| 14 | * Die Dokumentation der „[[Error-API|Main.02_FSSchnittstellen.04_ErrorAPI]]“ | ||
| |
93.1 | 15 | |
| |
98.2 | 16 | ## Veraltete APIs |
| |
93.1 | 17 | |
| 18 | * Die Dokumentation der „[[Search-API-Metaform|Main.02_FSSchnittstellen.06_SearchAPIMetaform]]“ | ||
| 19 | * Die Dokumentation der „[[Massenverarbeitung von Formular-Eingängen-API|Main.02_FSSchnittstellen.08_MassenverarbeitungAPI]]“ | ||
| |
89.1 | 20 | * Die Dokumentation der „[[CMS-Schnittstelle|Main.02_FSSchnittstellen.05_CMSSchnittstelle]]“ |
| 21 | * Die Dokumentation der „[[PDF Structure-API|Main.02_FSSchnittstellen.07_PDFStructureAPI]]“ | ||
| 22 | |||
| |
92.1 | 23 | # Versionierung |
| 24 | |||
| |
98.2 | 25 | Grundsätzlich legen wir unsere APIs für eine möglichst lange Betriebsphase aus und streben Versionskompatibilität an. Im Nachfolgenden finden Sie unsere Vorgehensweise im Detail. |
| |
94.1 | 26 | |
| |
98.2 | 27 | Wir behalten (soweit technisch möglich) immer zwei Versionen online. Sobald eine neue Version hinzukommt, wird die älteste Version mit einem zeitlichen Horizont von mindestens 6 Monaten abgekündigt. Nach dieser Frist ist die Version und alle ihre Minor-Versionen nicht mehr erreichbar. |
| |
94.1 | 28 | |
| |
97.1 | 29 | Eine neue **Major-Version (1.x)** kann Änderungen beinhalten, welche nicht mehr abwärtskompatibel sein müssen (Abhängig von Ihrer Implementierung). Dies sind z.B.: |
| |
94.1 | 30 | |
| |
97.1 | 31 | * Authentifizierungsmethoden |
| 32 | * Umbenennung und Löschung von Endpunkten | ||
| |
98.1 | 33 | * Löschung von HTTP-Methoden an vorhandenen Endpunkten |
| |
97.1 | 34 | * Umbenennung und Löschung von Parametern |
| 35 | * Restrukturierung des Response-Objekt | ||
| |
94.1 | 36 | |
| |
97.1 | 37 | Eine neue **Minor-Version (x.1)** ist per Definition abwärtskompatibel zur **Major-Version**. Dabei können sich aber folgende Dinge ändern: |
| |
94.1 | 38 | |
| 39 | * Zusätzliche Endpunkte | ||
| |
98.1 | 40 | * Zusätzliche HTTP-Methoden an Endpunkten |
| |
97.1 | 41 | * Weitere (optionale) Parameter für eine Abfrage (z.B. Filterfunktion) |
| 42 | * Erweitertes Response-Objekt | ||
| |
95.1 | 43 | |
| 44 | # Versionshistorie | ||
| 45 | |||
| |
96.1 | 46 | Zu jeder API finden Sie als Unterknoten jeweils den "Release-Notes"-Artikel. Beispiel [[Submission-API|doc:.01_SubmissionAPI.Release-Notes.WebHome]]. |