Fayllarla iki əməliyyat var: şəkli GREM-ə yükləyib obyektə əlavə etmək və ya alətə ötürmək, həmçinin alətin hazırladığı nəticəni götürmək.
Baza URL: https://developers.grem.capital/api/v1.
Şəklin yüklənməsi
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_..." }
media:write icazəsi lazımdır. Yükləmələr üçün ödəniş tutulmur.
Limitlər:
| Parametr | Dəyər |
|---|---|
| Formatlar | JPG, PNG, WEBP |
| Bir fayl | 15 MB-a qədər; daha böyük - 413 |
| Sorğuda fayl sayı | 10-a qədər |
| Bütün sorğu | 30 MB-a qədər |
Forma sahələrinin adları önəmli deyil - limitlərə sığan qədər fayl hissəsi göndərin.
Qaytarılan id-ləri obyekti yaradarkən və ya redaktə edərkən photos sahəsinə qoyun (Obyektlər), url-ləri isə alətin foto ünvanları qəbul etdiyi yerlərdə istifadə edin (kontent paketi, form.media.photos):
{ "photos": ["<first file id>", "<second file id>"] }
Orijinala keçidi yalnız siz alırsınız. Foto dərc olunmuş obyektə əlavə edildikdən sonra kataloq digərlərinə yalnız su nişanlı variantları göstərir.
Nəticənin endirilməsi
Faylları eyni açarla GREM domeni vasitəsilə endirin:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path> \
-o presentation.pdf
tools:artifacts icazəsi lazımdır. Endirmə GET sorğusudur, ona görə pulsuzdur və API çağırışı kimi sayılmır.
Range başlığı ilə hissə-hissə endirmə dəstəklənir: böyük videoları və təqdimatları hissələrlə götürmək və ya endirməni davam etdirmək olar.
Burada da açar lazımdır: artefakt keçidi açıq deyil. Onu ziyarətçilərinizin gördüyü səhifəyə yerləşdirməyin - faylı öz serverinizdən verin.
İxtiyari yol ötürmək olmaz: yalnız nəticələrin endirmə yolları və /files/... faylları qəbul edilir, qalan hər şey 404 qaytarır. Yolların tam siyahısı Tapşırıqlar və nəticələr səhifəsindədir.
Əlaqəli
- API vasitəsilə alətlər - bu faylları nə yaradır.
- Obyektlər - obyektin və fotoların strukturu.
- Xətalar - imtina kodları.