Две операции с файлами: положить изображение в GREM, чтобы потом прикрепить его к объявлению или передать инструменту, и забрать готовый результат работы инструмента.
Базовый URL: https://developers.grem.capital/api/v1.
Загрузить изображение
curl -X POST https://developers.grem.capital/api/v1/uploads \
-H "Authorization: Bearer gsk_live_xxx" \
-F "[email protected]"
{ "files": [ { "id": "...", "url": "..." } ], "requestId": "req_..." }
Нужна область media:write. Загрузка не списывается с кошелька.
Ограничения:
| Параметр | Значение |
|---|---|
| Форматы | JPG, PNG, WEBP |
| Размер одного файла | до 15 МБ; больше - 413 |
| Файлов за один запрос | до 10 |
| Размер всего запроса | до 30 МБ |
Имена полей в форме значения не имеют - отправьте сколько угодно частей с файлами в пределах лимита.
Полученные id подставляются в поле photos при создании или изменении объявления (Объекты), а url - туда, где инструмент принимает адреса фото (пакет контента, form.media.photos):
{ "photos": ["<id первого файла>", "<id второго файла>"] }
Ссылку на оригинал получаете только вы. Как только фотография прикрепляется к опубликованному объявлению, каталог отдает другим только варианты с водяным знаком.
Забрать готовый результат
Скачивайте файлы через домен GREM тем же ключом:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<путь> \
-o presentation.pdf
Нужна область tools:artifacts. Скачивание - это GET, поэтому оно бесплатное и не считается вызовом API.
Поддерживается частичная загрузка по заголовку Range: большие видео и презентации можно тянуть частями или возобновлять прерванное скачивание.
Ключ нужен и здесь: ссылка на артефакт не публичная. Не встраивайте ее в страницу, доступную посетителям, - лучше отдавайте файл со своего сервера.
Произвольный путь подставить не получится: принимаются только пути скачивания результатов и файлов /files/..., все остальное возвращает 404. Полный список путей - в статье Задачи и результаты.
Связанные статьи
- Инструменты через API - что именно создает эти файлы.
- Объекты - форма объявления и его фотографий.
- Ошибки - коды отказов.