Zwei Arbeiten mit Dateien: ein Bild zu GREM hochladen, um es an ein Inserat zu hängen, und das fertige Ergebnis eines Werkzeugs abholen.
Grundadresse: 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 "file=@photo.jpg"
{ "files": [ { "id": "…", "url": "…" } ], "requestId": "req_…" }
Braucht den Geltungsbereich media:write. Das Hochladen wird nicht berechnet.
Grenzen:
| Parameter | Wert |
|---|---|
| Formate | JPG, PNG, WEBP |
| Eine Datei | bis 15 MB |
| Dateien je Anfrage | bis 10 |
| Die ganze Anfrage | bis 30 MB |
Die Namen der Felder im Formular spielen keine Rolle - schicken Sie innerhalb der Grenze beliebig viele Dateiteile.
Die zurückgegebenen Kennungen kommen beim Anlegen oder Bearbeiten eines Inserats in das Feld photos:
{ "photos": ["<first file id>", "<second file id>"] }
Das hochgeladene Original sehen nur Sie. Sobald das Foto an einem Inserat hängt, bekommen fremde Leser nur die Varianten mit Wasserzeichen.
Ein fertiges Ergebnis abholen
Die Werkzeuge geben Links auf Dateien als relative Wege zurück. Laden Sie sie mit demselben Schlüssel über die Domain von GREM herunter:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path from the response> \
-o presentation.pdf
Braucht den Geltungsbereich tools:artifacts. Ein Herunterladen ist ein GET, also kostenlos und kein API-Aufruf.
Teilweises Herunterladen über den Kopf Range wird unterstützt: Große Videos und Präsentationen lassen sich in Stücken holen oder nach einem Abbruch fortsetzen.
Auch hier braucht es den Schlüssel: Der Link auf ein Artefakt ist nicht öffentlich. Betten Sie ihn nicht in eine Seite ein, die Ihre Besucher öffnen können - liefern Sie die Datei stattdessen von Ihrem eigenen Server aus.
Ein beliebiger Weg funktioniert nicht: Angenommen werden nur Adressen, die aus der Antwort eines Werkzeugs stammen, alles andere gibt 404 zurück.
Verwandte Artikel
- Werkzeuge über die API - was diese Dateien erzeugt.
- Objekte (Lesen) - der Aufbau eines Inserats und seiner Fotos.
- Fehler - die Codes der Ablehnungen.