Medya içe aktarma

POST /apps/media/imports — scope (yetki) write_media, Idempotency-Key zorunlu.

Herkese açık görsel URL’leri gönderirsiniz; CIQRA bunları mağazanın medya kütüphanesine indirir ve başka yerlerde (örneğin bir metaobject alanında) kullanabileceğiniz asset id’lerini döndürür.

İstek

{ "urls": ["https://cdn.your-app.example/cars/1234/front.jpg", "…"] }

İstek başına 1 ile 100 arası URL.

CIQRA neyi kabul eder

Kural	Ayrıntı
Şema	yalnızca https
Adres	herkese açık adreslere çözümlenmelidir; özel (private), loopback ve link-local hedefler reddedilir (bağlantı anında yeniden denetlenir)
Yönlendirmeler	izlenmez — son URL’yi verin
Zaman aşımı	URL başına 30 saniye
Boyut	en fazla 20 MB
Tür	PNG, JPEG, GIF veya WebP; uzantıdan ya da Content-Type’tan değil, baytlardan tespit edilir

Yanıt — geçerli bir istek için her zaman 200

{
  "requested": 2, "succeeded": 2, "failed": 0, "fetched": 1,
  "results": [
    { "url": "https://…/front.jpg", "status": "imported", "mediaAssetId": "…", "assetUrl": "https://…" },
    { "url": "https://…/rear.jpg", "status": "already_present", "mediaAssetId": "…", "assetUrl": "https://…" }
  ]
}

status	Anlamı
imported	İndirildi ve yeni bir asset olarak kaydedildi.
already_present	Bu URL yakın zamanda (24 saat) içe aktarılmış; mevcut asset indirme yapılmadan döndürülür.
unchanged	İndirildi, ancak aynı baytlar zaten var; mevcut asset döndürülür.
failed	errorCode’a bakın.

errorCode	Anlamı
invalid_source_url	Mutlak bir https URL’si değil ya da reddedilen bir adresi gösteriyor.
source_unreachable	Bağlantı kurulamadı.
source_timeout	30 sn’den uzun sürdü.
source_unavailable	Kaynak başarısız bir durum koduyla yanıt verdi.
source_too_large	20 MB’ın üzerinde.
source_empty	Sıfır bayt.
unsupported_media_type	PNG, JPEG, GIF veya WebP değil.

fetched gerçekten yapılan indirmeleri sayar — tekilleştirmenin ne kadar tasarruf sağladığını görmek için işe yarar.