Add-on Tanımları

1.7k görüntülenme Markdown

Katalogdaki add-on tanımlarını, seçeneklerini, ikonlarını ve kategorilerini yöneten on bir uç.

Genel Bakış

Add-on tanımı, bir ürünün yanında satılan seçeneğin şablonudur: ek disk, otomatik yedekleme, ek lisans. Müşterinin hizmetine eklenmiş olan add-on bundan farklı bir şeydir; burada katalogdaki tanımı yönetirsiniz.

Bir tanımın içinde seçenekler vardır ve asıl fiyat oradadır. Seçenekler dil altında yaşar, çünkü adları çevrilir; fiyat ise para birimi başına ayrı tutulur.

Son dört uç add-on kategorilerini yönetir. Kategori tek başına bir şey yapmaz, add-on kataloğunu düzenler.

Referans

Add-on Tanımlarını Listeleme

get/api/v1/admin/products/addons
Products/GetProductAddons admin sayfalı

Katalogdaki add-on tanımlarını döndürür.

Sorgu parametreleri 5
groupstringAna grup anahtarına göre süzer.
categoryintAdd-on kategorisine göre süzer.
searchstringAdd-on adında arar.
pageintVarsayılan 1.
limitintVarsayılan 25, en çok 100.
Dönen alanlar data[] — 9
idintAdd-on kimliği.
namestringAdd-on adı, geçerli dilde.
descriptionstringAçıklama.
groupstringAna grup anahtarı.
categoryintAdd-on kategorisinin kimliği.
statusstringactive ya da inactive.
rankintGörüntülenme sırası.
icon_typestringfont ya da image.
iconstringİkon sınıfı.
Meta 4
totalintSüzgece uyan toplam kayıt.
pageintBulunduğunuz sayfa.
limitintSayfa boyutu.
next_pageintSonraki sayfa. Sıfır son sayfada olduğunuz anlamına gelir.
Hatalar 1
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -G 'https://panel.ornek.com/api/v1/admin/products/addons' \
  -H "Authorization: Bearer $API_KEY" \
  -d group=hosting
const url = new URL('https://panel.ornek.com/api/v1/admin/products/addons');
url.searchParams.set('group', 'hosting');

const res  = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
const body = await res.json();
$url = 'https://panel.ornek.com/api/v1/admin/products/addons?' . http_build_query(['group' => 'hosting']);

$ch = curl_init($url);
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()->GetProductAddons([], ['group' => 'hosting']);

Add-on Detayı

get/api/v1/admin/products/addons/{id}
Products/GetProductAddon admin seçenekler dil altında

Bir add-on tanımını tüm ayarları, kuralları ve her dildeki seçenekleriyle döndürür.

Dönen alanlar data — 15
idintAdd-on kimliği.
groupstringAna grup anahtarı.
categoryintAdd-on kategorisinin kimliği.
statusstringactive ya da inactive.
rankintGörüntülenme sırası.
override_user_currencyboolMüşterinin para birimini yok sayar mı.
tax_exemptboolVergiden muaf mı.
requirement_idsint[]Bağlı gereksinim kimlikleri.
product_linkobjectBağlı ürün: {id, type}.
icon_typestringfont ya da image.
iconstringİkon sınıfı ya da yüklenen görselin adı.
list_templateintListe şablonunun kimliği.
typestringMüşterinin gördüğü girdi biçimi: select, quantity, checkbox ya da radio.
propertiesobjectGirdi tipine göre kurallar: zorunluluk, çoklu satın alma, en az ve en çok adet, adım, fiyatın ürün dönemine bağlanması.
langsobjectDil kodundan içerik nesnesine eşleme.
namestringAdd-on adı.
descriptionstringAçıklama.
optionsobject[]Bu dildeki seçenekler.
idintSeçenek kimliği.
namestringSeçeneğin o dildeki adı.
periodstringday, month ya da year.
period_timeintDönem çarpanı. Üç ay için dönem ay, çarpan üçtür.
amountfloatFiyat. Tek para birimli şekilde gelir.
cidintPara birimi kimliği. Tek para birimli şekilde gelir.
pricingobjectPara birimi kimliğinden {enabled, amount} nesnesine eşleme. Çok para birimli şekilde gelir.
moduleobjectModül adından yapılandırmaya eşleme. Seçenek seçilince modüle geçirilecek değerler.
hiddenboolSeçenek gizli mi.
Hatalar 2
not_found404Add-on bulunamadı.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl 'https://panel.ornek.com/api/v1/admin/products/addons/148' \
  -H "Authorization: Bearer $API_KEY"
