İki dosya işlemi: bir görseli bir ilana eklemek veya bir araca vermek için GREM'e koymak ve bir aracın oluşturduğu sonucu almak.
Temel adres: https://developers.grem.capital/api/v1.
Görsel yükleme
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 kapsamı gerekir. Yüklemeler ücretlendirilmez.
Sınırlar:
| Parametre | Değer |
|---|---|
| Biçimler | JPG, PNG, WEBP |
| Tek dosya | 15 MB'a kadar; daha büyük: 413 |
| İstek başına dosya | en fazla 10 |
| Tüm istek | 30 MB'a kadar |
Form alanlarının adları önemli değildir: sınırlara sığdığı kadar dosya parçası gönderin.
Dönen id değerlerini bir ilan oluştururken veya düzenlerken photos içine koyun (İlanlar); url değerlerini ise bir aracın fotoğraf adresi aldığı her yerde kullanın (içerik paketi, form.media.photos):
{ "photos": ["<ilk dosyanın kimliği>", "<ikinci dosyanın kimliği>"] }
Orijinalin bağlantısını yalnızca siz alırsınız. Fotoğraf yayınlanmış bir ilana eklendiğinde katalog, diğerlerine yalnızca filigranlı varyantları sunar.
Sonucu indirme
Dosyaları aynı anahtarla GREM alan adı üzerinden indirin:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path> \
-o presentation.pdf
tools:artifacts kapsamı gerekir. İndirme bir GET isteğidir, dolayısıyla ücretsizdir ve API çağrısı sayılmaz.
Range başlığıyla kısmi indirme desteklenir: büyük videolar ve sunumlar parça parça indirilebilir veya kaldığı yerden sürdürülebilir.
Burada da anahtar gerekir: bir sonuç bağlantısı herkese açık değildir. Ziyaretçilerinizin gördüğü bir sayfaya yerleştirmeyin; dosyayı kendi sunucunuzdan sunun.
Rastgele bir yol veremezsiniz: yalnızca sonuç indirme yolları ve /files/... dosyaları kabul edilir, geri kalan her şey 404 döndürür. Yolların tam listesi İşler ve sonuçlar sayfasındadır.
İlgili makaleler
- API üzerinden araçlar: bu dosyaları ne oluşturur.
- İlanlar: ilanın ve fotoğrafların biçimi.
- Hatalar: ret kodları.