Deux opérations sur les fichiers : déposer une image dans GREM pour la joindre à une annonce ou la transmettre à un outil, et récupérer le résultat généré par un outil.
URL de base : https://developers.grem.capital/api/v1.
Envoyer une image
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_..." }
Nécessite le scope media:write. Les envois ne sont pas facturés.
Limites :
| Paramètre | Valeur |
|---|---|
| Formats | JPG, PNG, WEBP |
| Un fichier | jusqu'à 15 MB ; au-delà - 413 |
| Fichiers par requête | jusqu'à 10 |
| Requête entière | jusqu'à 30 MB |
Les noms des champs du formulaire n'ont pas d'importance - envoyez autant de parties de fichier que les limites le permettent.
Placez les id renvoyés dans photos lors de la création ou de la modification d'une annonce (Annonces), et les url partout où un outil accepte des adresses de photos (pack de contenu, form.media.photos) :
{ "photos": ["<first file id>", "<second file id>"] }
Vous seul recevez le lien vers l'original. Une fois la photo jointe à une annonce publiée, le catalogue ne montre aux autres que les variantes avec filigrane.
Télécharger un résultat
Téléchargez les fichiers via le domaine GREM avec la même clé :
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path> \
-o presentation.pdf
Nécessite le scope tools:artifacts. Un téléchargement est un GET : il est donc gratuit et n'est pas compté comme un appel d'API.
Les téléchargements partiels via l'en-tête Range sont pris en charge : les vidéos et présentations volumineuses peuvent être récupérées par morceaux ou reprises.
La clé est nécessaire ici aussi : un lien d'artefact n'est pas public. Ne l'intégrez pas dans une page que voient vos visiteurs - servez plutôt le fichier depuis votre propre serveur.
Vous ne pouvez pas passer un chemin arbitraire : seuls les chemins de téléchargement des résultats et les fichiers /files/... sont acceptés, tout le reste renvoie 404. La liste complète des chemins se trouve dans Tâches et résultats.
Voir aussi
- Outils via l'API - ce qui crée ces fichiers.
- Annonces - la structure d'une annonce et de ses photos.
- Erreurs - codes de refus.