Medien
Laden Sie Rasterbilder mit `POST /api/v1/media` hoch; eine optionale `portfolio_id` beim Erstellen ordnet das Medium in einem Schritt einem Portfolio zu.
Medien erstellen
POST /api/v1/media
Authorization: Bearer …
Content-Type: multipart/form-data
Idempotency-Key: …
| Feld | v1 |
|---|---|
| Datei | Rasterbild (siehe Unterstützte Dateitypen) |
title | Optional; standardmäßig aus dem Dateinamen |
portfolio_id | Optional; erfordert portfolios:write; für vertrauliche Portfolios empfohlen |
Unterstützte Dateitypen
| Zulässig | Nicht in v1 |
|---|---|
| JPEG, PNG, GIF, WebP, TIFF | RAW, SVG, Video, PDF |
Die offiziellen Clients für Lightroom, Capture One und Photoshop exportieren derzeit JPEG beim Veröffentlichen. Individuelle Integratoren können alle oben aufgeführten zulässigen Typen hochladen.
Die Plattform ergänzt EXIF-Daten aus der hochgeladenen Datei. Bildunterschrift/Beschreibung beim Erstellen und RAW-Uploads sind nicht Bestandteil von v1.
Medien lesen
GET /api/v1/media/{id}
Erfordert media:read und Zugriff des Arbeitsbereichs auf den Datensatz.
v1-Grenzen
- Nur Raster-Uploads (kein Video über diesen Endpunkt in v1)
- Keine Erstellung von Kampagnen, Impact Records oder Seiten-HTML über den Ingest-Client
- Dieselben Datenschutzregeln wie beim Dashboard-Upload (IUCN, Embargo,
storage_class)
Resumierbare Upload-Sitzungen für große Dateien können später folgen (POST …/media/uploads → abschließen).