Ürün Medyası

1.6k görüntülenme Markdown

Ürünün galerisini, sipariş görselini ve teslimat dosyasını yöneten on bir uç.

Genel Bakış

Bir ürünün üç ayrı görsel varlığı vardır ve bunlar karıştırılmamalıdır. Galeri birden çok görsel taşır ve sıralanabilir; sipariş görseli tektir ve sipariş ekranında görünür; teslimat dosyası görsel değil, yazılım ürününün müşteriye verdiği dosyadır.

Yükleme uçlarının hiçbiri çok parçalı form beklemez. Dosyayı base64 veri adresi olarak gönderirsiniz ya da indirilebilir bir bağlantı verirsiniz; sunucu adresi kendisi çeker.

Referans

Galeriyi Listeleme

get/api/v1/admin/products/{id}/images
Products/GetProductImages admin sıralı

Ürünün galeri görsellerini sıralarına göre döndürür.

Dönen alanlar data[] — 7
idintGörsel kimliği.
typestringGörselin rolü: photo, header-background, cover ya da mockup.
sizestringOkunabilir dosya boyutu.
namestringSaklanan dosya adı.
urlstringGenel erişim adresi.
titlestringGörsel başlığı.
sort_orderintGalerideki sırası.
Hatalar 2
not_found404Ürün bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl 'https://panel.ornek.com/api/v1/admin/products/15/images' \
  -H "Authorization: Bearer $API_KEY"
const res  = await fetch('https://panel.ornek.com/api/v1/admin/products/15/images', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/images');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->GetProductImages(['id' => 15]);
Yanıt 
{
  "data": [
    {
      "id": 90,
      "type": "photo",
      "size": "120 KB",
      "name": "ab12.jpg",
      "url": "https://example.com/uploads/ab12.jpg",
      "title": "Screenshot",
      "sort_order": 1
    }
  ]
}

Galeriye Görsel Yükleme

post/api/v1/admin/products/{id}/images
Products/UploadProductImage admin 201

Galeriye görsel ekler. Dosyayı base64 olarak ya da bir adres vererek gönderirsiniz.

Gövde 3
imagestringzorunluGörsel. base64 veri adresi ya da indirilebilir bir bağlantı.
titlestringGörsel başlığı.
typestringGörselin rolü: photo, header-background, cover ya da mockup. Varsayılan photo.
Dönen alanlar data — 5
idintYeni eklenen görselin kimliği.
typestringGörselin saklandığı rol.
titlestringGörsel başlığı.
sort_orderintGalerideki sırası.
urlstringGenel erişim adresi.
Hatalar 5
not_found404Ürün bulunamadı.
file_required422Dosya alanı boş.
file_invalid422Dosya çözümlenemedi ya da tipi kabul edilmedi.
file_failed422Dosya saklanamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X POST 'https://panel.ornek.com/api/v1/admin/products/15/images' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"image":"data:image/png;base64,iVBORw0KGgo...","title":"Screenshot"}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/images', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    image: 'data:image/png;base64,iVBORw0KGgo...',
    title: 'Screenshot',
    type: 'photo',
  }),
});

const body = await res.json();
$data = base64_encode(file_get_contents('screenshot.png'));

$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/images');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'image' => 'data:image/png;base64,' . $data,
        'title' => 'Screenshot',
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Yuklenen gorsel galerinin SONUNA eklenir; sirayi ayri bir cagri belirler.
$image = Api::Products()->UploadProductImage([
    'id'    => 15,
    'image' => 'data:image/png;base64,' . base64_encode($bytes),
    'title' => 'Screenshot',
]);

Görseli Güncelleme

patch/api/v1/admin/products/{id}/images/{image_id}
Products/UpdateProductImage admin tip dosyayı taşır

Görselin başlığını ya da rolünü değiştirir. Rol değişince dosya klasörler arasında taşınır.

Gövde 2
titlestringYeni başlık. Gönderirseniz boş olamaz.
typestringYeni rol: photo, header-background, cover ya da mockup.
Dönen alanlar data — 2
updatedboolGüncelleme başarılı mı.
idintGörsel kimliği.
Hatalar 4
not_found404Ürün ya da görsel bulunamadı.
title_required422Başlık gönderildi ama boştu.
invalid_type422Rol izinli değerlerden değil.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PATCH 'https://panel.ornek.com/api/v1/admin/products/15/images/91' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title":"Dashboard","type":"cover"}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/images/91', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'Dashboard', type: 'cover' }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/images/91');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'title' => 'Dashboard',
        'type'  => 'cover',
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Rol degistirmek dosyayi tasir: eski adres artik calismaz.
$response = Api::Products()->UpdateProductImage([
    'id'       => 15,
    'image_id' => 91,
    'type'     => 'cover',
]);

