re:make docs
Servisler

re:bucket

Nesne depolama — yükleme, listeleme, imzalı bağlantı.

Dosyalarınız {proje}/{bucket}/{anahtar} altında tutulur. Bir proje yalnızca kendi ön ekine ulaşabilir; bu sınır her çağrıda sunucu tarafında zorlanır.

Bucket'ları Console'dan (re:bucket sekmesi) oluşturur ve silersiniz. SDK nesnelerle ilgilenir.

Nesneleri listele

Yetki: bucket:read
curl "https://api.remakeizmir.com/api/v1/sdk/bucket/assets/objects?prefix=gorseller/&delimiter=/" \
  -H "X-API-KEY: rk_..."
ParametreNe işe yarar
prefixYalnızca bu klasörün altını döndürür
delimiter/ verirseniz alt klasörler folders altında gruplanır
max_keysSayfa başına nesne (1–1000, varsayılan 100)
continuation_tokenSonraki sayfa imleci
{
  "success": true,
  "data": {
    "objects": [
      { "key": "gorseller/kapak.png", "size": 20481, "last_modified": "2026-09-08T19:01:32Z", "etag": "9f86d0…" }
    ],
    "folders": ["gorseller/2026/"]
  },
  "meta": { "next_token": "1/xyz…" }
}

meta.next_token doluysa devamı var — aynı isteği continuation_token ile tekrarlayın.

İmzalı bağlantı

Yükleme ve indirme imzalı URL ile yapılır. Anahtarınız sunucunuzda kalır, tarayıcı yalnızca süreli bir bağlantı görür.

curl -X POST https://api.remakeizmir.com/api/v1/sdk/bucket/assets/presign \
  -H "X-API-KEY: rk_..." -H "Content-Type: application/json" \
  -d '{"key":"gorseller/kapak.png","method":"PUT","expires_in":3600}'
{ "success": true, "data": { "url": "https://…", "expires_at": "2026-09-08T20:01:32Z" } }

method ne isterseniz odur: indirme için GET, yükleme için PUT. expires_in saniyedir (60–86400, varsayılan 3600).

PUT ve DELETE imzalamak bucket:write ister. Yalnızca okuma yetkisi olan bir anahtar yazma bağlantısı üretemez — tarayıcıya verdiğiniz anahtarın sızması durumunda dosyalarınız yazılamaz kalır.

Dönen URL'ye dosyayı doğrudan gönderin:

curl -X PUT "<presign_url>" \
  -H "Content-Type: image/png" \
  --data-binary @kapak.png

Nesne sil

Yetki: bucket:write
curl -X DELETE https://api.remakeizmir.com/api/v1/sdk/bucket/assets/objects/gorseller/kapak.png \
  -H "X-API-KEY: rk_..."

Anahtardaki / işaretleri yol yapısıdır, olduğu gibi bırakın — %2F olarak kodlarsanız başka bir nesneyi işaret eder ve silme sessizce hiçbir şeye dokunmaz.

Sınırlar

  • Tek nesne için yükleme sınırı 100 MB.
  • Yüklenen içeriğin türü ilk baytlarından doğrulanır. Beyan ettiğiniz Content-Type gerçek içerikle uyuşmazsa istek 415 ile reddedilir.
  • Bucket'ta nesne varken silinemez; önce içini boşaltın.

On this page