OpenAPI Spezifikation
Jedes veröffentlichte API Projekt stellt automatisch ein gültiges OpenAPI 3.0 Dokument unter /openapi.json auf seiner Basis URL bereit, keine Einrichtung nötig. Es listet Pfad, Methode, und (für einen schlüsselgeschützten Endpunkt) dass ein Bearer Token nötig ist, für jeden aktivierten Endpunkt, plus ein echtes Request Body Schema und Beispielantworten, aus deinen Validate und Response Blöcken gebaut. Importiere diese URL direkt in Postman, Insomnia, oder jeden OpenAPI basierten Client Generator.
Einen Datei Upload akzeptieren
Sende eine Anfrage mit Content-Type: multipart/form-data, und alle Dateifelder werden automatisch hochgeladen, bevor die Logik deines Endpunkts läuft, der Wert des Feldes wird zur öffentlichen URL dieser Datei, nutzbar überall weiter unten im Ablauf (eine Database Query, ein Response Body) genau wie jedes andere Feld.
Eine Datei statt JSON zurückgeben
Der Typ eines Response oder Error Response Blocks kann auf Datei direkt ausliefern gesetzt werden (ruft eine von dir angegebene URL ab und gibt ihre tatsächlichen Bytes zurück, begrenzt auf 4 MB) oder Weiterleiten (schickt den Aufrufer direkt zur eigenen öffentlichen URL einer Datei, ohne Größenlimit, da nicht dein Endpunkt die Bytes ausliefert). Weiterleiten ist die bessere Wahl für alles, was 4 MB überschreiten könnte.