Zwei Dateioperationen: ein Bild in GREM ablegen, um es an ein Objekt anzuhängen oder einem Werkzeug zu übergeben, und das erzeugte Ergebnis eines Werkzeugs abholen.
Basisadresse: https://developers.grem.capital/api/v1.
Ein Bild hochladen
curl -X POST https://developers.grem.capital/api/v1/uploads \
-H "Authorization: Bearer gsk_live_xxx" \
-F "[email protected]"
{ "files": [ { "id": "...", "url": "..." } ], "requestId": "req_..." }
Braucht den Bereich media:write. Uploads werden nicht berechnet.
Grenzen:
| Parameter | Wert |
|---|---|
| Formate | JPG, PNG, WEBP |
| Eine Datei | bis 15 MB; größer - 413 |
| Dateien pro Anfrage | bis 10 |
| Gesamte Anfrage | bis 30 MB |
Die Namen der Formularfelder spielen keine Rolle - senden Sie so viele Dateiteile, wie in die Grenzen passen.
Die zurückgegebenen id setzen Sie beim Erstellen oder Ändern eines Objekts in photos ein (Objekte), die url überall dort, wo ein Werkzeug Fotoadressen nimmt (Content-Paket, form.media.photos):
{ "photos": ["<ID der ersten Datei>", "<ID der zweiten Datei>"] }
Den Link zum Original erhalten nur Sie. Sobald das Foto an ein veröffentlichtes Objekt angehängt ist, liefert der Katalog anderen nur die Varianten mit Wasserzeichen.
Ein Ergebnis herunterladen
Laden Sie Dateien über die GREM-Domain mit demselben Schlüssel herunter:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path> \
-o presentation.pdf
Braucht den Bereich tools:artifacts. Ein Download ist ein GET, also kostenlos, und zählt nicht als API-Aufruf.
Teil-Downloads über den Header Range werden unterstützt: Große Videos und Präsentationen lassen sich in Teilen laden oder fortsetzen.
Auch hier ist der Schlüssel nötig: Ein Ergebnislink ist nicht öffentlich. Binden Sie ihn nicht in eine Seite ein, die Ihre Besucher sehen - liefern Sie die Datei stattdessen von Ihrem eigenen Server aus.
Ein beliebiger Pfad ist nicht möglich: Akzeptiert werden nur Downloadpfade von Ergebnissen und Dateien unter /files/..., alles andere ergibt 404. Die vollständige Pfadliste steht in Aufträge und Ergebnisse.
Verwandte Artikel
- Werkzeuge über die API - was diese Dateien erzeugt.
- Objekte - die Form von Objekt und Fotos.
- Fehler - Ablehnungscodes.