const res  = await fetch('https://panel.ornek.com/api/v1/admin/products/addons/148', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addons/148');
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()->GetProductAddon(['id' => 148]);

// Fiyat iki sekilde gelebilir; ikisini de karsilayin.
$option = $response['data']['langs']['en']['options'][0];
$price  = $option['pricing']['1']['amount'] ?? $option['amount'] ?? 0;
Yanıt 
{
  "data": {
    "id": 148,
    "group": "server",
    "category": 296,
    "status": "active",
    "type": "select",
    "properties": { "show_by_pp": 1, "multiple_purchases": 0 },
    "requirement_ids": [],
    "product_link": { "id": 0, "type": "" },
    "langs": {
      "en": {
        "name": "Automated Backups",
        "description": "Keeps daily backups.",
        "options": [
          {
            "id": 0,
            "name": "I want",
            "period": "month",
            "period_time": 1,
            "amount": 2,
            "cid": 5,
            "module": {
              "HetznerCloud": { "configurable": { "backup": 1 } }
            }
          }
        ]
      }
    }
  }
}

Add-on Tanımı Oluşturma

post/api/v1/admin/products/addons
Products/CreateProductAddon admin 201

Katalogda yeni bir add-on tanımı açar.

Gövde 21
groupstringzorunluAna grup anahtarı. Grup listesi ucundan alınır.
categoryintzorunluAdd-on kategorisinin kimliği.
nameobjectzorunluDil kodundan ada eşleme. Geçerli dilin adı olmalı.
descriptionobjectDil kodundan açıklamaya eşleme.
statusstringactive ya da inactive.
rankintGörüntülenme sırası.
typestringGirdi biçimi: select, checkbox, radio ya da quantity.
compulsoryboolAdd-on'u zorunlu kılar.
min_quantityintEn az adet. Adet girdisinde anlamlı.
max_quantityintEn çok adet.
stepintAdet artış adımı.
multiple_purchasesboolAynı add-on'un birden çok kez alınmasına izin verir.
show_by_product_periodboolFiyatı ürünün dönemine göre gösterir.
override_user_currencyboolMüşterinin para birimini yok sayar.
tax_exemptboolVergiden muaf kılar.
requirement_idsint[]Bağlanacak gereksinim kimlikleri.
product_linkintBağlanacak ürünün kimliği.
icon_typestringfont ya da image.
iconstringİkon sınıfı.
list_templateintListe şablonunun kimliği.
optionsobjectSeçenek anahtarından seçenek nesnesine eşleme. Her seçenek dil başına ad, para birimi başına fiyat, dönem, modül yapılandırması ve gizlilik taşır. Göndermek tüm seti değiştirir.
Dönen alanlar data
dataobjectOluşturulan add-on, 201 ile döner. Detay ucuyla aynı şekildedir.
Hatalar 5
group_required422group boş.
category_required422category boş.
name_required422Geçerli dilde ad yok.
create_failed422Oluşturma reddedildi.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X POST 'https://panel.ornek.com/api/v1/admin/products/addons' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"group":"hosting","category":12,"type":"select","name":{"en":"Extra Disk"},"options":{"o1":{"name":{"en":"10 GB"},"pricing":{"1":{"enabled":true,"amount":5}},"cycle":"monthly"}}}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/addons', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    group: 'hosting',
    category: 12,
    type: 'select',
    name: { en: 'Extra Disk' },
    options: {
      o1: {
        name: { en: '10 GB' },
        pricing: { 1: { enabled: true, amount: 5 } },
        cycle: 'monthly',
      },
    },
  }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addons');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'group'    => 'hosting',
        'category' => 12,
        'type'     => 'select',
        'name'     => ['en' => 'Extra Disk'],
        'options'  => [
            'o1' => [
                'name'    => ['en' => '10 GB'],
                'pricing' => [1 => ['enabled' => true, 'amount' => 5]],
                'cycle'   => 'monthly',
            ],
        ],
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->CreateProductAddon([
    'group'    => 'hosting',
    'category' => 12,
    'type'     => 'select',
    'name'     => ['en' => 'Extra Disk'],
    'options'  => [
        'o1' => [
            'name'    => ['en' => '10 GB'],
            'pricing' => [1 => ['enabled' => true, 'amount' => 5]],
            'cycle'   => 'monthly',
        ],
    ],
]);

Add-on Tanımını Güncelleme

patch/api/v1/admin/products/addons/{id}
Products/UpdateProductAddon admin seçenekler hep-veya-hiç

Gönderdiğiniz alanları uygular. Seçenekleri gönderirseniz set olduğu gibi değişir. Tüm gövde alanları opsiyoneldir. Aktif, onay bekleyen ya da askıya alınmış hizmetlerin kullandığı seçenek kilitlidir: gönderdiğiniz set onu aynı ödeme dönemiyle içermelidir.

