Dos operaciones con archivos: subir una imagen a GREM para poder adjuntarla a un anuncio, y recoger el resultado terminado de una herramienta.
Dirección base: https://developers.grem.capital/api/v1.
Subir una imagen
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_…" }
Requiere el alcance media:write. La subida no se cobra.
Límites:
| Parámetro | Valor |
|---|---|
| Formatos | JPG, PNG, WEBP |
| Un archivo | hasta 15 MB |
| Archivos por petición | hasta 10 |
| La petición entera | hasta 30 MB |
Los nombres de los campos del formulario no importan: envíe tantas partes de archivo como quiera dentro del límite.
Los identificadores que recibe van al campo photos al crear o editar un anuncio:
{ "photos": ["<first file id>", "<second file id>"] }
El original que ha subido solo lo ve usted. En cuanto la foto se adjunta a un anuncio, a los lectores externos se les sirven únicamente las variantes con marca de agua.
Recoger un resultado terminado
Las herramientas devuelven los enlaces a los archivos como rutas relativas. Descárguelos por el dominio de GREM con la misma clave:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path from the response> \
-o presentation.pdf
Requiere el alcance tools:artifacts. La descarga es un GET, así que es gratis y no cuenta como llamada de API.
Se admiten descargas parciales con la cabecera Range: los vídeos y presentaciones grandes se pueden traer por trozos o reanudar tras un corte.
Aquí también hace falta la clave: el enlace a un artefacto no es público. No lo incruste en una página que puedan abrir sus visitantes: sirva el archivo desde su propio servidor.
Una ruta arbitraria no funciona: solo se aceptan direcciones que hayan salido de la respuesta de una herramienta; lo demás devuelve 404.
Artículos relacionados
- Herramientas por la API: lo que genera estos archivos.
- Objetos (lectura): la forma de un anuncio y sus fotos.
- Errores: los códigos de rechazo.