Дві операції з файлами: покласти зображення в 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 "file=@photo.jpg"
{ "files": [ { "id": "…", "url": "…" } ], "requestId": "req_…" }
Потрібен scope media:write. Завантаження не списується з гаманця.
Обмеження:
| Параметр | Значення |
|---|---|
| Формати | JPG, PNG, WEBP |
| Розмір одного файлу | до 15 МБ |
| Файлів за один запит | до 10 |
| Розмір усього запиту | до 30 МБ |
Імена полів у формі значення не мають - надішліть скільки завгодно частин із файлами в межах ліміту.
Отримані id підставляються у поле photos під час створення або зміни оголошення:
{ "photos": ["<id першого файлу>", "<id другого файлу>"] }
Завантажений вами оригінал бачите тільки ви. Щойно фотографія прикріплюється до оголошення, зовнішнім читачам віддаються лише варіанти з водяним знаком.
Забрати готовий результат
Інструменти повертають посилання на файли відносними шляхами. Скачуйте їх через домен GREM тим самим ключем:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<шлях із відповіді> \
-o presentation.pdf
Потрібен scope tools:artifacts. Скачування - це GET, тож воно безкоштовне і не рахується викликом API.
Підтримується часткове завантаження за заголовком Range: великі відео й презентації можна тягнути частинами або відновлювати перерване скачування.
Ключ потрібен і тут: посилання на артефакт не є публічним. Не вбудовуйте його в сторінку, доступну відвідувачам, - краще віддавайте файл зі свого сервера.
Довільний шлях підставити не вийде: приймаються лише адреси з відповідей інструментів, усе інше повертає 404.
Пов'язані статті
- Інструменти через API - що саме створює ці файли.
- Обʼєкти (читання) - форма оголошення і його фотографій.
- Помилки - коди відмов.