Gövde 21
groupstringAna grup anahtarı. Grup listesi ucundan alınır.
categoryintAdd-on kategorisinin kimliği.
nameobjectDil kodundan ada eşleme. Yalnız gönderdiğiniz dil değişir.
descriptionobjectDil kodundan açıklamaya eşleme.
statusstringactive ya da inactive.
rankintGörüntülenme sırası.
typestringGirdi biçimi: select, checkbox, radio ya da quantity.
compulsoryboolAdd-on'u zorunlu kılar.
min_quantityintEn az adet. Adet girdisinde anlamlı.
max_quantityintEn çok adet.
stepintAdet artış adımı.
multiple_purchasesboolAynı add-on'un birden çok kez alınmasına izin verir.
show_by_product_periodboolFiyatı ürünün dönemine göre gösterir.
override_user_currencyboolMüşterinin para birimini yok sayar.
tax_exemptboolVergiden muaf kılar.
requirement_idsint[]Bağlanacak gereksinim kimlikleri.
product_linkintBağlanacak ürünün kimliği.
icon_typestringfont ya da image.
iconstringİkon sınıfı.
list_templateintListe şablonunun kimliği.
optionsobjectSeçenek anahtarından seçenek nesnesine eşleme. Her seçenek dil başına ad, para birimi başına fiyat, dönem, modül yapılandırması ve gizlilik taşır. Göndermek tüm seti değiştirir.
Dönen alanlar data
dataobjectGüncel add-on. Detay ucuyla aynı şekildedir.
Hatalar 3
not_found404Add-on bulunamadı.
option_in_use422Seçenekler, aktif, onay bekleyen ya da askıya alınmış hizmetlerin kullandığı bir seçeneği dışarıda bırakıyor ya da ödeme dönemini değiştiriyor. Ayrıntıda seçenek kimliği ve neden yer alır: removed ya da cycle. Hiçbir şey yazılmaz.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PATCH 'https://panel.ornek.com/api/v1/admin/products/addons/131' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"inactive"}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/addons/131', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ status: 'inactive' }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addons/131');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['status' => 'inactive']),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Tek bir secenegin fiyatini degistirmek icin bile TUM seti gonderin.
$addon   = Api::Products()->GetProductAddon(['id' => 131])['data'];
$options = $addon['langs']['en']['options'];

// ... $options uzerinde degisiklik ...

Api::Products()->UpdateProductAddon([
    'id'      => 131,
    'options' => $options,
]);

Add-on Tanımını Silme

delete/api/v1/admin/products/addons/{id}
Products/DeleteProductAddon admin geri alınamaz

Add-on tanımını siler. Dil kayıtları da gider.

Dönen alanlar data — 2
deletedboolSilme başarılı mı.
idintSilinen add-on'un kimliği.
Hatalar 3
not_found404Add-on bulunamadı.
blocked_by_gate422gate:product.addon_delete kancası işlemi veto etti.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X DELETE 'https://panel.ornek.com/api/v1/admin/products/addons/131' \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/addons/131', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${apiKey}` },
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addons/131');
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()->DeleteProductAddon(['id' => 131]);

Add-on İkonu Yükleme

post/api/v1/admin/products/addons/{id}/icon
Products/UploadAddonIcon admin SVG

Add-on ikonunu yükler. Görsel dosyalar ve SVG kabul edilir.

Gövde 1
imagestringzorunluİkon görseli. base64 veri adresi ya da indirilebilir bir bağlantı.
Dönen alanlar data — 1
urlstringİkonun genel adresi.
Hatalar 5
not_found404Add-on 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/addons/131/icon' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"image":"data:image/png;base64,iVBORw0KGgo..."}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/addons/131/icon', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ image: 'data:image/png;base64,iVBORw0KGgo...' }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addons/131/icon');
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/svg+xml;base64,' . base64_encode($svg),
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$response = Api::Products()->UploadAddonIcon([
    'id'    => 131,
    'image' => 'data:image/svg+xml;base64,' . base64_encode($svg),
]);

Add-on İkonunu Silme

delete/api/v1/admin/products/addons/{id}/icon
Products/DeleteProductAddonIcon admin

Yüklenmiş ikon görselini kaldırır.

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

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addons/131/icon');
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()->DeleteProductAddonIcon(['id' => 131]);

Kategorileri Listeleme

get/api/v1/admin/products/addon-categories
Products/GetAddonCategories admin

Add-on kategorilerini döndürür.

