Dosyalarla iki işlem: bir görseli GREM'e yükleyip ilana ekleyebilmek ve bir aracın bitmiş çıktısını 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 "file=@photo.jpg"
{ "files": [ { "id": "…", "url": "…" } ], "requestId": "req_…" }
media:write kapsamını ister. Yükleme ücretlendirilmez.
Sınırlar:
| Parametre | Değer |
|---|---|
| Biçimler | JPG, PNG, WEBP |
| Tek dosya | en fazla 15 MB |
| İstek başına dosya | en fazla 10 |
| İsteğin tamamı | en fazla 30 MB |
Formdaki alan adlarının önemi yoktur - sınır içinde istediğiniz kadar dosya parçası gönderin.
Aldığınız kimlikler, ilanı oluştururken ya da düzenlerken photos alanına girer:
{ "photos": ["<first file id>", "<second file id>"] }
Yüklediğiniz özgün dosyayı yalnızca siz görürsünüz. Fotoğraf bir ilana eklendiği anda dışarıdaki okuyuculara yalnızca filigranlı sürümleri sunulur.
Biten sonucu alma
Araçlar dosya bağlantılarını göreli yollar olarak döndürür. Onları aynı anahtarla GREM alan adı üzerinden indirin:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path from the response> \
-o presentation.pdf
tools:artifacts kapsamını ister. İndirme bir GET olduğundan ü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 çekilebilir ya da kesintiden sonra sürdürülebilir.
Burada da anahtar gerekir: yapıt bağlantısı herkese açık değildir. Onu ziyaretçilerinizin açabileceği bir sayfaya gömmeyin - dosyayı kendi sunucunuzdan sunun.
Rastgele bir yol işe yaramaz: yalnızca bir aracın yanıtından çıkan adresler kabul edilir, geri kalan her şey 404 döndürür.
İlgili yazılar
- API üzerinden araçlar - bu dosyaları ne üretir.
- Nesneler (okuma) - ilanın ve fotoğraflarının yapısı.
- Hatalar - ret kodları.