Dos operaciones con archivos: poner una imagen en GREM para adjuntarla a un inmueble o pasarla a una herramienta, y recoger el resultado generado por 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 "[email protected]"
{ "files": [ { "id": "...", "url": "..." } ], "requestId": "req_..." }
Requiere el ámbito media:write. Las subidas no se cobran.
Límites:
| Parámetro | Valor |
|---|---|
| Formatos | JPG, PNG, WEBP |
| Un archivo | hasta 15 MB; más grande: 413 |
| Archivos por solicitud | hasta 10 |
| Solicitud completa | hasta 30 MB |
Los nombres de los campos del formulario no importan: envíe tantas partes de archivo como quepan en los límites.
Ponga los id devueltos en photos al crear o editar un inmueble (Inmuebles), y las url donde una herramienta acepte direcciones de fotos (paquete de contenido, form.media.photos):
{ "photos": ["<id del primer archivo>", "<id del segundo archivo>"] }
El enlace al original solo lo recibe usted. Cuando la foto se adjunta a un inmueble publicado, el catálogo sirve a los demás solo las variantes con marca de agua.
Descargar un resultado
Descargue los archivos a través del dominio de GREM con la misma clave:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path> \
-o presentation.pdf
Requiere el ámbito tools:artifacts. Una descarga es un GET, así que es gratuita y no cuenta como llamada a la API.
Se admiten descargas parciales con el encabezado Range: los vídeos y presentaciones grandes se pueden descargar por partes o reanudar.
Aquí también hace falta la clave: un enlace a un resultado no es público. No lo incruste en una página que vean sus visitantes; sirva el archivo desde su propio servidor.
No se puede pasar una ruta arbitraria: solo se aceptan rutas de descarga de resultados y archivos /files/...; todo lo demás devuelve 404. La lista completa de rutas está en Trabajos y resultados.
Artículos relacionados
- Herramientas por API: qué crea estos archivos.
- Inmuebles: la forma del inmueble y de las fotos.
- Errores: códigos de rechazo.