Görseli Silme

delete/api/v1/admin/products/{id}/images/{image_id}
Products/DeleteProductImage admin

Galeriden tek bir görseli siler.

Dönen alanlar data — 2
deletedboolSilme başarılı mı.
idintSilinen görselin kimliği.
Hatalar 2
not_found404Ürün ya da görsel bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X DELETE 'https://panel.ornek.com/api/v1/admin/products/15/images/91' \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/images/91', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${apiKey}` },
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/images/91');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->DeleteProductImage([
    'id'       => 15,
    'image_id' => 91,
]);

Galeriyi Temizleme

delete/api/v1/admin/products/{id}/images
Products/ClearProductImages admin geri alınamaz

Ürünün tüm galeri görsellerini siler.

Dönen alanlar data — 1
clearedintSilinen görsel sayısı.
Hatalar 2
not_found404Ürün bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X DELETE 'https://panel.ornek.com/api/v1/admin/products/15/images' \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/images', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${apiKey}` },
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/images');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Adres tek gorsel silmekle AYNI, fark yalnizca gorsel kimliginin olmamasi.
$response = Api::Products()->ClearProductImages(['id' => 15]);

Galeriyi Sıralama

put/api/v1/admin/products/{id}/images/order
Products/ReorderProductImages admin tam liste

Galeri sırasını verdiğiniz kimlik listesine göre belirler.

Gövde 1
image_idsint[]zorunluGörsel kimlikleri, istediğiniz sırada.
Dönen alanlar data[] — 7
idintGörsel kimliği.
typestringGörselin rolü: photo, header-background, cover ya da mockup.
sizestringOkunabilir dosya boyutu.
namestringSaklanan dosya adı.
urlstringGenel erişim adresi.
titlestringGörsel başlığı.
sort_orderintGalerideki sırası.
Hatalar 3
not_found404Ürün bulunamadı.
ids_required422image_ids boş.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PUT 'https://panel.ornek.com/api/v1/admin/products/15/images/order' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"image_ids":[92,90,91]}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/images/order', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ image_ids: [92, 90, 91] }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/images/order');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['image_ids' => [92, 90, 91]]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Bir gorseli one almak icin bile TUM listeyi gonderin.
$ids = array_column(Api::Products()->GetProductImages(['id' => 15])['data'], 'id');
array_unshift($ids, array_pop($ids));

$response = Api::Products()->ReorderProductImages([
    'id'        => 15,
    'image_ids' => $ids,
]);

Teslimat Dosyasını Okuma

get/api/v1/admin/products/{id}/delivery-file
Products/GetProductDeliveryFile admin yazılım ürünleri

Yazılım ürününün müşteriye teslim edilen dosyasını döndürür.

Dönen alanlar data — 2
namestringSaklanan dosya adı.
sizestringOkunabilir dosya boyutu.
Hatalar 2
not_found404Ürün bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl 'https://panel.ornek.com/api/v1/admin/products/15/delivery-file' \
  -H "Authorization: Bearer $API_KEY"
const res  = await fetch('https://panel.ornek.com/api/v1/admin/products/15/delivery-file', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// Dosya yuklenmemisse data null gelir.
if (body.data === null) return;
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/delivery-file');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->GetProductDeliveryFile(['id' => 15]);

$file = $response['data'] ?? null;

Teslimat Dosyası Yükleme

put/api/v1/admin/products/{id}/delivery-file
Products/UploadProductDeliveryFile admin uzantı kısıtı var

Teslimat dosyasını yükler. Önceki dosya kaldırılır; ürün tek bir dosya taşır.

Gövde 1
filestringzorunluDosya. base64 veri adresi ya da indirilebilir bir bağlantı. Çalıştırılabilir sayfa uzantıları kabul edilmez.
Dönen alanlar data — 2
namestringSaklanan dosya adı.
sizestringOkunabilir dosya boyutu.
Hatalar 5
not_found404Ürün bulunamadı.
file_required422Dosya alanı boş.
file_invalid422Dosya çözümlenemedi ya da tipi kabul edilmedi.
file_failed422Dosya saklanamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PUT 'https://panel.ornek.com/api/v1/admin/products/15/delivery-file' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"file":"https://cdn.example.com/setup-v2.zip"}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/delivery-file', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ file: 'https://cdn.example.com/setup-v2.zip' }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/delivery-file');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'file' => 'https://cdn.example.com/setup-v2.zip',
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Yeni surum yuklemek eskisini kaldirir — once yedeklemek isteyebilirsiniz.
$response = Api::Products()->UploadProductDeliveryFile([
    'id'   => 15,
    'file' => 'https://cdn.example.com/setup-v2.zip',
]);

