Zum Inhalt springen

Dateien

Du kannst pro Anfrage eine PNG-, JPEG-, WebP- oder PDF-Datei mit 1 Byte bis 4 MiB hochladen. Der angegebene MIME-Typ muss zur Dateisignatur passen. Sende die Dateidaten; externe URLs und Dateipfade auf dem Server werden nicht akzeptiert.

Dateien über 4 MiB (4.194.304 Bytes) liefern bei REST HTTP 413, bevor das Backend aufgerufen wird. MCP lehnt zu große Eingaben für upload_file mit einem Eingabe- oder Tool-Fehler ab, bevor REST aufgerufen wird. Die Grenze gilt für die dekodierten Dateidaten.

Terminal-Fenster
curl -X POST "$GLASSWISE_API_BASE_URL/v1/files" \
-H "Authorization: Bearer $TOKEN" \
-F "upload_id=$UPLOAD_UUID" \
-F "workspace_id=$WORKSPACE_ID" \
-F "purpose=image" \
-F "file=@bottle.png;type=image/png"

Erzeuge vor der Anfrage eine neue UUID für upload_id. Wiederholst du die Anfrage mit demselben Workspace, Zweck, Dateinamen, MIME-Typ und denselben Bytes, erhältst du dieselbe Datei. Eine geänderte Anfrage oder ein noch laufender Upload liefert 409. Alle vier Multipart-Felder sind Pflicht. Doppelte oder zusätzliche Felder, leere Dateien und null-Werte werden abgelehnt.

Die Antwort enthält id, name, mime_type und size in Bytes. Ein Upload verknüpft oder veröffentlicht die Datei noch nicht. Verwende ihre id in einer bestehenden Ressourcenoperation, etwa als image_id eines Flaschenformats. Die Ressource muss zum Workspace und zum Zweck des Uploads passen, auch wenn du Mitglied beider Workspaces bist.

Zweck Vorgesehene Verknüpfung
image Flaschenbilder, Originalbilder, Weingutslogos und andere Bildfelder; PNG, JPEG oder WebP
inspection_report Prüfbericht eines Labels; PDF
certificate Zertifikatsdatei; PNG, JPEG, WebP oder PDF
asset Mediendatei; Bild oder PDF
conformity_declaration Konformitätserklärung; PDF
data_sheet Datenblatt; PDF
qr, export Einzelne Dateien in den unterstützten Upload-Formaten

Die Zwecke beschreiben die Zuordnung einer Datei. Sie fügen keine Operationen zum Anlegen von Ressourcen, Erzeugen von QR-Codes oder Exportieren hinzu. Bestehende Dateien, auf die du zugreifen darfst, kannst du unabhängig vom Upload-Format herunterladen, auch erzeugte ZIP- und Tabellenexporte.

GET /v1/files/{id} liefert Metadaten. GET /v1/files/{id}/download liefert { "url": "https://…", "expires_in": 60 }. Die Gültigkeit kann kürzer sein. Folge dem Link für die Dateidaten. Jede Person mit diesem Link kann ihn bis zum Ablauf nutzen. Danach forderst du einen neuen Link an. Die Antworten dürfen nicht zwischengespeichert werden.

Aktuelle Workspace-Mitglieder können verwaltete Uploads lesen. Auf bestehende Dateien greifst du über eine verknüpfte Ressource in einem deiner Workspaces zu. Bestehende, nicht verknüpfte Exporte kann nur die Person abrufen, die sie erzeugt hat. Ein öffentlicher Speicherbereich allein erlaubt keinen Zugriff über diese API. Unbekannte und nicht zugängliche Datei-IDs liefern 404. Dateioperationen geben dir keine zusätzlichen Rechte zum Veröffentlichen oder zur Nutzung kostenpflichtiger Ressourcenfunktionen.

Verknüpfte Präsentationsdateien kann jede Person über ihre direkte Datei-URL lesen: Flaschen- und Formatbilder, aufbewahrte Originalbilder, Weinbilder, Firmenlogos in allen Rollen (auch Erzeuger, Abfüller und Vertrieb), Veranstaltungsbilder, Team-, Auszeichnungs- und Produktkartenbilder im Media-Kit, Mediendateien und Zertifikate. Das gilt auch für Präsentationsbilder und Media-Kits im Entwurf, damit die bestehenden Vorschauen und der PDF-Renderer sie anzeigen können. Datenblätter und Konformitätserklärungen werden erst über ein veröffentlichtes Label öffentlich. Prüfberichte bleiben auch bei veröffentlichten Labels privat. Nicht verknüpfte verwaltete Uploads bleiben aktuellen Workspace-Mitgliedern vorbehalten. Zertifikate aus dem gemeinsamen Katalog kannst du über diese API herunterladen, wenn ein Label deines Workspaces sie verwendet.

DELETE /v1/files/{id} entfernt nur deinen eigenen verwalteten Upload, solange du Mitglied seines Workspaces bist. Löse zuerst alle Ressourcenverknüpfungen. Jede verbleibende Verknüpfung, auch aus einer Galerie, Erklärung oder einem gemeinsam genutzten Bild, führt zu 409. Die Dateioperation löst keine Verknüpfungen für dich. Dateien aus älteren Abläufen entfernst du über die zugehörige Ressource.

Nach erfolgreicher Löschung erhältst du { "deleted": true }. Eine Wiederholung liefert dasselbe Ergebnis. Schlägt das Entfernen der Dateidaten fehl, kannst du DELETE wiederholen. Einen abgebrochenen Upload kannst du nach zehn Minuten über seine upload_id entfernen. Während des Uploads oder der Bereinigung lässt sich die Datei weder verknüpfen noch herunterladen. Verwende nach der Bereinigung eine neue Upload-UUID. Nicht verknüpfte Uploads laufen nicht automatisch ab.

Nutze upload_file mit upload_id, workspace_id, purpose, name, mime_type und content_base64. Auch hier gelten 4 MiB für die dekodierten Bytes. get_file, get_file_download und delete_file erwarten id. Der Connector sendet Multipart-Dateidaten an die API und liefert Download-Links statt großer Base64-Antworten.