Dönen alanlar data[] — 4
idintKategori kimliği.
titlestringKategori başlığı.
parent_idintÜst kategorinin kimliği. Sıfır üst seviye demektir.
rankintGörüntülenme sırası.
Hatalar 1
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl 'https://panel.ornek.com/api/v1/admin/products/addon-categories' \
  -H "Authorization: Bearer $API_KEY"
const res  = await fetch('https://panel.ornek.com/api/v1/admin/products/addon-categories', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addon-categories');
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()->GetAddonCategories();

Kategori Oluşturma

post/api/v1/admin/products/addon-categories
Products/CreateAddonCategory admin 201

Add-on kategorisi açar.

Gövde 3
titlestringzorunluKategori başlığı.
parent_idintÜst kategorinin kimliği.
rankintGörüntülenme sırası.
Dönen alanlar data — 2
idintYeni kategorinin kimliği.
titlestringHTML temizliğinden geçmiş başlık. Yanıtta iki alan döner; üst kategori ile sırayı liste ucundan okuyun.
Hatalar 4
title_required422title boş.
blocked_by_gate422gate:product.category_save kancası işlemi veto etti.
create_failed422Ekleme başarısız oldu.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X POST 'https://panel.ornek.com/api/v1/admin/products/addon-categories' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title":"Resources","rank":1}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/addon-categories', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'Resources', rank: 1 }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addon-categories');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['title' => 'Resources', 'rank' => 1]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$category = Api::Products()->CreateAddonCategory(['title' => 'Resources']);

Api::Products()->CreateProductAddon([
    'group'    => 'hosting',
    'category' => $category['data']['id'],
    'name'     => ['en' => 'Extra Disk'],
]);

Kategoriyi Güncelleme

patch/api/v1/admin/products/addon-categories/{id}
Products/UpdateAddonCategory admin

Kategorinin başlığını, üstünü ya da sırasını değiştirir.

Gövde 3
titlestringKategori başlığı. Gönderirseniz boş olamaz.
parent_idintÜst kategorinin kimliği.
rankintGörüntülenme sırası.
Dönen alanlar data — 4
idintKategori kimliği.
titlestringKategori başlığı.
parentintÜst kategorinin kimliği. Sıfır üst seviye demektir. Liste ucunda bu alanın adı parent_id.
rankintGörüntülenme sırası. Kayıtlı satır olduğu gibi döner, yanında birkaç iç sütun da gelir.
Hatalar 4
not_found404Kategori bulunamadı.
title_required422Başlık gönderildi ama boştu.
no_changes422Gövdede düzenlenebilir alan yok.
insufficient_scope403Anahtar gerekli kapsamı taşımıyor.
İstek 
curl -X PATCH 'https://panel.ornek.com/api/v1/admin/products/addon-categories/12' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title":"System Resources","rank":2}'
const res = await fetch('https://panel.ornek.com/api/v1/admin/products/addon-categories/12', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: 'System Resources', rank: 2 }),
});

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addon-categories/12');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['title' => 'System Resources', 'rank' => 2]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
// Bos govde 'no_changes' ile doner — degisen alan yoksa hic cagirmayin.
$response = Api::Products()->UpdateAddonCategory([
    'id'    => 12,
    'title' => 'System Resources',
]);

Kategoriyi Silme

delete/api/v1/admin/products/addon-categories/{id}
Products/DeleteAddonCategory admin

Add-on kategorisini siler.

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

const body = await res.json();
$ch = curl_init('https://panel.ornek.com/api/v1/admin/products/addon-categories/12');
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()->DeleteAddonCategory(['id' => 12]);

Tuzaklar

Seçenekleri göndermek seti baştan yazar

Güncelleme gövdesinde options varsa mevcut seçeneklerin tamamı her dilde silinip yerine gönderdiğiniz set yazılır. Tek bir seçeneğin fiyatını değiştirmek için önce detayı okuyun, seti bütün olarak geri gönderin. Alanı hiç göndermemek seçenekleri korur.

Fiyat iki farklı şekilde döner

Bir seçenek ya düz bir tutar ve para birimi kimliği taşır, ya da para birimi başına {enabled, amount} nesnelerinden oluşan bir eşleme. Hangisinin geleceği kaydın nasıl yazıldığına bağlıdır; okuyan kod ikisini de karşılamalıdır.

Seçenekler her dilde ayrı durur

Seçenekler dil nesnesinin içinde yaşar, yani her dilde ayrı bir kopyası vardır. Bir dile seçenek ekleyip diğerine eklememek, o dili kullanan müşteride seçeneğin görünmemesine yol açar.

Boş güncelleme gövdesi hata döner

Kategori güncellemesi düzenlenebilir hiçbir alan taşımayan bir gövdeyi kabul etmez ve no_changes döndürür. Değişiklik yoksa isteği hiç göndermemek gerekir.

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ı