Teslimat Dosyasını Silme

delete/api/v1/admin/products/{id}/delivery-file
Products/DeleteProductDeliveryFile admin

Teslimat dosyasını kaldırır.

Dönen alanlar data — 2
deletedboolSilme başarılı mı.
idintÜrün kimliği.
Hatalar 2
not_found404Ürün bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X DELETE 'https://panel.ornek.com/api/v1/admin/products/15/delivery-file' \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/delivery-file', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${apiKey}` },
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/delivery-file');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->DeleteProductDeliveryFile(['id' => 15]);

Sipariş Görselini Ayarlama

put/api/v1/admin/products/{id}/order-image
Products/SetProductOrderImage admin tek görsel

Sipariş ekranında görünen görseli ayarlar. Ürün bundan bir tane taşır.

Gövde 1
imagestringzorunluGörsel. base64 veri adresi ya da indirilebilir bir bağlantı.
Dönen alanlar data — 1
urlstringGörselin genel adresi.
Hatalar 5
not_found404Ürün bulunamadı.
file_required422Dosya alanı boş.
file_invalid422Dosya çözümlenemedi ya da tipi kabul edilmedi.
file_failed422Dosya saklanamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PUT 'https://panel.ornek.com/api/v1/admin/products/15/order-image' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"image":"https://cdn.example.com/plan.png"}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/order-image', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ image: 'https://cdn.example.com/plan.png' }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/order-image');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'image' => 'https://cdn.example.com/plan.png',
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->SetProductOrderImage([
    'id'    => 15,
    'image' => 'https://cdn.example.com/plan.png',
]);

Sipariş Görselini Silme

delete/api/v1/admin/products/{id}/order-image
Products/DeleteProductOrderImage admin

Sipariş görselini kaldırır.

Dönen alanlar data — 2
deletedboolSilme başarılı mı.
idintÜrün kimliği.
Hatalar 2
not_found404Ürün bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X DELETE 'https://panel.ornek.com/api/v1/admin/products/15/order-image' \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/15/order-image', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${apiKey}` },
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/15/order-image');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->DeleteProductOrderImage(['id' => 15]);

Tuzaklar

Aynı adres tek görseli de tüm galeriyi de siler

Galeriyi temizleme ile tek görsel silme aynı adresi kullanır; tek fark sondaki görsel kimliğidir. Kimliği boş bir değişkenden kuran kod, silmek istediği tek görsel yerine galerinin tamamını siler.

Sıralamada listenin tamamı gönderilir

Sıralama ucu verdiğiniz listeyi sıra olarak kabul eder; listede olmayan görsellerin yeri belirsizleşir. Bir görseli öne almak için bile önce galeriyi okuyup tüm kimlikleri göndermek gerekir. Yeni yüklenen görsel her zaman listenin sonuna eklenir.

Rol değiştirmek dosyayı taşır

Bir görselin rolünü değiştirmek dosyayı klasörler arasında taşır, yani eski adresi çalışmaz hâle gelir. Adresi kendi tarafınızda sakladıysanız güncellemeden sonra yeniden okuyun.

Teslimat dosyası tekildir ve uzantı kısıtlıdır

Yeni bir teslimat dosyası yüklemek öncekini kaldırır; ürün aynı anda iki sürüm taşıyamaz. Ayrıca çalıştırılabilir sayfa uzantıları kabul edilmez: sunucuda çalışacak bir dosyayı müşteriye teslim etmenin yolu yoktur.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.

Bize Ulaşın Destek Talebi Oluştur

Oturumunuzu açık tutmak, dil ve para birimi tercihinizi hatırlamak ve siteyi geliştirmek için çerez kullanıyoruz. Çerez Politikası