REST API · v1.2.0

Entegra E-Ticaret API

Son güncelleme 14.10.2026·82 uç nokta·16 bölüm

Current Version: v1.2.0
Last Updated: 14.10.2026

Entegra E-Ticaret API'yi kullanmak veya görüşlerinizi bizimle paylaşmak isterseniz [email protected] adresi üzerinden iletişime geçebilirsiniz.
API'yi kullanarak eticaret verilerine ulaşabilir ve kendi uygulamalarınız ile entegre edebilirsiniz.

Genel Bilgiler

API için BASE_URL "https://www.example.com/api/ecommerce/v1"
Entegranın REST API'sine yapılan tüm isteklerin kimliğinin doğrulanması gerekmektedir.
API endpointlerine ulaşmak için ilk olarak size verilen 'email' , 'password' ve 'api_key' bilgileriyle sisteme login olup access token ve refresh token almalısınız.
Bu alınan access token'ı sorgulara Authorization header'ı olarak Bearer <access_token> şeklinde eklenmelidir.
Request limiti dakika/120 olarak ayarlanmıştır. Limit aşımında 1 saat ip engeli tanımlanmıştır. Limit, uç nokta ve IP adresi başına sayılır. Login ve refresh-auth uçları için dakika/10, Raporlar ve Toplu Ürün Güncelle uçları için dakika/60 ile sınırlıdır
Access token süresi 1 saat.
Refresh token süresi 1 aydır.
Not: Her Request için token isteği yapılmamalıdır. Aksi durumda otomatik olarak engellenirsiniz.

Error Codes & Descriptions

HTTP Kodu	Error Key	Açıklama
415	`invalid_content_type`	Content-Type header değeri tam olarak application/json olmalıdır (`application/json; charset=utf-8` kabul edilmez).
400	`invalid_json`	Gövde geçerli bir JSON değil.
400	`end_point_error`	Sorgu parametreleri doğrulanamadı ya da işlem tamamlanamadı.
403	`ip_blocked`	İp Engellenmiş
401	`user_not_found`	Api Kullanıcısı bulunamadı ya da pasif
403	`permission_denied`	İşlem için yetkiniz yok
401	`authorization_header_missing`	Authorization header eksik
401	`invalid_authorization_format`	Header “Bearer” ile başlamıyor
401	`missing_bearer_token`	“Bearer” sonrası token yok
401	`invalid_token`	Token geçersiz veya bozuk
401	`expired_or_invalid_token`	Token expired veya yanlış
401	`unauthorized`	Login / Refresh Token: bilgiler hatalı ya da refresh token geçersiz
404	`invalid_request`	Geçersiz Endpoint
404	`not_found`	Kayıt bulunamadı
422	`validation_error`	Gövde doğrulanamadı; `message` alan bazında hataları içerir
422	`no_data`	Güncellenecek alan gönderilmedi
429	`too_many_requests`	İstek limiti aşıldı; IP adresi engellenir
503	`api_disabled`	API panelden kapatılmış

Sample Error Response

{
    "status": false,
    "error": "ip_blocked",
    "message": "This IP address has been blocked"
}

Bölümler

Auth

2 uç nokta

Oturum Açma ve Token Yenileme İşlemler

POSTLogin

{{base_url}}/login

Yetkilendirme gerekmezContent-Type: application/jsonAccept: application/json

Kullanıcı e-posta, şifre ve API anahtarı ile giriş yapar. password en az 24 karakterdir; api_key panelde 128 karakter olarak üretilir. Başarılı giriş önceki refresh_token'ı geçersiz kılar.

Response (200 OK)

{
    "status": true,
    "data": {
        "access_token": "...",
        "refresh_token": "..."
    }
}

Rate limit: 10 istek/dakika

İstek gövdesi

{
  "email": "[email protected]",
  "password": "Panelde-Belirlenen-En-Az-24-Karakterlik-Sifre",
  "api_key": "<panelde-verilen-128-karakterlik-api-anahtari>"
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/login' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "email": "[email protected]",
  "password": "Panelde-Belirlenen-En-Az-24-Karakterlik-Sifre",
  "api_key": "<panelde-verilen-128-karakterlik-api-anahtari>"
}'

POSTRefresh Token

{{base_url}}/refresh-auth

Yetkilendirme gerekmezContent-Type: application/json

Kullanıcı, süresi geçerli bir refresh_token kullanarak API’ye istek gönderdiğinde:

Sistem, kullanıcının doğrulamasını yapar ve geçerli refresh_token kontrolünü sağlar.
Yeni bir access_token ve refresh_token oluşturur ve kullanıcıya döner.
Önceki refresh_token artık geçersiz hale gelir; önceki access_token süresi dolana kadar geçerli kalır.

Response (200 OK)

{
    "status": true,
    "data": {
        "access_token": "....",
        "refresh_token": "..."
    }
}

Rate limit: 10 istek/dakika

İstek gövdesi

{
  "refresh_token": "{{refresh_token}}"
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/refresh-auth' \
  --header 'Content-Type: application/json' \
  --data '{
  "refresh_token": "<REFRESH_TOKEN>"
}'

Müşteriler

8 uç nokta

Müşterilere ait işlemler

Müşteri seçen uçlarda phone değerindeki + işareti %2B olarak kodlanmalıdır (ör. %2B905551234567); kodlanmazsa boşluk olarak okunur ve müşteri bulunamaz.

GETMüşteriler Listesi

{{base_url}}/customers

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Arama; Ad, Soyad, E-posta, Telefon, Müşteri/Cari Kod; Max: 100
status	string	Durum; Values : active / inactive
current_account	string	Cari Hesap Durumu; Values : active / inactive
dealer	integer	Bayi Grubu; Bayi Grubu ID
sort	string	Sıralanacak Sutun: Values : id / name
order	string	Sıralama Tipi: Values : asc / desc
page	integer	Sayfa Numarası Min : 1
limit	integer	Limit Min : 1 - Max : 500

Response (200 OK)

{
  "status": true,
  "data": {
    "items": [
      {
        "id": 1,
        "status": "active",
        "name": "Entegra",
        "surname": "Bilişim",
        "email": "[email protected]",
        "telephone_code": "tr",
        "telephone": "+90 8507339152",
        "customer_code": "cari1",
        "communication_consent": true,
        "sms_communication_consent": true,
        "tel_communication_consent": false,
        "created_at": "1694608756",
        "created_at_local": "13.09.2023 15:39:16",
        "dealer": {
           "id": 1,
           "title": "Bayi Grubu 1"
        },
        "current_account": {
           "status": "active",
           "balance": 300
        },
        "addresses": [
          {
            "id": 11,
            "user_id": 8348,
            "title": "Ofis Adresi",
            "is_default": true,
            "country": "Türkiye",
            "city": "İstanbul",
            "district": "Bahçelievler",
            "address": "Şirinevler Mah. Adnan Kahveci Bulvarı. No.204 Emek İş Merkezi Kat.7 D.57 ",
            "post_code": "34188",
            "invoice_type": "institutional",
            "company_name": "Entegra Bilişim",
            "tax_office": "Vergi Dairesi",
            "tax_number": "Vergi No",
            "tc": "11111111111"
          }
        ]
      }
    ],
    "pager": {
      "currentPage": 1,
      "totalPages": 3,
      "totalRecords": 5
    }
  }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/customers' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETMüşteri Detayı

{{base_url}}/customers/detail

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Aşağıdaki parametrelerden en az birini kullanarak müşteri bilgilerini sorgulayabilir ve ilgili kayda erişebilirsiniz.

Query Parameters

Field	Type	Descripton
id	integer	Müşteri ID
customer_code	string	Müşteri/Cari Kodu
email	string	E-Posta
phone	string	Telefon

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 51,
        "status": "inactive",
        "name": "Entegra",
        "surname": "Bilisim",
        "email": "[email protected]",
        "telephone_code": "tr",
        "telephone": "+90 1214945545",
        "customer_code": "",
        "communication_consent": true,
        "sms_communication_consent": true,
        "tel_communication_consent": false,
        "dealer": {
            "id": 1,
            "title": "Bayi Grubu 1"
        },
        "current_account": {
            "status": "active",
            "balance": 300
        },
        "addresses": [
            {
                "id": 38,
                "user_id": 51,
                "title": "Test",
                "is_default": true,
                "country": "Türkiye",
                "city": "İstanbul",
                "district": "Avcılar",
                "address": "Örnek Adres",
                "post_code": "34416",
                "invoice_type": "individual",
                "company_name": "",
                "tax_office": "",
                "tax_number": "",
                "tc": ""
            },
            {
                "id": 39,
                "user_id": 51,
                "title": "Test",
                "is_default": false,
                "country": "Türkiye",
                "city": "İstanbul",
                "district": "Avcılar",
                "address": "Adres 2",
                "post_code": "34416",
                "invoice_type": "individual",
                "company_name": "",
                "tax_office": "",
                "tax_number": "",
                "tc": ""
            }
        ],
        "created_at": "1763459978",
        "created_at_local": "18.11.2025 12:59:38",
        "last_logins": [
            {
                "user_ip": "88.250.10.20",
                "login_time": "1763460000"
            }
        ]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/customers/detail' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTMüşteri Ekle

{{base_url}}/customers

Bearer token gerekirContent-Type: application/json

Yeni müşteri kayıt işlemi

Body (JSON)

Field	Type	Rules
status	string - required	Durum; Values: active / inactive
name	string - required	Ad; Sadece harf (TR dahil); Max: 100
surname	string - required	Soyad; Sadece harf (TR dahil); Max: 100
email	email - required	E-Posta; benzersiz olmalı
telephone_code	string - required	Telefon ülke kodu; Values: tr / de / ru ... (ISO 2)
telephone	string - required	Telefon; TR Format: +90 5xxxxxxxxx
password	string - required	Min 12 karakter, harf ve rakam içermeli
communication_consent	boolean	Elektronik İleti Onayı; Values: true / false
sms_communication_consent	boolean	SMS İleti Onayı; Values: true / false
tel_communication_consent	boolean	Telefon İleti Onayı; Values: true / false
current_account_status	string - required	Cari hesap durumu; Values: active / inactive
current_account_min_limit	decimal	Cari hesap borç limiti (varsayılan: 0)
customer_code	string	Müşteri/Cari kodu; isteğe bağlı. Doluysa benzersiz olmalı; baştaki ve sondaki boşluklar silinir
dealer_id	integer	Bayi Grubu ID
dealer_min_order_status	string	Bayi min. sipariş durumu; Values: active / inactive
dealer_min_order_type	string	Bayi min. sipariş tipi; Values: total_quantity / same_product_quantity
dealer_min_order_count	integer	Bayi min. sipariş adedi
addresses	array	Adres listesi; en fazla 20 adres gönderilebilir
addresses.*.title	string	Adres başlığı; addresses varsa zorunlu
addresses.*.is_default	boolean	Varsayılan adres; addresses varsa zorunlu; sadece 1 adres true olabilir
addresses.*.country	string	Ülke adı; ny_country tablosunda kayıtlı olmalı
addresses.*.city	string	Şehir adı; ny_citys tablosunda kayıtlı olmalı
addresses.*.district	string	İlçe adı; ny_citys_detail tablosunda kayıtlı olmalı
addresses.*.address	string	Açık adres; addresses varsa zorunlu
addresses.*.post_code	integer	Posta kodu; addresses varsa zorunlu
addresses.*.invoice_type	string	Fatura tipi; addresses varsa zorunlu; Values: individual / institutional
addresses.*.company_name	string	Şirket ünvanı (kurumsal fatura için)
addresses.*.tax_office	string	Vergi dairesi (kurumsal fatura için)
addresses.*.tax_number	string	Vergi numarası (kurumsal fatura için)
addresses.*.tc	integer	TC kimlik numarası (bireysel fatura için)

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Customer created successfully.",
        "customer_id": 3
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "dealer_id": 1,
  "status": "active",
  "name": "Entegra",
  "surname": "Bilisim",
  "email": "[email protected]",
  "telephone_code": "tr",
  "telephone": "+90 1214945545",
  "customer_code": "",
  "password": "Password1234example",
  "communication_consent": true,
  "sms_communication_consent": true,
  "tel_communication_consent": false,
  "current_account_status": "active",
  "current_account_min_limit": 10,
  "dealer_min_order_status": "active",
  "dealer_min_order_type": "same_product_quantity",
  "dealer_min_order_count": 1,
  "addresses": [
    {
      "title": "Ofis Adresi",
      "is_default": true,
      "country": "Türkiye",
      "city": "İstanbul",
      "district": "Avcılar",
      "address": "Örnek Sokak No:1",
      "post_code": "34416",
      "invoice_type": "institutional",
      "company_name": "Entegra Bilişim",
      "tax_office": "Bağcılar VD",
      "tax_number": "1234567890",
      "tc": ""
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/customers' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "dealer_id": 1,
  "status": "active",
  "name": "Entegra",
  "surname": "Bilisim",
  "email": "[email protected]",
  "telephone_code": "tr",
  "telephone": "+90 1214945545",
  "customer_code": "",
  "password": "Password1234example",
  "communication_consent": true,
  "sms_communication_consent": true,
  "tel_communication_consent": false,
  "current_account_status": "active",
  "current_account_min_limit": 10,
  "dealer_min_order_status": "active",
  "dealer_min_order_type": "same_product_quantity",
  "dealer_min_order_count": 1,
  "addresses": [
    {
      "title": "Ofis Adresi",
      "is_default": true,
      "country": "Türkiye",
      "city": "İstanbul",
      "district": "Avcılar",
      "address": "Örnek Sokak No:1",
      "post_code": "34416",
      "invoice_type": "institutional",
      "company_name": "Entegra Bilişim",
      "tax_office": "Bağcılar VD",
      "tax_number": "1234567890",
      "tc": ""
    }
  ]
}'

PATCHMüşteri Düzenle

{{base_url}}/customers

Bearer token gerekirContent-Type: application/json

addresses gönderilirse müşteriye ait tüm mevcut adresler silinir ve yerine gönderilen liste yazılır. Adres listesini korumak istiyorsanız bu alanı body'e dahil etmeyin. Düzenleme işlemi için yalnızca değiştirmek istediğiniz alanları göndermeniz yeterlidir. Gönderilmeyen alanlar mevcut değerlerini korur

Aşağıdaki parametrelerden en az birini kullanarak müşteri düzenlemesini gerçekleştirebilirsiniz

Query Parameters

Field	Type	Descripton
id	integer	Müşteri ID
customer_code	string	Müşteri/Cari Kodu
email	string	E-Posta
phone	string	Telefon

Body (JSON)

Field	Type	Rules
status	string	Durum Values : active/inactive
name	string	Ad
surname	string	Soyad
email	email	E-Posta
customer_code	string	Müşteri/Cari Kodu; başka bir müşteride kullanılmıyor olmalı; boş gönderilirse kod kaldırılır
telephone_code	string	Telefon Numarası ülke kodu. Values : tr/de/ru....
telephone	string	TR Format : +90 54xxxxxxxx DE Format : +49 54xxxxxxxx
password	string	Min 12 karakter harf ve rakam.
communication_consent	boolean	Elektronik İleti Onayı. Values : true/false
sms_communication_consent	boolean	SMS İleti Onayı. Values : true/false
tel_communication_consent	boolean	Telefon İleti Onayı. Values : true/false
current_account_status	string	Cari hesap durumu. Values : active/inactive.
current_account_min_limit	decimal	Cari hesap borç limiti
dealer_id	integer	Bayi Grup ID
dealer_min_order_status	string	Bayi Min. Sipariş Durumu Values: active/inactive.
dealer_min_order_type	string	Bayi Min. Sipariş Tipi values: total_quantity / same_product_quantity total_quantity : Toplam ürün adeti üzerinden. same_product_quantity : Aynı ürün adeti üzerinden
dealer_min_order_count	integer	Bayi Min. Sipariş Adeti
addresses	array	Adres Bilgileri; en fazla 20 adres gönderilebilir; gönderilirse mevcut adresler tümüyle silinir ve yenileri yazılır
addresses.\*.title	string	Adres Başlığı addresses mevcut ise zorunlu
addresses.\*.is_default	boolean	Varsayılan Adres. addresses mevcut ise zorunlu Sadece 1 adres true olabilir. Values : true/false
addresses.\*.country	string	Ülke addresses mevcut ise zorunlu.
addresses.\*.city	string	Şehir addresses mevcut ise zorunlu.
addresses.\*.district	string	İlçe addresses mevcut ise zorunlu.
addresses.\*.address	string	Adres addresses mevcut ise zorunlu.
addresses.\*.post_code	integer	Posta Kodu addresses mevcut ise zorunlu.
addresses.\*.invoice_type	string	Fatura Tipi addresses mevcut ise zorunlu. Values : individual/institutional individual : Bireysel Fatura institutional : Kurumsal Fatura
addresses.\*.company_name	string	Şirket Ünvanı
addresses.\*.tax_office	string	Vergi Dairesi
addresses.\*.tax_number	string	Vergi Numarası
addresses.\*.tc	integer	Tc Kimlik

Example Request (JSON)

{
    "status": "inactive",
    "name": "Yeni Ad"
}

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Customer updated successfully.",
        "customer_id": 49
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "status": "active"
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/customers' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "status": "active"
}'

DELETEMüşteri Sil

{{base_url}}/customers?id=51

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem, bir müşteriye ait tüm bilgilerin, adreslerin ve yorumların silinmesini sağlar.

Aşağıdaki parametrelerden en az birini kullanarak müşteri silme işlemini gerçekleştirebilirsiniz.

Query Parameters

Field	Type	Descripton
id	integer	Müşteri ID
customer_code	string	Müşteri/Cari Kodu
email	string	E-Posta
phone	string	Telefon

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Customer deleted successfully.",
        "deleted_ids": [41]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/customers?id=51' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETCari Hareketler

{{base_url}}/customers/transactions?id=51

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Müşteriye ait bakiye ve hesap haraketlerini döndürür. Sorgu parametlerinden id,customer_code,email,phone alanlarından en az 1 tanesi zorunludur.

Query Parameters

Field	Type	Descripton
id	integer	Müşteri ID
customer_code	string	Müşteri/Cari Kodu
email	string	E-Posta
phone	string	Telefon
type	string	Hesap hareket tipi Values: entry/output entry: tahsilat output: borç
page	integer	Sayfa Numarası
limit	integer	Limit Min: 1 Max: 500 arası değerler alır
sort	string	Sıralanacak Alan Values: id/amount/ process_time
order	string	Sıralama Tipi Values : asc/desc

Response (200 OK)

{
    "status": true,
    "data": {
        "balance": 300,
        "filtered_balance": 300,
        "actions": [
            {
                "id": 24,
                "amount": 3300,
                "type": "entry",
                "description": "X Bankası Havale",
                "process_time": "1763732469",
                "process_time_local": "21.11.2025 16:41:09"
            },
            {
                "id": 23,
                "amount": 3000,
                "type": "output",
                "description": "Sipariş Tutarı",
                "process_time": "1763732450",
                "process_time_local": "21.11.2025 16:40:50"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/customers/transactions?id=51' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTCari Hareket Ekle

{{base_url}}/customers/transactions

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem, müşterinin cari hesabına borç (output) veya tahsilat (entry) yönünde bir hareket eklemek için kullanılır.

Her hareket; işlem tipi, tutar, açıklama içerir. Doğru veri formatı ile gönderildiğinde sistem ilgili müşterinin cari bakiyesini otomatik olarak günceller.

Sorgu parametlerinden id, customer_code, email, phone alanlarından en az 1 tanesi zorunludur.

Query Parameters

Field	Type	Descripton
id	integer	Müşteri ID
customer_code	string	Müşteri/Cari Kodu
email	string	E-Posta
phone	string	Telefon

Body (JSON)

Field	Type	Rules
type	string	Required; `entry` (tahsilat) veya `output` (borç)
amount	decimal	Required; 0'dan büyük ondalıklı sayı
description	string	Required; Max 500 karakter

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Account transaction has been added successfully.",
        "transaction_id": 14,
        "customer_id": 39,
        "amount": "150020",
        "type": "output",
        "process_time": 1763042530,
            "process_time_local": "13.01.2026 12:42:10"
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "type": "entry",
  "amount": 3300,
  "description": "Sipariş Tutarı"
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/customers/transactions' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "type": "entry",
  "amount": 3300,
  "description": "Sipariş Tutarı"
}'

DELETECari Hareket Sil

{{base_url}}/customers/transactions/:action_id?id=51

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem, bir müşteriye ait hatalı veya iptal edilmesi gereken bir cari hareket kaydını sistemden kaldırmak için kullanılır.

Hareket silindiğinde müşterinin cari bakiyesi otomatik olarak yeniden hesaplanır.

Sorgu parametlerinden id, customer_code, email, phone alanlarından en az 1 tanesi zorunludur.

Kayıt bulunamazsa 404 not_found döner.

Query Parameters

Field	Type	Descripton
id	integer	Müşteri ID
customer_code	string	Müşteri/Cari Kodu
email	string	E-Posta
phone	string	Telefon

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Account transaction has been successfully deleted."
    }
}

Rate limit: 120 istek/dakika

Yol değişkenleri

Parametre	Örnek değer	Açıklama
`action_id`	`4`	Silinecek cari hareket kaydı ID'si

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/customers/transactions/4?id=51' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Bayi Grupları

5 uç nokta

Dealer gruplarını (bayi gruplarını) listeler, detaylarını döndürür; ekleme, güncelleme ve silme işlemlerini yapar.

GETBayi Grupları Listesi

{{base_url}}/dealers

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Grup adında arama; Max 100 karakter
status	string	Durum filtresi; Values: active / inactive
sort	string	Sıralanacak alan; Values: id / name
order	string	Sıralama yönü; Values: asc / desc
page	integer	Sayfa numarası; Min: 1
limit	integer	Sayfa limiti; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "title": "Bayi Grubu 1 (%5 İskonto)",
                "status": "active",
                "minimum_order_amount": 0,
                "installment_limit": 12,
                "is_default": false,
                "create_date": "1676061703",
                "update_date": "1676061703",
                "create_date_local": "10.02.2023 23:41:43",
                "update_date_local": "10.02.2023 23:41:43",
                "discount_scenario": {
                    "type": "fixed_rate_on_all_products",
                    "discount_rate": 5
                },
                "payment_type_restrictions": []
            },
            {
                "id": 2,
                "title": "Bayi Grubu 2",
                "status": "inactive",
                "minimum_order_amount": 500,
                "installment_limit": 12,
                "is_default": false,
                "create_date": "1676061726",
                "update_date": "1763548866",
                "create_date_local": "10.02.2023 23:42:06",
                "update_date_local": "19.07.2025 10:41:06",
                "discount_scenario": {
                    "type": "dealer_special_price",
                    "price_type": {
                        "id": 4,
                        "title": "Price 1",
                        "key": "b2bp-50251"
                    }
                },
                "payment_type_restrictions": [
                    {
                        "id": 1,
                        "title": "Kredi Kartı / Banka Kartı"
                    },
                    {
                        "id": 7,
                        "title": "Mağazadan Teslim Al"
                    }
                ]
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

discount_scenario.discount_rate okunurken ana ve ek indirimin bileşik toplam oranıdır (ör. %15 + %5 → 19.25).

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/dealers' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETBayi Grubu Detayı

{{base_url}}/dealers/detail?id=2

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id query parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Bayi Grubu ID

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 2,
        "title": "Bayi Grubu 2",
        "status": "inactive",
        "minimum_order_amount": 500,
        "installment_limit": 12,
        "is_default": false,
        "create_date": "1676061726",
        "update_date": "1763548866",
        "create_date_local": "10.02.2023 23:42:06",
        "update_date_local": "19.07.2025 10:41:06",
        "discount_scenario": {
            "type": "dealer_special_price",
            "price_type": {
                "id": 4,
                "title": "Price 1",
                "key": "b2bp-50251"
            }
        },
        "payment_type_restrictions": [
            {
                "id": 1,
                "title": "Kredi Kartı / Banka Kartı"
            },
            {
                "id": 7,
                "title": "Mağazadan Teslim Al"
            }
        ]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/dealers/detail?id=2' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTBayi Grubu Ekle

{{base_url}}/dealers

Bearer token gerekirContent-Type: application/json

name ve discount_scenario alanları zorunludur. discount_scenario.type zorunludur.

type değeri fixed_rate_on_all_products ise discount_rate zorunludur; extra_discount_rate opsiyoneldir (bileşik indirim).

type değeri dealer_special_price ise price_type_id kullanılır.

Body (JSON)

Field	Type	Rules
name	string - required	Grup adı; Max 255 karakter
status	string	Durum; Values: active / inactive (varsayılan: active)
is_default	boolean	Varsayılan bayi grubu; true / false (varsayılan: false)
minimum_order_amount	decimal	Minimum sipariş tutarı; Min 0
installment_limit	integer	Taksit limiti; Min 0
payment_type_restrictions	array	Kısıtlanacak ödeme tipi ID listesi
discount_scenario	object - required	İndirim senaryosu
discount_scenario.type	string - required	İndirim tipi; Values: fixed_rate_on_all_products / dealer_special_price
discount_scenario.discount_rate	decimal	Ana indirim oranı (%); Min 0 Max 100 — type=fixed_rate_on_all_products ise zorunlu
discount_scenario.extra_discount_rate	decimal	Ek indirim oranı (%); Min 0 Max 100 — opsiyonel; bileşik hesap: 1-(1-r1/100)*(1-r2/100)
discount_scenario.price_type_id	integer	Fiyat tipi ID; ny_product_price_types.id — type=dealer_special_price ise kullanılır

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Dealer group created successfully.",
        "id": 5
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "name": "Altın Bayi",
  "status": "active",
  "is_default": false,
  "minimum_order_amount": 500,
  "installment_limit": 6,
  "payment_type_restrictions": [
    2,
    3
  ],
  "discount_scenario": {
    "type": "fixed_rate_on_all_products",
    "discount_rate": 15,
    "extra_discount_rate": 5
  }
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/dealers' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "name": "Altın Bayi",
  "status": "active",
  "is_default": false,
  "minimum_order_amount": 500,
  "installment_limit": 6,
  "payment_type_restrictions": [
    2,
    3
  ],
  "discount_scenario": {
    "type": "fixed_rate_on_all_products",
    "discount_rate": 15,
    "extra_discount_rate": 5
  }
}'

PATCHBayi Grubu Düzenle

{{base_url}}/dealers?id=5

Bearer token gerekirContent-Type: application/json

id query parametresi zorunludur. Body'de yalnızca güncellenmek istenen alanlar gönderilir.

discount_scenario gönderilirse discount_scenario.type zorunludur. type değeri fixed_rate_on_all_products ise discount_rate de zorunludur. Yalnız discount_rate gönderilirse ek indirim 0 sayılır; ek indirimi korumak için extra_discount_rate'i de birlikte gönderin.

Query Parameters

Field	Type	Description
id	integer - required	Bayi Grubu ID

Body (JSON)

Field	Type	Rules
name	string	Grup adı; Max 255 karakter
status	string	Durum; Values: active / inactive
is_default	boolean	Varsayılan bayi grubu; true / false
minimum_order_amount	decimal	Minimum sipariş tutarı; Min 0
installment_limit	integer	Taksit limiti; Min 0
payment_type_restrictions	array	Kısıtlanacak ödeme tipi ID listesi
discount_scenario	object	İndirim senaryosu
discount_scenario.type	string	İndirim tipi; Values: fixed_rate_on_all_products / dealer_special_price
discount_scenario.discount_rate	decimal	Ana indirim oranı (%); Min 0 Max 100 — type=fixed_rate_on_all_products ise zorunlu
discount_scenario.extra_discount_rate	decimal	Ek indirim oranı (%); Min 0 Max 100 — opsiyonel
discount_scenario.price_type_id	integer	Fiyat tipi ID; ny_product_price_types.id

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Dealer group updated successfully.",
        "id": 5
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "name": "Platin Bayi",
  "status": "active",
  "discount_scenario": {
    "type": "fixed_rate_on_all_products",
    "discount_rate": 20,
    "extra_discount_rate": 3
  }
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/dealers?id=5' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "name": "Platin Bayi",
  "status": "active",
  "discount_scenario": {
    "type": "fixed_rate_on_all_products",
    "discount_rate": 20,
    "extra_discount_rate": 3
  }
}'

DELETEBayi Grubu Sil

{{base_url}}/dealers?id=5

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id query parametresi zorunludur.

Gruba bağlı müşteri varsa silme işlemi engellenir; müşteriler önce farklı bir gruba atanmalıdır.

Query Parameters

Field	Type	Description
id	integer - required	Bayi Grubu ID

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Dealer group deleted successfully.",
        "id": 5
    }
}

Error — Bağlı Müşteri Var (422)

{
    "status": false,
    "error": "has_customers",
    "message": "This dealer group has 3 assigned customer(s). Reassign them before deleting."
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/dealers?id=5' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Ürünler

6 uç nokta

Ürün listeleme, detay, oluşturma, güncelleme, toplu güncelleme ve silme işlemleri. Çoklu dil desteği languages[] dizisi ile sağlanır. Görsel yükleme URL tabanlıdır (ImageManager). showcase, cargo, visibility alanları nesne olarak gruplandırılmıştır.

GETÜrünleri Listele

{{base_url}}/products?page=1&limit=20&lang_id=1&status=active&category_id=&brand_id=&search=

Bearer token gerekir

Ürünleri sayfalı olarak listeler. Belirtilen dil için ad ve URL bilgisi döner.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`page`	`1`	Sayfa numarası (varsayılan: 1)
`limit`	`20`	Sayfa başına kayıt sayısı (varsayılan: 100, en fazla 500)
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)
`status`	`active`	Durum filtresi: active \| inactive
`category_id`	—	Kategori ID'sine göre filtrele
`brand_id`	—	Marka ID'sine göre filtrele
`search`	—	Ürün adı, kodu veya barkoduna göre arama; Max 100
`in_stock`	—	Stok filtresi: yes (stokta olanlar) \| no (stokta olmayanlar)
`sort`	`id`	Sıralama alanı: id \| name \| price \| stock \| created_at (varsayılan: id)
`order`	`desc`	Sıralama yönü: asc \| desc (varsayılan: desc)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/products?page=1&limit=20&lang_id=1&status=active&category_id=&brand_id=&search=' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "items": [
      {
        "id": 1,
        "name": "Örnek Ürün",
        "url": "https://www.example.com/ornek-urun",
        "image": "https://www.example.com/uploads/urunler/example.jpg",
        "code": "PRD-001",
        "store_code": "STR-001",
        "mpn": "MPN123",
        "ean": "8690000000017",
        "barcode": "8690000000017",
        "price": 299.9,
        "old_price": 349.9,
        "tax": 18,
        "stock": 150,
        "stock_status": "active",
        "currency": "TRY",
        "status": "active",
        "sort": 0,
        "delivery_days": 3,
        "delivery_date": null,
        "close_online": false,
        "comment_status": true,
        "showcase": {
          "is_featured": false,
          "has_discount": true,
          "new_ticket": false
        },
        "visibility": {
          "home": true,
          "category": true,
          "brand": true,
          "search": true,
          "price": true
        },
        "created_at": 1778828400,
        "created_at_local": "15.05.2026 10:00:00",
        "updated_at": 1778835600,
        "updated_at_local": "15.05.2026 12:00:00"
      }
    ],
    "pager": {
      "currentPage": 1,
      "totalPages": 5,
      "totalRecords": 98
    }
  }
}

GETÜrün Detayı

{{base_url}}/products/detail?id=1&lang_id=1

Bearer token gerekir

Belirtilen ürünün tüm alanlarını, dil çevirilerini, görselleri, varyantları, özellikleri ve ilişkili ürünleri döner.

Lansman tarihi üst düzeydeki delivery_date alanında döner (yazarken cargo.delivery_date kullanılır).
customizations: ürüne atanmış özelleştirme alanları; yazarken grup ID dizisi gönderilir.
store_code mağaza (model) kodudur; yazarken model_code alanı kullanılır.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`id`	`1`	Ürün ID — id veya code parametrelerinden en az biri zorunludur
`code`	—	Ürün kodu (alternatif olarak id yerine kullanılabilir)
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/products/detail?id=1&lang_id=1' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "id": 1,
    "name": "Örnek Ürün",
    "description": "<p>Ürün açıklaması</p>",
    "url": "https://www.example.com/ornek-urun",
    "permalink": "ornek-urun",
    "meta_title": "Örnek Ürün | Mağaza",
    "meta_description": "SEO açıklaması",
    "meta_keywords": "ürün, örnek",
    "tags": "etiket1, etiket2",
    "image": "https://www.example.com/uploads/urunler/example.jpg",
    "code": "PRD-001",
    "store_code": "STR-001",
    "mpn": "MPN123",
    "ean": "8690000000017",
    "barcode": "8690000000017",
    "price": 299.9,
    "old_price": 349.9,
    "tax": 18,
    "stock": 150,
    "stock_status": "active",
    "currency": "TRY",
    "status": "active",
    "sort": 0,
    "min_order_limit": 1,
    "max_order_limit": 10,
    "delivery_date": null,
    "close_online": false,
    "comment_status": true,
    "parcel": false,
    "condition": 1,
    "made_in": "TR",
    "expiration_date": null,
    "production_date": null,
    "date_start": null,
    "date_end": null,
    "showcase": {
      "is_featured": false,
      "has_discount": true,
      "new_ticket": false
    },
    "cargo": {
      "free_cargo_ticket": false,
      "delivery_days": 3,
      "desi": 2.5,
      "weight": 1.2,
      "width": 15,
      "height": 10,
      "depth": 5
    },
    "visibility": {
      "home": true,
      "category": true,
      "brand": true,
      "search": true,
      "price": true
    },
    "categories": [
      {
        "id": 3,
        "name": "Elektronik",
        "url": "elektronik"
      }
    ],
    "brands": [
      {
        "id": 2,
        "name": "Örnek Marka",
        "url": "ornek-marka"
      }
    ],
    "catalogs": [
      {
        "id": 1,
        "name": "Yaz Kataloğu",
        "url": "yaz-katalog"
      }
    ],
    "images": [
      {
        "image": "https://www.example.com/uploads/urunler/example.jpg"
      },
      {
        "image": "https://www.example.com/uploads/urunler/example2.jpg"
      }
    ],
    "videos": [
      {
        "id": 1,
        "url": "https://youtube.com/watch?v=xxx",
        "thumbnail": "https://www.example.com/uploads/urunler/thumb.jpg"
      }
    ],
    "attributes": [
      {
        "group_id": 1,
        "group_name": "Teknik Özellikler",
        "values": [
          {
            "attribute_id": 5,
            "attribute_name": "Malzeme",
            "value_id": 12,
            "value_name": "Pamuk"
          }
        ]
      }
    ],
    "variants": [
      {
        "name": "S - Kırmızı",
        "variant_code": "PRD-001-S-K",
        "stock": 50,
        "price_prefix": "+",
        "price": 0,
        "barcode": "1234567890123",
        "gtin": null,
        "mpn": null
      }
    ],
    "related_products": [
      {
        "id": 2,
        "name": "İlişkili Ürün"
      }
    ],
    "compatible_products": [
      {
        "id": 3,
        "name": "Uyumlu Ürün"
      }
    ],
    "customizations": [
      {
        "id": 3,
        "type": 2,
        "title": "Renk Seçin",
        "placeholder": "Bir renk seçin",
        "description": "Lütfen bir renk seçiniz",
        "input_type": "1",
        "min": "0",
        "max": "0",
        "required": true,
        "price": 0,
        "price_prefix": "+",
        "options": [
          {
            "id": 7,
            "name": "Kırmızı",
            "image": null,
            "price": 5,
            "price_prefix": "+"
          }
        ]
      }
    ],
    "created_at": 1747296000,
    "created_at_local": "15.05.2025 11:00:00",
    "updated_at": 1747382400,
    "updated_at_local": "16.05.2025 11:00:00"
  }
}

POSTÜrün Oluştur

{{base_url}}/products

Bearer token gerekirContent-Type: application/json

Yeni ürün oluşturur.

Zorunlu alanlar:

languages[] — tüm aktif diller için gönderilmeli (allActiveLangs); her dilde name zorunlu
code — benzersiz ürün kodu
price — ürün fiyatı
status — ürün durumu (active / inactive)
stock — stok adedi

Önemli notlar:

languages[] dizisi aktif tüm dilleri içermeli; eksik dil varsa validasyon hatası döner
old_price: indirimli fiyat gösterimi için eski/önceki fiyat (yoksa 0 gönderin)
tax: KDV oranı (gönderilmezse 0)
installment: taksit sayısı; 1–12 arası
model_code: mağaza (model) kodu; ean, barcode: barkod bilgileri. store_code ve mpn bu uçtan yazılamaz
brand_ids[]: birden fazla marka atanabilir
image: kapak görselinin URL'i; images[].image: ek görsellerin URL'leri. Sistem görselleri bu adreslerden indirir
permalink boş gönderilirse name alanından otomatik oluşturulur
cargo, showcase, visibility nesne olarak gönderilmeli
customizations[]: özelleştirme grubu ID dizisi
cargo.delivery_date: lansman tarihi (YYYY-AA-GG)
variants.values[]: her kombinasyon specs[] ile option_ids sırasıyla eşleşen option_id + option_value_id çiftlerini, stok adedini quantity ile taşır; model varyant kodudur ve mağaza genelinde benzersiz olmalıdır. Varyantlı ürünün stoğu varyant adetlerinin toplamı olur

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Örnek Ürün",
      "description": "<p>Ürün açıklaması</p>",
      "permalink": "ornek-urun",
      "meta_title": "Örnek Ürün | Mağaza",
      "meta_description": "SEO açıklaması",
      "meta_keywords": "ürün, örnek",
      "tags": "etiket1, etiket2"
    },
    {
      "lang_id": 2,
      "name": "Sample Product",
      "description": "<p>Product description</p>",
      "permalink": "sample-product",
      "meta_title": "Sample Product | Store",
      "meta_description": "SEO description",
      "meta_keywords": "product, sample",
      "tags": "tag1, tag2"
    }
  ],
  "code": "PRD-001",
  "model_code": "STR-001",
  "ean": "8690000000017",
  "barcode": "8690000000017",
  "price": 299.9,
  "old_price": 349.9,
  "tax": 18,
  "stock": 150,
  "currency_id": 1,
  "status": "active",
  "sort": 0,
  "installment": 1,
  "min_order_limit": 1,
  "max_order_limit": 0,
  "close_online": false,
  "comment_status": true,
  "parcel": null,
  "condition": 1,
  "made_in": "TR",
  "expiration_date": null,
  "production_date": null,
  "date_start": null,
  "date_end": null,
  "image_varyant_status": false,
  "showcase": {
    "is_featured": false,
    "has_discount": true,
    "new_ticket": false
  },
  "cargo": {
    "free_cargo_ticket": false,
    "delivery_days": 3,
    "delivery_date": null,
    "desi": 2.5,
    "weight": 1.2,
    "width": 15,
    "height": 10,
    "depth": 5
  },
  "visibility": {
    "home": true,
    "category": true,
    "brand": true,
    "search": true,
    "price": true
  },
  "brand_ids": [
    2,
    5
  ],
  "category_ids": [
    3
  ],
  "catalog_ids": [
    1
  ],
  "related_ids": [
    10,
    11
  ],
  "compatible_ids": [
    20
  ],
  "customizations": [
    1,
    3
  ],
  "image": "https://example.com/product-cover.jpg",
  "images": [
    {
      "image": "https://example.com/product1.jpg"
    },
    {
      "image": "https://example.com/product2.jpg"
    }
  ],
  "variants": {
    "option_ids": [
      1,
      2
    ],
    "values": [
      {
        "model": "PRD-001-S-K",
        "specs": [
          {
            "option_id": 1,
            "option_value_id": 3,
            "sort_order": 0
          },
          {
            "option_id": 2,
            "option_value_id": 7,
            "sort_order": 1
          }
        ],
        "price_prefix": "+",
        "price": 0,
        "quantity": 50,
        "barcode": "1234567890123",
        "gtin": "",
        "mpn": ""
      }
    ]
  },
  "attributes": [
    {
      "attribute_group_id": 1,
      "attribute_value_id": 5
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/products' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Örnek Ürün",
      "description": "<p>Ürün açıklaması</p>",
      "permalink": "ornek-urun",
      "meta_title": "Örnek Ürün | Mağaza",
      "meta_description": "SEO açıklaması",
      "meta_keywords": "ürün, örnek",
      "tags": "etiket1, etiket2"
    },
    {
      "lang_id": 2,
      "name": "Sample Product",
      "description": "<p>Product description</p>",
      "permalink": "sample-product",
      "meta_title": "Sample Product | Store",
      "meta_description": "SEO description",
      "meta_keywords": "product, sample",
      "tags": "tag1, tag2"
    }
  ],
  "code": "PRD-001",
  "model_code": "STR-001",
  "ean": "8690000000017",
  "barcode": "8690000000017",
  "price": 299.9,
  "old_price": 349.9,
  "tax": 18,
  "stock": 150,
  "currency_id": 1,
  "status": "active",
  "sort": 0,
  "installment": 1,
  "min_order_limit": 1,
  "max_order_limit": 0,
  "close_online": false,
  "comment_status": true,
  "parcel": null,
  "condition": 1,
  "made_in": "TR",
  "expiration_date": null,
  "production_date": null,
  "date_start": null,
  "date_end": null,
  "image_varyant_status": false,
  "showcase": {
    "is_featured": false,
    "has_discount": true,
    "new_ticket": false
  },
  "cargo": {
    "free_cargo_ticket": false,
    "delivery_days": 3,
    "delivery_date": null,
    "desi": 2.5,
    "weight": 1.2,
    "width": 15,
    "height": 10,
    "depth": 5
  },
  "visibility": {
    "home": true,
    "category": true,
    "brand": true,
    "search": true,
    "price": true
  },
  "brand_ids": [
    2,
    5
  ],
  "category_ids": [
    3
  ],
  "catalog_ids": [
    1
  ],
  "related_ids": [
    10,
    11
  ],
  "compatible_ids": [
    20
  ],
  "customizations": [
    1,
    3
  ],
  "image": "https://example.com/product-cover.jpg",
  "images": [
    {
      "image": "https://example.com/product1.jpg"
    },
    {
      "image": "https://example.com/product2.jpg"
    }
  ],
  "variants": {
    "option_ids": [
      1,
      2
    ],
    "values": [
      {
        "model": "PRD-001-S-K",
        "specs": [
          {
            "option_id": 1,
            "option_value_id": 3,
            "sort_order": 0
          },
          {
            "option_id": 2,
            "option_value_id": 7,
            "sort_order": 1
          }
        ],
        "price_prefix": "+",
        "price": 0,
        "quantity": 50,
        "barcode": "1234567890123",
        "gtin": "",
        "mpn": ""
      }
    ]
  },
  "attributes": [
    {
      "attribute_group_id": 1,
      "attribute_value_id": 5
    }
  ]
}'

Örnek yanıtlar

201 CreatedBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Product created successfully.",
    "product_id": 42
  }
}

422 Unprocessable EntityValidasyon Hatası

{
  "status": false,
  "error": "validation_error",
  "message": {
    "code": "Bu ürün kodu zaten kullanılıyor.",
    "languages.0.name": "Ürün adı zorunludur."
  }
}

PATCHÜrün Güncelle

{{base_url}}/products?id=42

Bearer token gerekirContent-Type: application/json

Mevcut ürünü günceller. Sadece gönderilen alanlar güncellenir.

Gövdede languages dizisi bulunmalıdır; ürün metinlerini değiştirmeyecekseniz [{"lang_id": 1}] gönderin.
permalink gönderilirse ürünün adresi değişir; adresi değiştirmeyecekseniz permalink göndermeyin.

TAM DEĞIŞTIRME (full replacement) davranışı — dikkat:

brand_ids[] gönderilirse tüm marka ilişkileri silinip yeniden yazılır
category_ids[] gönderilirse tüm kategori ilişkileri silinip yeniden yazılır
catalog_ids[] gönderilirse tüm katalog ilişkileri silinip yeniden yazılır
related_ids[] gönderilirse tüm ilişkili ürünler silinip yeniden yazılır
compatible_ids[] gönderilirse tüm uyumlu ürünler silinip yeniden yazılır
images[] gönderilirse eski görseller diskten silinir ve yenileri indirilir
variants{} gönderilirse (option_ids dolu iken) tüm varyantlar silinip gönderilen kombinasyonlar yeniden yazılır; values[] ürünün bütün kombinasyonlarını Ürün Oluştur'daki specs yapısıyla içermelidir
attributes[] gönderilirse tüm özellik değerleri silinip yeniden yazılır
customizations[] gönderilirse tüm özelleştirme atamaları silinip yeniden yazılır

Boş dizi göndermek ([]) ilgili tüm ilişkileri siler (varyantlar hariç).

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`id`	`42`	Güncellenecek ürün ID — id veya code parametrelerinden en az biri zorunludur
`code`	—	Ürün kodu (alternatif olarak id yerine kullanılabilir)

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Güncellenmiş Ürün",
      "description": "<p>Yeni açıklama</p>",
      "permalink": "guncellenmis-urun",
      "meta_title": "Güncellenmiş Ürün | Mağaza",
      "meta_description": "Güncel SEO açıklaması",
      "meta_keywords": "güncel, ürün",
      "tags": "yeni-etiket"
    }
  ],
  "price": 279.9,
  "old_price": 299.9,
  "stock": 200,
  "status": "active",
  "showcase": {
    "is_featured": true,
    "has_discount": true,
    "new_ticket": false
  },
  "cargo": {
    "free_cargo_ticket": true,
    "delivery_days": 2,
    "delivery_date": "2026-06-01"
  },
  "visibility": {
    "home": true,
    "search": true
  },
  "brand_ids": [
    2
  ],
  "category_ids": [
    3,
    7
  ],
  "catalog_ids": [
    1
  ],
  "related_ids": [
    10
  ],
  "compatible_ids": [],
  "customizations": [
    1
  ],
  "images": [
    {
      "image": "https://example.com/new-image.jpg"
    }
  ],
  "attributes": [
    {
      "attribute_group_id": 1,
      "attribute_value_id": 6
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/products?id=42' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Güncellenmiş Ürün",
      "description": "<p>Yeni açıklama</p>",
      "permalink": "guncellenmis-urun",
      "meta_title": "Güncellenmiş Ürün | Mağaza",
      "meta_description": "Güncel SEO açıklaması",
      "meta_keywords": "güncel, ürün",
      "tags": "yeni-etiket"
    }
  ],
  "price": 279.9,
  "old_price": 299.9,
  "stock": 200,
  "status": "active",
  "showcase": {
    "is_featured": true,
    "has_discount": true,
    "new_ticket": false
  },
  "cargo": {
    "free_cargo_ticket": true,
    "delivery_days": 2,
    "delivery_date": "2026-06-01"
  },
  "visibility": {
    "home": true,
    "search": true
  },
  "brand_ids": [
    2
  ],
  "category_ids": [
    3,
    7
  ],
  "catalog_ids": [
    1
  ],
  "related_ids": [
    10
  ],
  "compatible_ids": [],
  "customizations": [
    1
  ],
  "images": [
    {
      "image": "https://example.com/new-image.jpg"
    }
  ],
  "attributes": [
    {
      "attribute_group_id": 1,
      "attribute_value_id": 6
    }
  ]
}'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Product updated successfully.",
    "product_id": 42
  }
}

PATCHToplu Ürün Güncelle

{{base_url}}/products/bulk

Bearer token gerekirContent-Type: application/json

Birden fazla ürünü tek istekle günceller.

Tek istekte en fazla 50 ürün gönderilebilir
id veya code ile ürün belirlenir (ikisi de verilirse id önceliklidir)
Yalnızca skaler ve nesne alanlar güncellenebilir
languages[], images[], variants{}, attributes[], *_ids[] ilişki dizileri desteklenmez — bunlar için tekil PATCH /products?id= kullanın

Yanıtta:

updated_ids[]: başarıyla güncellenen ürün ID'leri
skipped[]: bulunamayan veya güncellenecek alanı olmayan ürünlerin id ya da code değerleri

Rate limit: 60 istek/dakika

İstek gövdesi

{
  "products": [
    {
      "id": 42,
      "price": 199.9,
      "stock": 50,
      "status": "active"
    },
    {
      "code": "PRD-002",
      "price": 249.9,
      "stock": 30,
      "status": "inactive"
    },
    {
      "id": 45,
      "old_price": 300,
      "showcase": {
        "is_featured": true,
        "has_discount": true,
        "new_ticket": false
      }
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/products/bulk' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "products": [
    {
      "id": 42,
      "price": 199.9,
      "stock": 50,
      "status": "active"
    },
    {
      "code": "PRD-002",
      "price": 249.9,
      "stock": 30,
      "status": "inactive"
    },
    {
      "id": 45,
      "old_price": 300,
      "showcase": {
        "is_featured": true,
        "has_discount": true,
        "new_ticket": false
      }
    }
  ]
}'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Bulk update completed.",
    "updated_ids": [
      42,
      45
    ],
    "updated_count": 2,
    "skipped": [
      "PRD-002"
    ]
  }
}

DELETEÜrün Sil

{{base_url}}/products?ids=42,43,44&codes=

Bearer token gerekir

Belirtilen ürünleri siler.

ids: ürün ID'leri, virgülle ayrılmış (örn: 42,43)
codes: ürün kodları, virgülle ayrılmış (örn: PRD-001,PRD-002)
ids ve codes birlikte kullanılabilir
Silme işlemi ürünün adres kayıtlarını, görsel dosyalarını, varyantları ve ilişkili kayıtları da temizler; aynı adrese tanımlı yönlendirmeler korunur

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`ids`	`42,43,44`	Silinecek ürün ID'leri (virgülle ayrılmış, max 50)
`codes`	—	Silinecek ürün kodları (virgülle ayrılmış)

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/products?ids=42,43,44&codes=' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Products deleted successfully.",
    "deleted_ids": [
      42,
      43,
      44
    ],
    "count": 3
  }
}

Varyantlar

5 uç nokta

Varyant tipleri (Renk, Beden vb.) ve değerlerini yönetir. filter_status / image_status alanları her zaman "active" veya "inactive" string olarak gönderilir ve döner. values[] PATCH'te tam değiştirme değildir — option_value_id verilirse güncelleme, verilmezse yeni değer eklenir.

GETVaryantlar Listesi

{{base_url}}/variants?search=&lang_id=1&sort=id&order=asc&page=1&limit=100

Bearer token gerekir

Varyant tiplerini sayfalı olarak listeler. Her kayıtta o varyanta ait değer sayısı (value_count) döner.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`search`	—	Varyant adına göre arama (LIKE)
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)
`sort`	`id`	Sıralama alanı: id \| name \| sort
`order`	`asc`	Sıralama yönü: asc \| desc
`page`	`1`	Sayfa numarası (varsayılan: 1)
`limit`	`100`	Sayfa başına kayıt (1–500, varsayılan: 100)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/variants?search=&lang_id=1&sort=id&order=asc&page=1&limit=100' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "total": 5,
    "page": 1,
    "limit": 100,
    "items": [
      {
        "option_id": "1",
        "name": "Renk",
        "type": "select",
        "sort_order": "0",
        "filter_status": "active",
        "image_status": "active",
        "value_count": "8"
      }
    ]
  }
}

GETVaryant Detayı

{{base_url}}/variants/detail?id=1&lang_id=1

Bearer token gerekir

Belirtilen varyant tipinin bilgilerini ve tüm değerlerini döner. values[].image tam URL olarak döner.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`id`	`1`	Varyant ID (zorunlu)
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/variants/detail?id=1&lang_id=1' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıtlar

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "option_id": "1",
    "name": "Renk",
    "type": "select",
    "sort_order": "0",
    "filter_status": "active",
    "image_status": "active",
    "values": [
      {
        "option_value_id": "5",
        "name": "Kırmızı",
        "image": "https://example.com/uploads/options/kirmizi.png",
        "sort_order": "0"
      },
      {
        "option_value_id": "6",
        "name": "Mavi",
        "image": "",
        "sort_order": "1"
      }
    ]
  }
}

404 Not FoundHata — Bulunamadı

{
  "status": false,
  "error": "not_found",
  "message": "Variant not found."
}

POSTVaryant Ekle

{{base_url}}/variants

Bearer token gerekirContent-Type: application/json

Yeni varyant tipi ve isteğe bağlı başlangıç değerleri oluşturur.

languages[] tüm aktif diller için zorunludur (allActiveLangs)
filter_status / image_status: "active" veya "inactive" (varsayılan: "inactive")
values[].image: https veya http URL olmalıdır (max 2048 karakter); sistem görseli indirir (ImageManager). Görsel gönderilmeyecekse alanı boş bırakın
Tüm DB yazımları (varyant + dil tanımları + değerler) tek transaction içinde gerçekleşir; görsel indirme işlemi transaction başlamadan önce yapılır, herhangi bir hata durumunda indirilen dosyalar otomatik olarak silinir

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk"
    },
    {
      "lang_id": 2,
      "name": "Color"
    },
    {
      "lang_id": 3,
      "name": "اللون"
    },
    {
      "lang_id": 4,
      "name": "Farbe"
    },
    {
      "lang_id": 5,
      "name": "Couleur"
    },
    {
      "lang_id": 6,
      "name": "Цвет"
    },
    {
      "lang_id": 7,
      "name": "Rəng"
    }
  ],
  "sort": 0,
  "filter_status": "active",
  "image_status": "active",
  "values": [
    {
      "sort": 0,
      "image": "https://example.com/kirmizi.png",
      "languages": [
        {
          "lang_id": 1,
          "name": "Kırmızı"
        },
        {
          "lang_id": 2,
          "name": "Red"
        }
      ]
    },
    {
      "sort": 1,
      "image": "",
      "languages": [
        {
          "lang_id": 1,
          "name": "Mavi"
        },
        {
          "lang_id": 2,
          "name": "Blue"
        }
      ]
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/variants' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk"
    },
    {
      "lang_id": 2,
      "name": "Color"
    },
    {
      "lang_id": 3,
      "name": "اللون"
    },
    {
      "lang_id": 4,
      "name": "Farbe"
    },
    {
      "lang_id": 5,
      "name": "Couleur"
    },
    {
      "lang_id": 6,
      "name": "Цвет"
    },
    {
      "lang_id": 7,
      "name": "Rəng"
    }
  ],
  "sort": 0,
  "filter_status": "active",
  "image_status": "active",
  "values": [
    {
      "sort": 0,
      "image": "https://example.com/kirmizi.png",
      "languages": [
        {
          "lang_id": 1,
          "name": "Kırmızı"
        },
        {
          "lang_id": 2,
          "name": "Red"
        }
      ]
    },
    {
      "sort": 1,
      "image": "",
      "languages": [
        {
          "lang_id": 1,
          "name": "Mavi"
        },
        {
          "lang_id": 2,
          "name": "Blue"
        }
      ]
    }
  ]
}'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Variant created successfully.",
    "option_id": 12
  }
}

PATCHVaryant Güncelle

{{base_url}}/variants?id=1

Bearer token gerekirContent-Type: application/json

Mevcut varyant tipini günceller. Sadece gönderilen alanlar işlenir. Gövdede languages dizisi bulunmalıdır; gönderilen dil öğelerinde mevcut adları da gönderin.

values[] davranışı (tam değiştirme DEĞİL):

option_value_id verilirse: o değer güncellenir (sort, image, languages — sadece gönderilenler)
option_value_id verilmezse: yeni değer eklenir
Değer silmek için bu endpoint kullanılmaz; silinecek değerler bu diziden çıkarılsa bile silinmez

values[].image: https veya http URL olmalıdır (max 2048 karakter). URL gönderilirse yeni görsel indirilir; eski görsel silinir

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`id`	`1`	Güncellenecek varyant ID (zorunlu)

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk (Güncel)"
    },
    {
      "lang_id": 2,
      "name": "Color (Updated)"
    }
  ],
  "sort": 1,
  "filter_status": "active",
  "image_status": "inactive",
  "values": [
    {
      "option_value_id": 5,
      "sort": 0,
      "image": "https://example.com/yeni-kirmizi.png",
      "languages": [
        {
          "lang_id": 1,
          "name": "Kırmızı"
        },
        {
          "lang_id": 2,
          "name": "Red"
        }
      ]
    },
    {
      "sort": 2,
      "languages": [
        {
          "lang_id": 1,
          "name": "Sarı"
        },
        {
          "lang_id": 2,
          "name": "Yellow"
        }
      ]
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/variants?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk (Güncel)"
    },
    {
      "lang_id": 2,
      "name": "Color (Updated)"
    }
  ],
  "sort": 1,
  "filter_status": "active",
  "image_status": "inactive",
  "values": [
    {
      "option_value_id": 5,
      "sort": 0,
      "image": "https://example.com/yeni-kirmizi.png",
      "languages": [
        {
          "lang_id": 1,
          "name": "Kırmızı"
        },
        {
          "lang_id": 2,
          "name": "Red"
        }
      ]
    },
    {
      "sort": 2,
      "languages": [
        {
          "lang_id": 1,
          "name": "Sarı"
        },
        {
          "lang_id": 2,
          "name": "Yellow"
        }
      ]
    }
  ]
}'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Variant updated successfully.",
    "option_id": 1
  }
}

DELETEVaryant Sil

{{base_url}}/variants?ids=1,2

Bearer token gerekir

Belirtilen varyant tiplerini ve bağlı tüm değerlerini siler.

ids: silinecek varyant ID'leri, virgülle ayrılmış (örn: 1,2,3)
Tek istekte en fazla 50 ID gönderilebilir
Bulunamayan ID'ler sessizce atlanır; en az bir geçerli ID olmalıdır

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`ids`	`1,2`	Silinecek varyant ID'leri, virgülle ayrılmış (zorunlu)

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/variants?ids=1,2' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Variants deleted successfully.",
    "deleted_ids": [
      1,
      2
    ],
    "count": 2
  }
}

Özellik Grupları

5 uç nokta

Ürün özellik gruplarına (Renk, Materyal vb.) ve özellik değerlerine ait işlemler. Her grup; özellikler (attributes) ve değerlerden (values) oluşur.

GETÖzellik Grubu Listesi

{{base_url}}/attributes

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Grup adında arama; Max 100 karakter
status	string	Durum filtresi; Values: active / inactive
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)
sort	string	Sıralanacak Alan; Values: id / name / sort / status
order	string	Sıralama Yönü; Values: asc / desc
page	integer	Sayfa Numarası; Min: 1
limit	integer	Limit; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "name": "Renk",
                "status": "active",
                "filter_status": "active",
                "sort": 0,
                "created_at": 1714500000,
                "updated_at": 1714500000,
                "created_at_local": "30.04.2024 12:00:00",
                "updated_at_local": "30.04.2024 12:00:00"
            },
            {
                "id": 2,
                "name": "Materyal",
                "status": "active",
                "filter_status": "inactive",
                "sort": 1,
                "created_at": 1714600000,
                "updated_at": 1714600000,
                "created_at_local": "01.05.2024 16:26:40",
                "updated_at_local": "01.05.2024 16:26:40"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/attributes' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETÖzellik Grubu Detayı

{{base_url}}/attributes/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Özellik Grubu ID
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)

Response (200 OK)

{
    "status": true,
    "data": {
        "attribute_id": 1,
        "name": "Renk",
        "status": "active",
        "filter_status": "active",
        "sort": 0,
        "created_at": 1714500000,
        "updated_at": 1714500000,
        "created_at_local": "30.04.2024 12:00:00",
        "updated_at_local": "30.04.2024 12:00:00",
        "attributes": [
            {
                "attribute_id": 3,
                "sort": 0,
                "status": "active",
                "show_type": 0,
                "languages": [
                    { "lang_id": 1, "name": "Renk Seçenekleri" },
                    { "lang_id": 2, "name": "Color Options" },
                    { "lang_id": 3, "name": "خيارات اللون" },
                    { "lang_id": 4, "name": "Farboptionen" },
                    { "lang_id": 5, "name": "Options de couleur" },
                    { "lang_id": 6, "name": "Цветовые варианты" },
                    { "lang_id": 7, "name": "Rəng Seçimləri" }
                ],
                "values": [
                    {
                        "attribute_value_id": 7,
                        "sort": 0,
                        "status": "active",
                        "languages": [
                            { "lang_id": 1, "name": "Kırmızı", "image": "" },
                            { "lang_id": 2, "name": "Red", "image": "" },
                            { "lang_id": 3, "name": "أحمر", "image": "" },
                            { "lang_id": 4, "name": "Rot", "image": "" },
                            { "lang_id": 5, "name": "Rouge", "image": "" },
                            { "lang_id": 6, "name": "Красный", "image": "" },
                            { "lang_id": 7, "name": "Qırmızı", "image": "" }
                        ]
                    },
                    {
                        "attribute_value_id": 8,
                        "sort": 1,
                        "status": "active",
                        "languages": [
                            { "lang_id": 1, "name": "Siyah", "image": "" },
                            { "lang_id": 2, "name": "Black", "image": "" },
                            { "lang_id": 3, "name": "أسود", "image": "" },
                            { "lang_id": 4, "name": "Schwarz", "image": "" },
                            { "lang_id": 5, "name": "Noir", "image": "" },
                            { "lang_id": 6, "name": "Чёрный", "image": "" },
                            { "lang_id": 7, "name": "Qara", "image": "" }
                        ]
                    }
                ]
            }
        ]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/attributes/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTÖzellik Grubu Ekle

{{base_url}}/attributes

Bearer token gerekirContent-Type: application/json

languages alanı zorunludur; tüm aktif diller için gönderilmesi gerekir.

Body (JSON)

Field	Type	Rules
languages	array - required	Grup adları; tüm aktif diller için gönderilmeli (allActiveLangs)
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ
languages.*.name	string - required	Grup adı; Max 255 karakter
status	string	Durum; Values: active / inactive (varsayılan: active)
filter_status	string	Filtre durumu; Values: active / inactive (varsayılan: inactive)
sort	integer	Sıralama; Min: 0 (varsayılan: 0)
attributes	array	Özellikler listesi; Max: 50 özellik
attributes.*.sort	integer	Özellik sıralaması; Min: 0 (varsayılan: 0)
attributes.*.status	string	Özellik durumu; Values: active / inactive (varsayılan: inactive)
attributes.*.show_type	integer	Gösterim tipi; Values: 0 (Görsel) / 1 (Metin) / 2 (Görsel ve Metin) (varsayılan: 0)
attributes.*.languages	array	Özelliğe ait dil verileri; tüm aktif diller gönderilmeli
attributes..languages..lang_id	integer	Dil ID
attributes..languages..name	string	Özellik adı; Max 255 karakter
attributes.*.values	array	Özelliğe ait değerler; Max: 200 değer
attributes..values..sort	integer	Değer sıralaması; Min: 0
attributes..values..status	string	Değer durumu; Values: active / inactive
attributes..values..languages	array	Değere ait dil verileri; tüm aktif diller gönderilmeli
attributes..values..languages.*.lang_id	integer	Dil ID
attributes..values..languages.*.name	string	Değer adı; Max 255 karakter
attributes..values..languages.*.image	string	Dile özgü görsel URL'i (opsiyonel); indirilip kaydedilir

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Attribute group created successfully.",
        "group_id": 3
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk"
    },
    {
      "lang_id": 2,
      "name": "Color"
    },
    {
      "lang_id": 3,
      "name": "اللون"
    },
    {
      "lang_id": 4,
      "name": "Farbe"
    },
    {
      "lang_id": 5,
      "name": "Couleur"
    },
    {
      "lang_id": 6,
      "name": "Цвет"
    },
    {
      "lang_id": 7,
      "name": "Rəng"
    }
  ],
  "status": "active",
  "filter_status": "active",
  "sort": 0,
  "attributes": [
    {
      "sort": 0,
      "status": "active",
      "show_type": 0,
      "languages": [
        {
          "lang_id": 1,
          "name": "Renk Seçenekleri"
        },
        {
          "lang_id": 2,
          "name": "Color Options"
        },
        {
          "lang_id": 3,
          "name": "خيارات اللون"
        },
        {
          "lang_id": 4,
          "name": "Farboptionen"
        },
        {
          "lang_id": 5,
          "name": "Options de couleur"
        },
        {
          "lang_id": 6,
          "name": "Цветовые варианты"
        },
        {
          "lang_id": 7,
          "name": "Rəng Seçimləri"
        }
      ],
      "values": [
        {
          "sort": 0,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Kırmızı",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Red",
              "image": ""
            },
            {
              "lang_id": 3,
              "name": "أحمر",
              "image": ""
            },
            {
              "lang_id": 4,
              "name": "Rot",
              "image": ""
            },
            {
              "lang_id": 5,
              "name": "Rouge",
              "image": ""
            },
            {
              "lang_id": 6,
              "name": "Красный",
              "image": ""
            },
            {
              "lang_id": 7,
              "name": "Qırmızı",
              "image": ""
            }
          ]
        },
        {
          "sort": 1,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Siyah",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Black",
              "image": ""
            },
            {
              "lang_id": 3,
              "name": "أسود",
              "image": ""
            },
            {
              "lang_id": 4,
              "name": "Schwarz",
              "image": ""
            },
            {
              "lang_id": 5,
              "name": "Noir",
              "image": ""
            },
            {
              "lang_id": 6,
              "name": "Чёрный",
              "image": ""
            },
            {
              "lang_id": 7,
              "name": "Qara",
              "image": ""
            }
          ]
        }
      ]
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/attributes' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk"
    },
    {
      "lang_id": 2,
      "name": "Color"
    },
    {
      "lang_id": 3,
      "name": "اللون"
    },
    {
      "lang_id": 4,
      "name": "Farbe"
    },
    {
      "lang_id": 5,
      "name": "Couleur"
    },
    {
      "lang_id": 6,
      "name": "Цвет"
    },
    {
      "lang_id": 7,
      "name": "Rəng"
    }
  ],
  "status": "active",
  "filter_status": "active",
  "sort": 0,
  "attributes": [
    {
      "sort": 0,
      "status": "active",
      "show_type": 0,
      "languages": [
        {
          "lang_id": 1,
          "name": "Renk Seçenekleri"
        },
        {
          "lang_id": 2,
          "name": "Color Options"
        },
        {
          "lang_id": 3,
          "name": "خيارات اللون"
        },
        {
          "lang_id": 4,
          "name": "Farboptionen"
        },
        {
          "lang_id": 5,
          "name": "Options de couleur"
        },
        {
          "lang_id": 6,
          "name": "Цветовые варианты"
        },
        {
          "lang_id": 7,
          "name": "Rəng Seçimləri"
        }
      ],
      "values": [
        {
          "sort": 0,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Kırmızı",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Red",
              "image": ""
            },
            {
              "lang_id": 3,
              "name": "أحمر",
              "image": ""
            },
            {
              "lang_id": 4,
              "name": "Rot",
              "image": ""
            },
            {
              "lang_id": 5,
              "name": "Rouge",
              "image": ""
            },
            {
              "lang_id": 6,
              "name": "Красный",
              "image": ""
            },
            {
              "lang_id": 7,
              "name": "Qırmızı",
              "image": ""
            }
          ]
        },
        {
          "sort": 1,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Siyah",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Black",
              "image": ""
            },
            {
              "lang_id": 3,
              "name": "أسود",
              "image": ""
            },
            {
              "lang_id": 4,
              "name": "Schwarz",
              "image": ""
            },
            {
              "lang_id": 5,
              "name": "Noir",
              "image": ""
            },
            {
              "lang_id": 6,
              "name": "Чёрный",
              "image": ""
            },
            {
              "lang_id": 7,
              "name": "Qara",
              "image": ""
            }
          ]
        }
      ]
    }
  ]
}'

PATCHÖzellik Grubu Düzenle

{{base_url}}/attributes?id=1

Bearer token gerekirContent-Type: application/json

Düzenleme için yalnızca değiştirmek istediğiniz alanları göndermeniz yeterlidir. Gönderilmeyen alanlar mevcut değerlerini korur.

Bir özelliği ya da değeri eklerken veya güncellerken languages dizisini tüm aktif dillerle gönderin; gönderilmeyen dillerin adları silinir. Özellik ve değerlerin sort, status, show_type alanları da yalnız aynı öğede languages gönderildiğinde işlenir.

attributes: [] (boş dizi) gönderilirse gruba ait tüm özellikler silinir. attributes alanı gönderilmezse mevcut özellikler korunur.

attributes içinde attribute_id varsa mevcut özellik güncellenir; yoksa yeni özellik eklenir. attribute_id gönderilmeyen mevcut özellikler silinmez.

values key gönderilmezse o özelliğin değerleri korunur. values: [] gönderilirse o özelliğin tüm değerleri silinir.

values içinde attribute_value_id varsa mevcut değer güncellenir; yoksa yeni değer eklenir.

id query parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Özellik Grubu ID

Body (JSON)

Field	Type	Rules
languages	array	Grup adları; gönderilen diller upsert edilir
languages.*.lang_id	integer	Dil ID
languages.*.name	string	Grup adı; Max 255 karakter
status	string	Durum; Values: active / inactive
filter_status	string	Filtre durumu; Values: active / inactive
sort	integer	Sıralama; Min: 0
attributes	array	Özellikler; boş dizi → tümünü sil; Max: 50 özellik
attributes.*.attribute_id	integer	Mevcut özellik ID; varsa günceller, yoksa yeni ekler
attributes.*.sort	integer	Özellik sıralaması; Min: 0
attributes.*.status	string	Özellik durumu; Values: active / inactive
attributes.*.show_type	integer	Gösterim tipi; Values: 0 (Görsel) / 1 (Metin) / 2 (Görsel ve Metin)
attributes.*.languages	array	Özelliğe ait dil verileri
attributes..languages..lang_id	integer	Dil ID
attributes..languages..name	string	Özellik adı; Max 255 karakter
attributes.*.values	array	Değerler; key yoksa dokunulmaz, boş dizi → tümünü sil; Max: 200 değer
attributes..values..attribute_value_id	integer	Mevcut değer ID; varsa günceller, yoksa yeni ekler
attributes..values..sort	integer	Değer sıralaması; Min: 0
attributes..values..status	string	Değer durumu; Values: active / inactive
attributes..values..languages	array	Değere ait dil verileri
attributes..values..languages.*.lang_id	integer	Dil ID
attributes..values..languages.*.name	string	Değer adı; Max 255 karakter
attributes..values..languages.*.image	string	Dile özgü görsel URL'i (opsiyonel); yeni URL gelirse indirilip güncellenir, gelmezse mevcut korunur

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Attribute group updated successfully.",
        "group_id": 1
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk (Güncel)"
    },
    {
      "lang_id": 2,
      "name": "Color (Updated)"
    }
  ],
  "status": "active",
  "filter_status": "active",
  "sort": 1,
  "attributes": [
    {
      "attribute_id": 3,
      "sort": 0,
      "status": "active",
      "show_type": 0,
      "languages": [
        {
          "lang_id": 1,
          "name": "Renk Seçenekleri (Güncel)"
        },
        {
          "lang_id": 2,
          "name": "Color Options (Updated)"
        }
      ],
      "values": [
        {
          "attribute_value_id": 7,
          "sort": 0,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Kırmızı",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Red",
              "image": ""
            }
          ]
        },
        {
          "sort": 2,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Mavi",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Blue",
              "image": ""
            }
          ]
        }
      ]
    },
    {
      "sort": 1,
      "status": "active",
      "show_type": 0,
      "languages": [
        {
          "lang_id": 1,
          "name": "Yeni Özellik"
        },
        {
          "lang_id": 2,
          "name": "New Attribute"
        }
      ]
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/attributes?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk (Güncel)"
    },
    {
      "lang_id": 2,
      "name": "Color (Updated)"
    }
  ],
  "status": "active",
  "filter_status": "active",
  "sort": 1,
  "attributes": [
    {
      "attribute_id": 3,
      "sort": 0,
      "status": "active",
      "show_type": 0,
      "languages": [
        {
          "lang_id": 1,
          "name": "Renk Seçenekleri (Güncel)"
        },
        {
          "lang_id": 2,
          "name": "Color Options (Updated)"
        }
      ],
      "values": [
        {
          "attribute_value_id": 7,
          "sort": 0,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Kırmızı",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Red",
              "image": ""
            }
          ]
        },
        {
          "sort": 2,
          "status": "active",
          "languages": [
            {
              "lang_id": 1,
              "name": "Mavi",
              "image": ""
            },
            {
              "lang_id": 2,
              "name": "Blue",
              "image": ""
            }
          ]
        }
      ]
    },
    {
      "sort": 1,
      "status": "active",
      "show_type": 0,
      "languages": [
        {
          "lang_id": 1,
          "name": "Yeni Özellik"
        },
        {
          "lang_id": 2,
          "name": "New Attribute"
        }
      ]
    }
  ]
}'

DELETEÖzellik Grubu Sil

{{base_url}}/attributes?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem; grubu, tüm özelliklerini, tüm değerlerini ve dil kayıtlarını kalıcı olarak siler. Geri alınamaz.

Birden fazla grup aynı anda silinebilir.

Query Parameters

Field	Type	Description
id	string - required	Silinecek özellik grubu ID'leri; virgülle ayrılmış. Örn: 1,2,3

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Attribute group deleted successfully.",
        "deleted_ids": [1]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/attributes?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Markalar

5 uç nokta

Ürün markalarına ait işlemler. Her marka; çok dilli ad, açıklama, SEO ve yetkili satıcı belgesi (auth_doc) bilgilerini içerir.

GETMarka Listesi

{{base_url}}/brands

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Marka adı veya URL'de arama; Max 100 karakter
status	string	Durum filtresi; Values: active / inactive
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)
sort	string	Sıralanacak Alan; Values: id / name / order / status
order	string	Sıralama Yönü; Values: asc / desc
page	integer	Sayfa Numarası; Min: 1
limit	integer	Limit; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "status": "active",
                "image": "https://www.example.com/uploads/markalar/nike.png",
                "order": 0,
                "lang_id": 1,
                "name": "Nike",
                "url": "https://www.example.com/nike",
                "created_at": 1714500000,
                "updated_at": 1714500000,
                "created_at_local": "30.04.2024 12:00:00",
                "updated_at_local": "30.04.2024 12:00:00"
            },
            {
                "id": 2,
                "status": "active",
                "image": "",
                "order": 1,
                "lang_id": 1,
                "name": "Adidas",
                "url": "https://www.example.com/adidas",
                "created_at": 1714600000,
                "updated_at": 1714600000,
                "created_at_local": "01.05.2024 16:26:40",
                "updated_at_local": "01.05.2024 16:26:40"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/brands' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETMarka Detayı

{{base_url}}/brands/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Marka ID
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 1,
        "lang_id": 1,
        "order": 0,
        "image": "https://www.example.com/uploads/markalar/nike.png",
        "status": "active",
        "filter_status": "active",
        "image_status": "inactive",
        "auth_doc_status": "inactive",
        "auth_doc_sub": "",
        "auth_doc_main": "",
        "auth_doc_desc": "",
        "name": "Nike",
        "description": "<p>Nike hakkında açıklama</p>",
        "permalink": "nike",
        "url": "https://www.example.com/nike",
        "meta_title": "Nike - Spor Ayakkabı ve Giyim",
        "meta_description": "Nike ürünlerini keşfedin.",
        "meta_keywords": "nike, spor, ayakkabı",
        "created_at": 1714500000,
        "updated_at": 1714500000,
        "created_at_local": "30.04.2024 12:00:00",
        "updated_at_local": "30.04.2024 12:00:00"
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/brands/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTMarka Ekle

{{base_url}}/brands

Bearer token gerekirContent-Type: application/json

languages alanı zorunludur; tüm aktif diller için gönderilmesi gerekir.

permalink gönderilmezse name alanından otomatik oluşturulur. Aynı permalink sistemde varsa otomatik suffix eklenir (örn. nike-1).

image olarak geçerli bir URL gönderilirse görsel indirilip sunucuya kaydedilir.

Body (JSON)

Field	Type	Rules
languages	array - required	Dil verileri; tüm aktif diller için gönderilmeli (allActiveLangs)
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ
languages.*.name	string - required	Marka adı; Min 1 Max 255 karakter
languages.*.description	string	Marka açıklaması; HTML içerik kabul edilir; Max 100000 karakter
languages.*.permalink	string	SEO URL; Max 255 karakter; boş bırakılırsa name'den otomatik üretilir
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
languages.*.auth_doc_sub	string	Yetkili satıcı belgesi alt başlık; Max 255 karakter
languages.*.auth_doc_main	string	Yetkili satıcı belgesi ana başlık; Max 255 karakter
languages.*.auth_doc_desc	string	Yetkili satıcı belgesi açıklaması; HTML içerik kabul edilir; Max 100000 karakter
status	string	Durum; Values: active / inactive (varsayılan: active)
filter_status	string	Filtre durumu; Values: active / inactive (varsayılan: inactive)
auth_doc_status	string	Yetkili satıcı belgesi durumu; Values: active / inactive (varsayılan: inactive)
image_status	string	Görsel durumu; Values: active / inactive (varsayılan: inactive)
order	integer	Sıralama; Min 0 Max 99999 (varsayılan: 0)
image	string	Marka görseli URL'i; geçerli URL olmalı; indirilip kaydedilir

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Brand created successfully.",
        "brand_id": 3
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Nike",
      "description": "<p>Nike hakkında açıklama</p>",
      "permalink": "nike",
      "meta_title": "Nike - Spor Ayakkabı ve Giyim",
      "meta_description": "Nike ürünlerini keşfedin.",
      "meta_keywords": "nike, spor, ayakkabı",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 2,
      "name": "Nike",
      "description": "<p>About Nike</p>",
      "permalink": "nike",
      "meta_title": "Nike - Sports Shoes & Clothing",
      "meta_description": "Discover Nike products.",
      "meta_keywords": "nike, sport, shoes",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 3,
      "name": "نايك",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 4,
      "name": "Nike",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 5,
      "name": "Nike",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 6,
      "name": "Найк",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 7,
      "name": "Nike",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    }
  ],
  "status": "active",
  "filter_status": "inactive",
  "auth_doc_status": "inactive",
  "image_status": "inactive",
  "order": 0,
  "image": "https://example.com/nike-logo.png"
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/brands' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Nike",
      "description": "<p>Nike hakkında açıklama</p>",
      "permalink": "nike",
      "meta_title": "Nike - Spor Ayakkabı ve Giyim",
      "meta_description": "Nike ürünlerini keşfedin.",
      "meta_keywords": "nike, spor, ayakkabı",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 2,
      "name": "Nike",
      "description": "<p>About Nike</p>",
      "permalink": "nike",
      "meta_title": "Nike - Sports Shoes & Clothing",
      "meta_description": "Discover Nike products.",
      "meta_keywords": "nike, sport, shoes",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 3,
      "name": "نايك",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 4,
      "name": "Nike",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 5,
      "name": "Nike",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 6,
      "name": "Найк",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    },
    {
      "lang_id": 7,
      "name": "Nike",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": "",
      "auth_doc_sub": "",
      "auth_doc_main": "",
      "auth_doc_desc": ""
    }
  ],
  "status": "active",
  "filter_status": "inactive",
  "auth_doc_status": "inactive",
  "image_status": "inactive",
  "order": 0,
  "image": "https://example.com/nike-logo.png"
}'

PATCHMarka Düzenle

{{base_url}}/brands?id=1

Bearer token gerekirContent-Type: application/json

Düzenleme için yalnızca değiştirmek istediğiniz alanları göndermeniz yeterlidir. Gönderilmeyen alanlar mevcut değerlerini korur.

languages içinde yalnızca gönderilen diller güncellenir (upsert). Gönderilmeyen dil kayıtları silinmez.

permalink bu endpoint üzerinden güncellenebilir; eski adres kaldırılır. Adresi değiştirmeyecekseniz permalink göndermeyin.

id query parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Marka ID

Body (JSON)

Field	Type	Rules
languages	array	Dil verileri; gönderilen diller upsert edilir; Max 20 giriş
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ
languages.*.name	string	Marka adı; Min 1 Max 255 karakter
languages.*.description	string	Marka açıklaması; HTML içerik kabul edilir; Max 100000 karakter
languages.*.permalink	string	SEO URL; Max 255 karakter; adresi değiştirmeyecekseniz göndermeyin
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
languages.*.doc_sub	string	Yetkili satıcı belgesi alt başlık; Max 255 karakter
languages.*.doc_main	string	Yetkili satıcı belgesi ana başlık; Max 255 karakter
languages.*.doc_desc	string	Yetkili satıcı belgesi açıklaması; HTML içerik kabul edilir; Max 100000 karakter
status	string	Durum; Values: active / inactive
filter_status	string	Filtre durumu; Values: active / inactive
doc_status	string	Yetkili satıcı belgesi durumu; Values: active / inactive
image_status	string	Görsel durumu; Values: active / inactive
order	integer	Sıralama; Min 0 Max 99999
image	string	Marka görseli URL'i; yeni URL gelirse indirilip güncellenir

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Brand updated successfully.",
        "brand_id": 1
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Nike (Güncel)",
      "meta_title": "Nike - Yeni Sezon"
    },
    {
      "lang_id": 2,
      "name": "Nike (Updated)",
      "meta_title": "Nike - New Season"
    }
  ],
  "status": "active",
  "filter_status": "active",
  "order": 1,
  "image": "https://example.com/nike-logo-new.png"
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/brands?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Nike (Güncel)",
      "meta_title": "Nike - Yeni Sezon"
    },
    {
      "lang_id": 2,
      "name": "Nike (Updated)",
      "meta_title": "Nike - New Season"
    }
  ],
  "status": "active",
  "filter_status": "active",
  "order": 1,
  "image": "https://example.com/nike-logo-new.png"
}'

DELETEMarka Sil

{{base_url}}/brands?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem; markayı, tüm dil kayıtlarını, görselini ve route (SEO URL) kayıtlarını kalıcı olarak siler. Geri alınamaz.

Birden fazla marka aynı anda silinebilir.

Query Parameters

Field	Type	Description
id	string - required	Silinecek marka ID'leri; virgülle ayrılmış. Örn: 1,2,3

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Brand deleted successfully.",
        "deleted_ids": [1]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/brands?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Kataloglar

5 uç nokta

Ürün kataloglarına ait işlemler. Her katalog; çok dilli ad, açıklama, SEO bilgileri ve kataloğa bağlı ürün listesini içerir.

GETKatalog Listesi

{{base_url}}/catalogs

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Katalog adı veya URL'de arama; Max 200 karakter
status	string	Durum filtresi; Values: active / inactive
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1); yalnızca aktif diller kabul edilir
sort	string	Sıralanacak Alan; Values: id / name / sort / status
order	string	Sıralama Yönü; Values: asc / desc
page	integer	Sayfa Numarası; Min: 1
limit	integer	Limit; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "status": "active",
                "image": "https://www.example.com/uploads/katalog/yaz-koleksiyonu.png",
                "order": 0,
                "lang_id": 1,
                "name": "Yaz Koleksiyonu",
                "url": "https://www.example.com/yaz-koleksiyonu",
                "created_at": 1714500000,
                "updated_at": 1714500000,
                "created_at_local": "30.04.2024 12:00:00",
                "updated_at_local": "30.04.2024 12:00:00"
            },
            {
                "id": 2,
                "status": "active",
                "image": "",
                "order": 1,
                "lang_id": 1,
                "name": "Kış Sezonu",
                "url": "https://www.example.com/kis-sezonu",
                "created_at": 1714600000,
                "updated_at": 1714600000,
                "created_at_local": "01.05.2024 16:26:40",
                "updated_at_local": "01.05.2024 16:26:40"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/catalogs' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETKatalog Detayı

{{base_url}}/catalogs/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Katalog ID
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 1,
        "lang_id": 1,
        "order": 0,
        "image": "https://www.example.com/uploads/katalog/yaz-koleksiyonu.png",
        "status": "active",
        "name": "Yaz Koleksiyonu",
        "description": "<p>Yaz koleksiyonu hakkında açıklama</p>",
        "permalink": "yaz-koleksiyonu",
        "url": "https://www.example.com/yaz-koleksiyonu",
        "meta_title": "Yaz Koleksiyonu - 2024",
        "meta_description": "Yaz koleksiyonu ürünlerini keşfedin.",
        "meta_keywords": "yaz, koleksiyon, 2024",
        "created_at": 1714500000,
        "updated_at": 1714500000,
        "created_at_local": "30.04.2024 12:00:00",
        "updated_at_local": "30.04.2024 12:00:00",
        "products": [
            {
                "product_id": 42,
                "sort_order": 0,
                "name": "Yazlık Gömlek"
            },
            {
                "product_id": 57,
                "sort_order": 1,
                "name": "Plaj Şortu"
            }
        ]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/catalogs/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTKatalog Ekle

{{base_url}}/catalogs

Bearer token gerekirContent-Type: application/json

languages alanı zorunludur; tüm aktif diller için gönderilmesi gerekir.

permalink gönderilmezse name alanından otomatik oluşturulur. Aynı permalink sistemde varsa otomatik suffix eklenir (örn. yaz-koleksiyonu-1).

image olarak geçerli bir URL gönderilirse görsel indirilip sunucuya kaydedilir.

Body (JSON)

Field	Type	Rules
languages	array - required	Dil verileri; tüm aktif diller için gönderilmeli (allActiveLangs)
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ; yalnızca aktif diller kabul edilir
languages.*.name	string - required	Katalog adı; Min 1 Max 255 karakter
languages.*.description	string	Katalog açıklaması; HTML içerik kabul edilir; Max 100000 karakter
languages.*.permalink	string	SEO URL; Max 255 karakter; boş bırakılırsa name'den otomatik üretilir
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
status	string	Durum; Values: active / inactive (varsayılan: active)
sort	integer	Sıralama; Min: 0 Max: 99999 (varsayılan: 0)
image	string	Katalog görseli URL'i; geçerli URL olmalı; indirilip kaydedilir
products	array	Kataloğa eklenecek ürünler; Max 500 ürün
products.*.product_id	integer	Ürün ID; Min: 1
products.*.sort_order	integer	Katalog içi sıralama; Min: 0

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Catalog created successfully.",
        "catalog_id": 3
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Yaz Koleksiyonu",
      "description": "<p>Yaz koleksiyonu açıklaması</p>",
      "permalink": "yaz-koleksiyonu",
      "meta_title": "Yaz Koleksiyonu - 2024",
      "meta_description": "Yaz koleksiyonu ürünlerini keşfedin.",
      "meta_keywords": "yaz, koleksiyon, 2024"
    },
    {
      "lang_id": 2,
      "name": "Summer Collection",
      "description": "<p>Summer collection description</p>",
      "permalink": "summer-collection",
      "meta_title": "Summer Collection - 2024",
      "meta_description": "Discover summer collection products.",
      "meta_keywords": "summer, collection, 2024"
    },
    {
      "lang_id": 3,
      "name": "مجموعة الصيف",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 4,
      "name": "Sommerkollektion",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 5,
      "name": "Collection été",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 6,
      "name": "Летняя коллекция",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 7,
      "name": "Yay Kolleksiyası",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "status": "active",
  "sort": 0,
  "image": "https://example.com/yaz-koleksiyonu.png",
  "products": [
    {
      "product_id": 42,
      "sort_order": 0
    },
    {
      "product_id": 57,
      "sort_order": 1
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/catalogs' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Yaz Koleksiyonu",
      "description": "<p>Yaz koleksiyonu açıklaması</p>",
      "permalink": "yaz-koleksiyonu",
      "meta_title": "Yaz Koleksiyonu - 2024",
      "meta_description": "Yaz koleksiyonu ürünlerini keşfedin.",
      "meta_keywords": "yaz, koleksiyon, 2024"
    },
    {
      "lang_id": 2,
      "name": "Summer Collection",
      "description": "<p>Summer collection description</p>",
      "permalink": "summer-collection",
      "meta_title": "Summer Collection - 2024",
      "meta_description": "Discover summer collection products.",
      "meta_keywords": "summer, collection, 2024"
    },
    {
      "lang_id": 3,
      "name": "مجموعة الصيف",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 4,
      "name": "Sommerkollektion",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 5,
      "name": "Collection été",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 6,
      "name": "Летняя коллекция",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 7,
      "name": "Yay Kolleksiyası",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "status": "active",
  "sort": 0,
  "image": "https://example.com/yaz-koleksiyonu.png",
  "products": [
    {
      "product_id": 42,
      "sort_order": 0
    },
    {
      "product_id": 57,
      "sort_order": 1
    }
  ]
}'

PATCHKatalog Düzenle

{{base_url}}/catalogs?id=1

Bearer token gerekirContent-Type: application/json

Düzenleme için yalnızca değiştirmek istediğiniz alanları göndermeniz yeterlidir. Gönderilmeyen alanlar mevcut değerlerini korur.

languages içinde yalnızca gönderilen diller güncellenir (upsert). Gönderilmeyen dil kayıtları silinmez.

products gönderilirse katalogdaki tüm mevcut ürünler silinir ve yerine gönderilen liste yazılır. Ürün listesini korumak istiyorsanız bu alanı body'e dahil etmeyin.

id query parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Katalog ID

Body (JSON)

Field	Type	Rules
languages	array	Dil verileri; gönderilen diller upsert edilir; Max 20 dil
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ; yalnızca aktif diller kabul edilir
languages.*.name	string	Katalog adı; Min 1 Max 255 karakter
languages.*.description	string	Katalog açıklaması; HTML içerik kabul edilir; Max 100000 karakter
languages.*.permalink	string	SEO URL; Max 255 karakter; adresi değiştirmeyecekseniz göndermeyin
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
status	string	Durum; Values: active / inactive
sort	integer	Sıralama; Min: 0 Max: 99999
image	string	Katalog görseli URL'i; yeni URL gelirse indirilip güncellenir; eski görsel commit sonrası silinir
products	array	Katalog ürün listesi; gönderilirse mevcut liste tamamen değiştirilir; Max 500 ürün
products.*.product_id	integer	Ürün ID; Min: 1
products.*.sort_order	integer	Katalog içi sıralama; Min: 0

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Catalog updated successfully.",
        "catalog_id": 1
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Yaz Koleksiyonu (Güncel)",
      "meta_title": "Yaz Koleksiyonu - Yeni Sezon"
    },
    {
      "lang_id": 2,
      "name": "Summer Collection (Updated)",
      "meta_title": "Summer Collection - New Season"
    }
  ],
  "status": "active",
  "sort": 1,
  "image": "https://example.com/yaz-koleksiyonu-yeni.png",
  "products": [
    {
      "product_id": 42,
      "sort_order": 0
    },
    {
      "product_id": 57,
      "sort_order": 1
    },
    {
      "product_id": 88,
      "sort_order": 2
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/catalogs?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Yaz Koleksiyonu (Güncel)",
      "meta_title": "Yaz Koleksiyonu - Yeni Sezon"
    },
    {
      "lang_id": 2,
      "name": "Summer Collection (Updated)",
      "meta_title": "Summer Collection - New Season"
    }
  ],
  "status": "active",
  "sort": 1,
  "image": "https://example.com/yaz-koleksiyonu-yeni.png",
  "products": [
    {
      "product_id": 42,
      "sort_order": 0
    },
    {
      "product_id": 57,
      "sort_order": 1
    },
    {
      "product_id": 88,
      "sort_order": 2
    }
  ]
}'

DELETEKatalog Sil

{{base_url}}/catalogs?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem; kataloğu, tüm dil kayıtlarını, görselini, route (SEO URL) kayıtlarını ve ürün bağlantılarını kalıcı olarak siler. Geri alınamaz.

Birden fazla katalog aynı anda silinebilir. Tek seferde maksimum 50 ID.

Query Parameters

Field	Type	Description
id	string - required	Silinecek katalog ID'leri; virgülle ayrılmış. Örn: 1,2,3

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Catalog deleted successfully.",
        "deleted_ids": [1]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/catalogs?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Kategoriler

5 uç nokta

Ürün kategorilerine ait işlemler. Kategoriler hiyerarşik yapıdadır; parent_id ile üst kategori atanır. Her kategori; çok dilli ad, açıklama, SEO bilgileri, fırsat ürünleri ve Google kategori eşlemesi içerebilir.

GETKategori Listesi

{{base_url}}/categories

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Kategori adı veya URL'de arama; Max 200 karakter
status	string	Durum filtresi; Values: active / inactive
parent_id	integer	Üst kategori ID filtresi; 0 göndererek sadece ana kategoriler listelenebilir
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1); yalnızca aktif diller kabul edilir
sort	string	Sıralanacak Alan; Values: id / name / order
order	string	Sıralama Yönü; Values: asc / desc
page	integer	Sayfa Numarası; Min: 1
limit	integer	Limit; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "parent": 0,
                "status": "active",
                "image": "https://www.example.com/uploads/kategoriler/giyim.png",
                "order": 0,
                "lang_id": 1,
                "name": "Giyim",
                "url": "https://www.example.com/giyim",
                "created_at": 1714500000,
                "updated_at": 1714500000,
                "created_at_local": "30.04.2024 12:00:00",
                "updated_at_local": "30.04.2024 12:00:00"
            },
            {
                "id": 2,
                "parent": 1,
                "status": "active",
                "image": "",
                "order": 0,
                "lang_id": 1,
                "name": "Erkek Giyim",
                "url": "https://www.example.com/erkek-giyim",
                "created_at": 1714600000,
                "updated_at": 1714600000,
                "created_at_local": "01.05.2024 16:26:40",
                "updated_at_local": "01.05.2024 16:26:40"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/categories' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETKategori Detayı

{{base_url}}/categories/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Kategori ID
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 2,
        "parent": {
            "id": 1,
            "name": "Giyim"
        },
        "status": "active",
        "image": "",
        "order": 0,
        "installment": 1,
        "filter_status": "inactive",
        "lang_id": 1,
        "name": "Erkek Giyim",
        "description": "<p>Erkek giyim kategorisi açıklaması</p>",
        "meta_title": "Erkek Giyim Ürünleri",
        "meta_description": "Erkek giyim ürünlerini keşfedin.",
        "meta_keywords": "erkek, giyim, moda",
        "permalink": "erkek-giyim",
        "url": "https://www.example.com/erkek-giyim",
        "created_at": 1714600000,
        "updated_at": 1714600000,
        "created_at_local": "01.05.2024 16:26:40",
        "updated_at_local": "01.05.2024 16:26:40",
        "opportunity_products": [
            { "id": 42, "name": "Erkek T-Shirt" },
            { "id": 57, "name": "Erkek Pantolon" }
        ],
        "google_category": {
            "id": 185,
            "name": "Giyim ve Aksesuar",
            "code": 166
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/categories/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTKategori Ekle

{{base_url}}/categories

Bearer token gerekirContent-Type: application/json

languages alanı zorunludur; tüm aktif diller için gönderilmesi gerekir.

permalink gönderilmezse name alanından otomatik oluşturulur. Aynı permalink sistemde varsa otomatik suffix eklenir.

parent_id gönderilmezse ana kategori olarak oluşturulur; ana kategori için alanı göndermeyin.

image olarak geçerli bir URL gönderilirse görsel indirilip sunucuya kaydedilir.

Body (JSON)

Field	Type	Rules
languages	array - required	Dil verileri; tüm aktif diller için gönderilmeli (allActiveLangs)
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ; yalnızca aktif diller kabul edilir
languages.*.name	string - required	Kategori adı; Min 1 Max 255 karakter
languages.*.description	string	Kategori açıklaması; HTML içerik kabul edilir; Max 100000 karakter
languages.*.permalink	string	SEO URL; Max 255 karakter; boş bırakılırsa name'den otomatik üretilir
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
parent_id	integer	Üst kategori ID; kayıtlı bir kategori olmalı. Gönderilmezse ana kategori olur
status	string	Durum; Values: active / inactive (varsayılan: active)
order	integer	Sıralama; Min: 0 Max: 99999 (varsayılan: 0)
filter_status	string	Filtre durumu; Values: active / inactive (varsayılan: inactive)
installment	integer	Taksit sayısı; Values: 1–12 (varsayılan: 1; aralık dışı değer 1'e düşer)
google_category	string	Google kategori ID; Max 100 karakter
image	string	Kategori görseli URL'i; geçerli URL olmalı; indirilip kaydedilir
opportunity_products	string	Fırsat ürün ID'leri; virgülle ayrılmış tam sayılar; Max 1000 karakter. Örn: "42,57,88"

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Category created successfully.",
        "category_id": 3
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Erkek Giyim",
      "description": "<p>Erkek giyim açıklaması</p>",
      "permalink": "erkek-giyim",
      "meta_title": "Erkek Giyim Ürünleri",
      "meta_description": "Erkek giyim ürünlerini keşfedin.",
      "meta_keywords": "erkek, giyim, moda"
    },
    {
      "lang_id": 2,
      "name": "Men's Clothing",
      "description": "<p>Men's clothing description</p>",
      "permalink": "mens-clothing",
      "meta_title": "Men's Clothing Products",
      "meta_description": "Discover men's clothing products.",
      "meta_keywords": "men, clothing, fashion"
    },
    {
      "lang_id": 3,
      "name": "ملابس رجالية",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 4,
      "name": "Herrenbekleidung",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 5,
      "name": "Vêtements homme",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 6,
      "name": "Мужская одежда",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 7,
      "name": "Kişi geyimi",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "parent_id": 1,
  "status": "active",
  "order": 0,
  "filter_status": "inactive",
  "installment": 1,
  "google_category": "185",
  "image": "https://example.com/erkek-giyim.png",
  "opportunity_products": "42,57,88"
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/categories' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Erkek Giyim",
      "description": "<p>Erkek giyim açıklaması</p>",
      "permalink": "erkek-giyim",
      "meta_title": "Erkek Giyim Ürünleri",
      "meta_description": "Erkek giyim ürünlerini keşfedin.",
      "meta_keywords": "erkek, giyim, moda"
    },
    {
      "lang_id": 2,
      "name": "Men'\''s Clothing",
      "description": "<p>Men'\''s clothing description</p>",
      "permalink": "mens-clothing",
      "meta_title": "Men'\''s Clothing Products",
      "meta_description": "Discover men'\''s clothing products.",
      "meta_keywords": "men, clothing, fashion"
    },
    {
      "lang_id": 3,
      "name": "ملابس رجالية",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 4,
      "name": "Herrenbekleidung",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 5,
      "name": "Vêtements homme",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 6,
      "name": "Мужская одежда",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 7,
      "name": "Kişi geyimi",
      "description": "",
      "permalink": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "parent_id": 1,
  "status": "active",
  "order": 0,
  "filter_status": "inactive",
  "installment": 1,
  "google_category": "185",
  "image": "https://example.com/erkek-giyim.png",
  "opportunity_products": "42,57,88"
}'

PATCHKategori Düzenle

{{base_url}}/categories?id=2

Bearer token gerekirContent-Type: application/json

Düzenleme için yalnızca değiştirmek istediğiniz alanları göndermeniz yeterlidir. Gönderilmeyen alanlar mevcut değerlerini korur.

languages içinde yalnızca gönderilen diller güncellenir (upsert). Gönderilmeyen dil kayıtları silinmez.

opportunity_products boş string ("") gönderilirse fırsat ürünleri temizlenir. Alan hiç gönderilmezse mevcut liste korunur.

id query parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Kategori ID

Body (JSON)

Field	Type	Rules
languages	array	Dil verileri; gönderilen diller upsert edilir; Max 20 dil
languages.*.lang_id	integer - required	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ; yalnızca aktif diller kabul edilir
languages.*.name	string	Kategori adı; Min 1 Max 255 karakter
languages.*.description	string	Kategori açıklaması; HTML içerik kabul edilir; Max 100000 karakter
languages.*.permalink	string	SEO URL; Max 255 karakter; adresi değiştirmeyecekseniz göndermeyin
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
parent_id	integer	Üst kategori ID
status	string	Durum; Values: active / inactive
order	integer	Sıralama; Min: 0 Max: 99999
filter_status	string	Filtre durumu; Values: active / inactive
installment	integer	Taksit sayısı; Values: 1–12 (aralık dışı değer 1'e düşer)
google_category	string	Google kategori ID; Max 100 karakter
image	string	Kategori görseli URL'i; yeni URL gelirse indirilip güncellenir; eski görsel commit sonrası silinir
opportunity_products	string	Fırsat ürün ID'leri; virgülle ayrılmış. Boş string göndererek temizlenebilir

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Category updated successfully.",
        "category_id": 2
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Erkek Giyim (Güncel)",
      "meta_title": "Erkek Giyim - Yeni Sezon"
    },
    {
      "lang_id": 2,
      "name": "Men's Clothing (Updated)",
      "meta_title": "Men's Clothing - New Season"
    }
  ],
  "status": "active",
  "order": 1,
  "filter_status": "active",
  "installment": 3,
  "opportunity_products": "42,57"
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/categories?id=2' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Erkek Giyim (Güncel)",
      "meta_title": "Erkek Giyim - Yeni Sezon"
    },
    {
      "lang_id": 2,
      "name": "Men'\''s Clothing (Updated)",
      "meta_title": "Men'\''s Clothing - New Season"
    }
  ],
  "status": "active",
  "order": 1,
  "filter_status": "active",
  "installment": 3,
  "opportunity_products": "42,57"
}'

DELETEKategori Sil

{{base_url}}/categories?id=2

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem; kategoriyi, tüm dil kayıtlarını, görselini, route (SEO URL) kayıtlarını ve kategori path verilerini kalıcı olarak siler. Geri alınamaz.

Birden fazla kategori aynı anda silinebilir. Tek seferde maksimum 50 ID.

Query Parameters

Field	Type	Description
id	string - required	Silinecek kategori ID'leri; virgülle ayrılmış. Örn: 1,2,3

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Category deleted successfully.",
        "deleted_ids": [2]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/categories?id=2' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Özelleştirmeler

5 uç nokta

Ürün özelleştirme gruplarına (yazı alanı, seçim listesi vb.) ait işlemler. Her grup; customizations (özelleştirme kalemleri) ve values (seçenekler) içerebilir.

GETÖzelleştirme Listesi

{{base_url}}/customizations

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Grup adında arama; Max 100 karakter
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)
sort	string	Sıralanacak Alan; Values: id / name / sort
order	string	Sıralama Yönü; Values: asc / desc
page	integer	Sayfa Numarası; Min: 1
limit	integer	Limit; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "name": "Yazı Ekle",
                "status": "active",
                "sort": 0
            },
            {
                "id": 2,
                "name": "Renk Seçimi",
                "status": "inactive",
                "sort": 1
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/customizations' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETÖzelleştirme Detayı

{{base_url}}/customizations/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Özelleştirme Grubu ID
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 1,
        "name": "Renk Seçimi",
        "status": "active",
        "sort": 0,
        "customizations": [
            {
                "customization_id": 3,
                "tip": 2,
                "title": "Renk Seçin",
                "placeholder": "Bir renk seçin",
                "desc": "Lütfen bir renk seçiniz",
                "type": 1,
                "min": 0,
                "max": 0,
                "sort": 0,
                "price_prefix": "+",
                "price": "0.00",
                "required": 1,
                "values": [
                    {
                        "value_id": 7,
                        "name": "Kırmızı",
                        "sort": 0,
                        "status": 1,
                        "price_prefix": "+",
                        "price": "5.00"
                    },
                    {
                        "value_id": 8,
                        "name": "Mavi",
                        "sort": 1,
                        "status": 1,
                        "price_prefix": "+",
                        "price": "0.00"
                    }
                ]
            }
        ]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/customizations/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTÖzelleştirme Ekle

{{base_url}}/customizations

Bearer token gerekirContent-Type: application/json

languages alanı zorunludur; tüm aktif diller için gönderilmesi gerekir.

customizations dizisi düz (flat) yapıdadır. Her öğe bir dile ait bir özelleştirme kalemini temsil eder. Aynı özelleştirme kaleminin tüm dil girişleri arka arkaya sıralanmalı ve her dilden bir öğe geçildikten sonra sıradaki kalemin girişleri başlamalıdır (lang_id döngüsü tekrar ettiğinde yeni kalem başlar).

values dizisi de düz yapıdadır; her öğe bir dile ait bir seçenek kalemini temsil eder. Seçenekler pozisyona göre eşleştirilir: tüm dil girişlerindeki values[0] aynı seçenek, values[1] diğer seçenektir.

tip değerine göre type kısıtı: tip 1/2/3 → type ∈ [1,2] | tip 4/5 → type ∈ [1,2,3]

tip değerine göre values kısıtı: tip 1/4/5 → values gönderilemez | tip 2/3 → values gönderilebilir

Body (JSON)

Field	Type	Rules
languages	array - required	Grup adları; tüm aktif diller için gönderilmeli (allActiveLangs)
languages.*.lang_id	integer - required	Dil ID
languages.*.name	string - required	Grup adı; Max 255 karakter
status	string	Durum; Values: active / inactive (varsayılan: inactive)
sort	integer	Sıralama; Min: 0 (varsayılan: 0)
customizations	array	Özelleştirme kalemleri (düz dizi — bir öğe = bir dil)
customizations.*.lang_id	integer	Dil ID
customizations.*.tip	integer	Alan tipi; Values: 1=Metin / 2=Tekli Seçim / 3=Çoklu Seçim / 4=Tarih / 5=Dosya
customizations.*.title	string - required	Kalem başlığı; Max 255 karakter
customizations.*.placeholder	string	Placeholder metni; Max 255 karakter
customizations.*.desc	string	Açıklama; Max 500 karakter
customizations.*.type	integer	İçerik tipi; tip 1/2/3 → [1,2] / tip 4/5 → [1,2,3]
customizations.*.min	integer	Min değer; Min: 0
customizations.*.max	integer	Max değer; Min: 0
customizations.*.sort	integer	Sıralama; Min: 0
customizations.*.price_prefix	string	Fiyat operatörü; Values: + / -
customizations.*.price	numeric	Fiyat farkı
customizations.*.required	integer	Zorunlu alan; Values: 0 / 1
customizations.*.values	array	Seçenekler; yalnızca tip 2/3 için (düz dizi — bir öğe = bir dil)
customizations..values..lang_id	integer	Dil ID
customizations..values..name	string	Seçenek adı; Max 255 karakter
customizations..values..sort	integer	Sıralama; Min: 0
customizations..values..status	integer	Durum; Values: 0 / 1
customizations..values..price_prefix	string	Fiyat operatörü; Values: + / -
customizations..values..price	numeric	Fiyat farkı
customizations..values..image	string	Seçenek görseli; geçerli URL — `uploads/customizations/` dizinine indirilir

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Customization group created successfully.",
        "customization_group_id": 3
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "status": "active",
  "sort": 0,
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk Seçimi"
    },
    {
      "lang_id": 2,
      "name": "Color Selection"
    },
    {
      "lang_id": 3,
      "name": "اختيار اللون"
    },
    {
      "lang_id": 4,
      "name": "Farbauswahl"
    },
    {
      "lang_id": 5,
      "name": "Sélection de couleur"
    },
    {
      "lang_id": 6,
      "name": "Выбор цвета"
    },
    {
      "lang_id": 7,
      "name": "Rəng seçimi"
    }
  ],
  "customizations": [
    {
      "lang_id": 1,
      "tip": 2,
      "title": "Renk Seçin",
      "placeholder": "Bir renk seçin",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 1,
          "name": "Kırmızı",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 1,
          "name": "Mavi",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 2,
      "tip": 2,
      "title": "Choose Color",
      "placeholder": "Select a color",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 2,
          "name": "Red",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 2,
          "name": "Blue",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 3,
      "tip": 2,
      "title": "اختر اللون",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 3,
          "name": "أحمر",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 3,
          "name": "أزرق",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 4,
      "tip": 2,
      "title": "Farbe wählen",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 4,
          "name": "Rot",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 4,
          "name": "Blau",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 5,
      "tip": 2,
      "title": "Choisir la couleur",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 5,
          "name": "Rouge",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 5,
          "name": "Bleu",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 6,
      "tip": 2,
      "title": "Выбрать цвет",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 6,
          "name": "Красный",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 6,
          "name": "Синий",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 7,
      "tip": 2,
      "title": "Rəng seçin",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 7,
          "name": "Qırmızı",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 7,
          "name": "Mavi",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/customizations' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "status": "active",
  "sort": 0,
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk Seçimi"
    },
    {
      "lang_id": 2,
      "name": "Color Selection"
    },
    {
      "lang_id": 3,
      "name": "اختيار اللون"
    },
    {
      "lang_id": 4,
      "name": "Farbauswahl"
    },
    {
      "lang_id": 5,
      "name": "Sélection de couleur"
    },
    {
      "lang_id": 6,
      "name": "Выбор цвета"
    },
    {
      "lang_id": 7,
      "name": "Rəng seçimi"
    }
  ],
  "customizations": [
    {
      "lang_id": 1,
      "tip": 2,
      "title": "Renk Seçin",
      "placeholder": "Bir renk seçin",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 1,
          "name": "Kırmızı",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 1,
          "name": "Mavi",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 2,
      "tip": 2,
      "title": "Choose Color",
      "placeholder": "Select a color",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 2,
          "name": "Red",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 2,
          "name": "Blue",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 3,
      "tip": 2,
      "title": "اختر اللون",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 3,
          "name": "أحمر",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 3,
          "name": "أزرق",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 4,
      "tip": 2,
      "title": "Farbe wählen",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 4,
          "name": "Rot",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 4,
          "name": "Blau",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 5,
      "tip": 2,
      "title": "Choisir la couleur",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 5,
          "name": "Rouge",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 5,
          "name": "Bleu",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 6,
      "tip": 2,
      "title": "Выбрать цвет",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 6,
          "name": "Красный",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 6,
          "name": "Синий",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    },
    {
      "lang_id": 7,
      "tip": 2,
      "title": "Rəng seçin",
      "placeholder": "",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "lang_id": 7,
          "name": "Qırmızı",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 7,
          "name": "Mavi",
          "sort": 1,
          "status": 1,
          "price_prefix": "+",
          "price": "0.00"
        }
      ]
    }
  ]
}'

PATCHÖzelleştirme Düzenle

{{base_url}}/customizations?id=1

Bearer token gerekirContent-Type: application/json

id query parametresi zorunludur.

Yalnızca değiştirmek istediğiniz alanları gönderin; customizations ve languages dizilerini göndermek zorunda değilsiniz.

Mevcut bir kalemi ya da seçeneği güncellerken o kalemin/seçeneğin tüm alanlarını gönderin; gönderilmeyen alanlar varsayılan değerine döner. Seçenekler (values) yalnız kalem girişinde tip 2 ya da 3 gönderildiğinde işlenir.

customizations dizisi düz (flat) yapıdadır. Aynı customization_id değerine sahip girişler aynı kalemi günceller; customization_id olmayan girişler yeni kalem olarak eklenir. Yeni kalemlerde lang_id döngüsü kuralı geçerlidir.

customizations: [] (boş dizi) gönderilirse gruba ait tüm özelleştirme kalemleri silinir.

values: [] (boş dizi) gönderilirse o kaleme ait tüm seçenekler silinir.

value_id varsa mevcut seçenek güncellenir; yoksa yeni seçenek eklenir. Seçenek silmek için values: [] kullanın.

tip değerine göre type kısıtı: tip 1/2/3 → type ∈ [1,2] | tip 4/5 → type ∈ [1,2,3]

tip değerine göre values kısıtı: tip 1/4/5 → values gönderilemez | tip 2/3 → values gönderilebilir

Query Parameters

Field	Type	Description
id	integer - required	Özelleştirme Grubu ID

Body (JSON)

Field	Type	Rules
languages	array	Grup adları; gönderilen diller upsert edilir
languages.*.lang_id	integer	Dil ID
languages.*.name	string	Grup adı; Max 255 karakter
status	string	Durum; Values: active / inactive
sort	integer	Sıralama; Min: 0
customizations	array	Özelleştirme kalemleri (düz dizi); boş dizi → tümünü sil
customizations.*.customization_id	integer	Mevcut kalem ID; varsa günceller, yoksa yeni ekler
customizations.*.lang_id	integer	Dil ID
customizations.*.tip	integer	Alan tipi; Values: 1 / 2 / 3 / 4 / 5
customizations.*.title	string - required	Başlık; her kalem girişinde zorunlu; Max 255 karakter
customizations.*.placeholder	string	Placeholder; Max 255 karakter
customizations.*.desc	string	Açıklama; Max 500 karakter
customizations.*.type	integer	İçerik tipi; tip 1/2/3 → [1,2] / tip 4/5 → [1,2,3]
customizations.*.min	integer	Min değer; Min: 0
customizations.*.max	integer	Max değer; Min: 0
customizations.*.sort	integer	Sıralama; Min: 0
customizations.*.price_prefix	string	Values: + / -
customizations.*.price	numeric	Fiyat farkı
customizations.*.required	integer	Values: 0 / 1
customizations.*.values	array	Seçenekler; boş dizi → bu kaleme ait tümünü sil
customizations..values..value_id	integer	Mevcut seçenek ID; varsa günceller, yoksa yeni ekler
customizations..values..lang_id	integer	Dil ID
customizations..values..name	string	Seçenek adı; Max 255 karakter
customizations..values..sort	integer	Sıralama; Min: 0
customizations..values..status	integer	Values: 0 / 1
customizations..values..price_prefix	string	Values: + / -
customizations..values..price	numeric	Fiyat farkı
customizations..values..image	string	Görsel URL; `uploads/customizations/` dizinine indirilir

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Customization group updated successfully.",
        "customization_group_id": 1
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "status": "active",
  "sort": 1,
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk Seçimi (Güncellendi)"
    },
    {
      "lang_id": 2,
      "name": "Color Selection (Updated)"
    }
  ],
  "customizations": [
    {
      "customization_id": 3,
      "lang_id": 1,
      "tip": 2,
      "title": "Renk Seçin",
      "placeholder": "Bir renk seçin",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "value_id": 7,
          "lang_id": 1,
          "name": "Kırmızı (Güncellendi)",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 1,
          "name": "Sarı",
          "sort": 2,
          "status": 1,
          "price_prefix": "+",
          "price": "3.00"
        }
      ]
    },
    {
      "customization_id": 3,
      "lang_id": 2,
      "tip": 2,
      "title": "Choose Color (Updated)",
      "placeholder": "Select a color",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "value_id": 7,
          "lang_id": 2,
          "name": "Red (Updated)",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 2,
          "name": "Yellow",
          "sort": 2,
          "status": 1,
          "price_prefix": "+",
          "price": "3.00"
        }
      ]
    },
    {
      "lang_id": 1,
      "tip": 1,
      "title": "Kişiye Özel Not",
      "placeholder": "Notunuzu girin",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 100,
      "sort": 1,
      "price_prefix": "+",
      "price": "0.00",
      "required": 0
    },
    {
      "lang_id": 2,
      "tip": 1,
      "title": "Custom Note",
      "placeholder": "Enter your note",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 100,
      "sort": 1,
      "price_prefix": "+",
      "price": "0.00",
      "required": 0
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/customizations?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "status": "active",
  "sort": 1,
  "languages": [
    {
      "lang_id": 1,
      "name": "Renk Seçimi (Güncellendi)"
    },
    {
      "lang_id": 2,
      "name": "Color Selection (Updated)"
    }
  ],
  "customizations": [
    {
      "customization_id": 3,
      "lang_id": 1,
      "tip": 2,
      "title": "Renk Seçin",
      "placeholder": "Bir renk seçin",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "value_id": 7,
          "lang_id": 1,
          "name": "Kırmızı (Güncellendi)",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 1,
          "name": "Sarı",
          "sort": 2,
          "status": 1,
          "price_prefix": "+",
          "price": "3.00"
        }
      ]
    },
    {
      "customization_id": 3,
      "lang_id": 2,
      "tip": 2,
      "title": "Choose Color (Updated)",
      "placeholder": "Select a color",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 0,
      "sort": 0,
      "price_prefix": "+",
      "price": "0.00",
      "required": 1,
      "values": [
        {
          "value_id": 7,
          "lang_id": 2,
          "name": "Red (Updated)",
          "sort": 0,
          "status": 1,
          "price_prefix": "+",
          "price": "5.00"
        },
        {
          "lang_id": 2,
          "name": "Yellow",
          "sort": 2,
          "status": 1,
          "price_prefix": "+",
          "price": "3.00"
        }
      ]
    },
    {
      "lang_id": 1,
      "tip": 1,
      "title": "Kişiye Özel Not",
      "placeholder": "Notunuzu girin",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 100,
      "sort": 1,
      "price_prefix": "+",
      "price": "0.00",
      "required": 0
    },
    {
      "lang_id": 2,
      "tip": 1,
      "title": "Custom Note",
      "placeholder": "Enter your note",
      "desc": "",
      "type": 1,
      "min": 0,
      "max": 100,
      "sort": 1,
      "price_prefix": "+",
      "price": "0.00",
      "required": 0
    }
  ]
}'

DELETEÖzelleştirme Sil

{{base_url}}/customizations?ids=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem; grubu, tüm özelleştirme kalemlerini, tüm seçeneklerini ve dil kayıtlarını kalıcı olarak siler. Geri alınamaz.

Birden fazla grup aynı anda silinebilir.

Query Parameters

Field	Type	Description
ids	string - required	Silinecek grup ID'leri; virgülle ayrılmış. Örn: 1,2,3

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Customization groups deleted successfully.",
        "deleted_ids": [1, 2],
        "not_found_ids": [],
        "count": 2
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/customizations?ids=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Bloglar

5 uç nokta

Blog yazılarını listeleme, detay görüntüleme, oluşturma, güncelleme ve silme işlemleri. Her blog birden fazla dil kaydı ve kategori ilişkisi taşıyabilir; SEO URL'leri ny_routes tablosuna otomatik yazılır.

GETBlog Listesi

{{base_url}}/blogs

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Blog adında arama; trim uygulanır; Max 200 karakter
status	string	Durum filtresi; Values: active / inactive
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)
sort	string	Sıralanacak alan; Values: id / name / order / date (varsayılan: id)
order	string	Sıralama yönü; Values: asc / desc (varsayılan: desc)
page	integer	Sayfa numarası; Min: 1
limit	integer	Sayfa limiti; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "status": "active",
                "image": "https://example.com/uploads/blog/kahve-rehberi.jpg",
                "order": 0,
                "lang_id": 1,
                "name": "Kahve Rehberi",
                "url": "https://example.com/kahve-rehberi",
                "created_at": 1676061703,
                "updated_at": 1763548866,
                "created_at_local": "10.02.2023 23:41:43",
                "updated_at_local": "19.07.2025 10:41:06"
            },
            {
                "id": 2,
                "status": "inactive",
                "image": "",
                "order": 1,
                "lang_id": 1,
                "name": "Espresso Teknikleri",
                "url": "https://example.com/espresso-teknikleri",
                "created_at": 1676061726,
                "updated_at": null,
                "created_at_local": "10.02.2023 23:42:06",
                "updated_at_local": null
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 2
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/blogs' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETBlog Detayı

{{base_url}}/blogs/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Blog ID
lang_id	integer	Dil ID; 1=TR 2=EN 3=AR 4=DE 5=FR 6=RU 7=AZ (varsayılan: 1)

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 1,
        "status": "active",
        "order": 0,
        "image": "https://example.com/uploads/blog/kahve-rehberi.jpg",
        "view_count": 142,
        "lang_id": 1,
        "name": "Kahve Rehberi",
        "description": "<p>Kahve dünyasına kapsamlı bir giriş...</p>",
        "permalink": "kahve-rehberi",
        "url": "https://example.com/kahve-rehberi",
        "meta_title": "Kahve Rehberi | Blog",
        "meta_description": "Kahve çeşitleri ve demleme teknikleri hakkında kapsamlı rehber.",
        "meta_keywords": "kahve, espresso, filtre kahve",
        "created_at": 1676061703,
        "updated_at": 1763548866,
        "created_at_local": "10.02.2023 23:41:43",
        "updated_at_local": "19.07.2025 10:41:06",
        "categories": [
            {
                "id": 3,
                "order": 0,
                "name": "İçecekler"
            }
        ]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/blogs/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTBlog Ekle

{{base_url}}/blogs

Bearer token gerekirContent-Type: application/json

languages alanı zorunludur; tüm aktif diller için gönderilmelidir.

permalink boş bırakılırsa name alanından otomatik üretilir. Aynı adres kullanılıyorsa sonuna otomatik ek konur (örn. kahve-rehberi-1).

image geçerli bir URL olmalıdır; uploads/blog/ dizinine indirilir.

status alanı gönderilmezse active olarak varsayılır.

Body (JSON)

Field	Type	Rules
languages	array - required	Dil kayıtları; tüm aktif diller için gönderilmeli (allActiveLangs)
languages.*.lang_id	integer - required	Dil ID
languages.*.name	string - required	Blog başlığı; Min 1 Max 255 karakter
languages.*.permalink	string	SEO URL; boş bırakılırsa name'den üretilir; Max 255 karakter
languages.*.description	string	Blog içeriği (HTML kabul edilir); Max 100000 karakter
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
status	string	Durum; Values: active / inactive (varsayılan: active)
order	integer	Sıralama; Min 0 Max 99999
image	string	Görsel URL; `uploads/blog/` dizinine indirilir
categories	array	Kategori ilişkileri; Max 50
categories.*.id	integer	Blog kategori ID
categories.*.order	integer	Kategorideki sıralama; Min 0 Max 99999

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Blog created successfully.",
        "blog_id": 5
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "status": "active",
  "order": 0,
  "image": "https://cdn.example.com/images/kahve-rehberi.jpg",
  "languages": [
    {
      "lang_id": 1,
      "name": "Kahve Rehberi",
      "permalink": "kahve-rehberi",
      "description": "<p>Kahve dünyasına giriş...</p>",
      "meta_title": "Kahve Rehberi",
      "meta_description": "Kahve rehberi açıklaması",
      "meta_keywords": "kahve"
    },
    {
      "lang_id": 2,
      "name": "Coffee Guide",
      "permalink": "coffee-guide",
      "description": "<p>Introduction to coffee...</p>",
      "meta_title": "Coffee Guide",
      "meta_description": "Coffee guide description",
      "meta_keywords": "coffee"
    },
    {
      "lang_id": 3,
      "name": "دليل القهوة",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 4,
      "name": "Kaffee-Leitfaden",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 5,
      "name": "Guide du café",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 6,
      "name": "Путеводитель по кофе",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 7,
      "name": "Qəhvə bələdçisi",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "categories": [
    {
      "id": 3,
      "order": 0
    }
  ]
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/blogs' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "status": "active",
  "order": 0,
  "image": "https://cdn.example.com/images/kahve-rehberi.jpg",
  "languages": [
    {
      "lang_id": 1,
      "name": "Kahve Rehberi",
      "permalink": "kahve-rehberi",
      "description": "<p>Kahve dünyasına giriş...</p>",
      "meta_title": "Kahve Rehberi",
      "meta_description": "Kahve rehberi açıklaması",
      "meta_keywords": "kahve"
    },
    {
      "lang_id": 2,
      "name": "Coffee Guide",
      "permalink": "coffee-guide",
      "description": "<p>Introduction to coffee...</p>",
      "meta_title": "Coffee Guide",
      "meta_description": "Coffee guide description",
      "meta_keywords": "coffee"
    },
    {
      "lang_id": 3,
      "name": "دليل القهوة",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 4,
      "name": "Kaffee-Leitfaden",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 5,
      "name": "Guide du café",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 6,
      "name": "Путеводитель по кофе",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 7,
      "name": "Qəhvə bələdçisi",
      "permalink": "",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "categories": [
    {
      "id": 3,
      "order": 0
    }
  ]
}'

PATCHBlog Düzenle

{{base_url}}/blogs?id=1

Bearer token gerekirContent-Type: application/json

id query parametresi zorunludur.

Yalnızca değiştirmek istediğiniz alanları gönderin.

languages: mevcut dil kaydı varsa güncellenir; yoksa yeni eklenir. Permalink değiştirilirse eski SEO route silinerek yenisi eklenir.

categories: tam değiştirme (full replace) — gönderilen liste, blogun tüm kategori ilişkilerinin yerini alır. Boş dizi göndermek mevcut tüm kategori ilişkilerini siler.

image geçerli bir URL olmalıdır; uploads/blog/ dizinine indirilir.

Query Parameters

Field	Type	Description
id	integer - required	Blog ID

Body (JSON)

Field	Type	Rules
languages	array	Dil kayıtları; gönderilen diller upsert edilir; Max 20 giriş
languages.*.lang_id	integer	Dil ID
languages.*.name	string	Blog başlığı; Min 1 Max 255 karakter
languages.*.permalink	string	SEO URL; değiştirilirse eski adres kaldırılır; adresi değiştirmeyecekseniz göndermeyin; Max 255 karakter
languages.*.description	string	Blog içeriği (HTML kabul edilir); Max 100000 karakter
languages.*.meta_title	string	Meta başlık; Max 255 karakter
languages.*.meta_description	string	Meta açıklama; Max 500 karakter
languages.*.meta_keywords	string	Meta anahtar kelimeler; Max 500 karakter
status	string	Durum; Values: active / inactive
order	integer	Sıralama; Min 0 Max 99999
image	string	Görsel URL; `uploads/blog/` dizinine indirilir
categories	array	Kategori ilişkileri (tam değiştirme); Max 50
categories.*.id	integer	Blog kategori ID
categories.*.order	integer	Kategorideki sıralama; Min 0 Max 99999

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Blog updated successfully.",
        "blog_id": 1
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "status": "active",
  "order": 1,
  "image": "https://cdn.example.com/images/kahve-rehberi-v2.jpg",
  "languages": [
    {
      "lang_id": 1,
      "name": "Kahve Rehberi (Güncellendi)",
      "permalink": "kahve-rehberi-v2",
      "description": "<p>Güncel kahve rehberi...</p>",
      "meta_title": "Kahve Rehberi",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 2,
      "name": "Coffee Guide (Updated)",
      "permalink": "coffee-guide-v2",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "categories": [
    {
      "id": 3,
      "order": 0
    },
    {
      "id": 5,
      "order": 1
    }
  ]
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/blogs?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "status": "active",
  "order": 1,
  "image": "https://cdn.example.com/images/kahve-rehberi-v2.jpg",
  "languages": [
    {
      "lang_id": 1,
      "name": "Kahve Rehberi (Güncellendi)",
      "permalink": "kahve-rehberi-v2",
      "description": "<p>Güncel kahve rehberi...</p>",
      "meta_title": "Kahve Rehberi",
      "meta_description": "",
      "meta_keywords": ""
    },
    {
      "lang_id": 2,
      "name": "Coffee Guide (Updated)",
      "permalink": "coffee-guide-v2",
      "description": "",
      "meta_title": "",
      "meta_description": "",
      "meta_keywords": ""
    }
  ],
  "categories": [
    {
      "id": 3,
      "order": 0
    },
    {
      "id": 5,
      "order": 1
    }
  ]
}'

DELETEBlog Sil

{{base_url}}/blogs?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Bu işlem blogu ve tüm dil kayıtlarını kalıcı olarak siler. Geri alınamaz.

Birden fazla blog aynı anda silinebilir.

Query Parameters

Field	Type	Description
id	string - required	Silinecek blog ID'leri; virgülle ayrılmış. Örn: 1,2,3

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Blog deleted successfully.",
        "deleted_ids": [1, 2]
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/blogs?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Siparişler

4 uç nokta

Sipariş listeleme, detay görüntüleme, durum/ödeme/not güncelleme ve durum geçmişi / kargo hareketi ekleme işlemleri. Silme işlemi desteklenmez.

GETSiparişler Listesi

{{base_url}}/orders

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Sipariş durumu değerleri

Değer	Açıklama
pending_approval	Onay Bekliyor
preparing	Hazırlanıyor
shipped	Kargolandı
completed	Tamamlandı
on_hold	Beklemede
cancelled	İptal Edildi
sent_to_entegra	Entegraya Düştü
returned	İade Edildi

Ödeme durumu değerleri

Değer	Açıklama
pending_approval	Onay Bekliyor
approved	Onaylandı
cancelled	İptal Edildi

Query Parameters

Field	Type	Description
customer_id	string	Müşteri ID; virgülle birden fazla gönderilebilir
customer_code	string	Müşteri/Cari kodu
email	string	E-posta adresi
phone	string	Telefon numarası
order_no	string	Sipariş numarası; virgülle birden fazla gönderilebilir
full_name	string	Ad soyad (LIKE araması)
start_date	string	Tarih aralığı başlangıç; Format: YYYY-MM-DD veya YYYY-MM-DDTHH:MM:SSZ
end_date	string	Tarih aralığı bitiş; Format: YYYY-MM-DD veya YYYY-MM-DDTHH:MM:SSZ
order_status	string	Sipariş durumu; Values: pending_approval / preparing / shipped / completed / on_hold / cancelled / sent_to_entegra / returned
payment_status	string	Ödeme durumu; Values: pending_approval / approved / cancelled
device	string	Cihaz türü; Values: desktop / mobile_app
company	string	Firma unvanı (LIKE araması)
invoice_type	string	Fatura tipi; Values: individual / institutional
customer_type	string	Müşteri tipi; Values: subscribed_customers / dealers
dealers	string	Bayi grubu ID; virgülle birden fazla gönderilebilir
min_order_amount	decimal	Min sipariş tutarı
max_order_amount	decimal	Max sipariş tutarı
sort	string	Sıralanacak alan; Values: id / order_date / full_name / amount (varsayılan: id)
order	string	Sıralama yönü; Values: asc / desc (varsayılan: desc)
page	integer	Sayfa numarası; Min: 1
limit	integer	Sayfa limiti; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "order_id": 414,
                "customer_id": 38,
                "order_no": "3292609",
                "order_status": "pending_approval",
                "payment_type": "Havale/EFT",
                "bank_definition": "5",
                "payment_status": "pending_approval",
                "name": "Ahmet",
                "surname": "Yılmaz",
                "email": "[email protected]",
                "phone": "+905001234567",
                "shipping": {
                    "cargo": "Borusan Lojistik",
                    "country": "Türkiye",
                    "city": "İstanbul",
                    "district": "Bahçelievler",
                    "address": "Şirinevler Mah.",
                    "delivery_type": "address",
                    "pickup_point": "",
                    "pickup_code": ""
                },
                "invoice": {
                    "type": "individual",
                    "name": "Ahmet Yılmaz",
                    "country": "Türkiye",
                    "city": "İstanbul",
                    "district": "Bahçelievler",
                    "adres": "Şirinevler Mah.",
                    "phone": "+905001234567",
                    "company": "",
                    "tax_number": "",
                    "tax_office": "",
                    "invoice_url": ""
                },
                "total_amount": 4161.805,
                "cargo_price": 70.0,
                "extra_pay": [],
                "discounts": [],
                "card_type": "-",
                "currency": "TL",
                "exchange_rate": 1.0,
                "pos_info": {
                    "bank_name": "",
                    "card_family": "-",
                    "card_installment": ""
                },
                "customer_note": "",
                "admin_note": "",
                "pos_result": "",
                "user_device": "Bilgisayar",
                "mobile_device": "",
                "ads_campaign": "",
                "error_message": "",
                "created_at": "1765974430",
                "created_at_local": "17.06.2025 15:27:10"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 5,
            "totalRecords": 79
        }
    }
}

shipping.delivery_type: address (adrese teslim) / pickup_point (Gel Al noktasından teslim). Gel al siparişinde shipping.pickup_point noktanın adını, shipping.pickup_code müşterinin teslimde göstereceği kodu taşır; diğer siparişlerde ikisi boş döner.
extra_pay: ödeme türüne bağlı ek ücret (ör. kapıda ödeme bedeli) varsa {"title", "price"} nesnesi, yoksa boş dizi [].

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/orders' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETSipariş Detayı

{{base_url}}/orders/detail?order_id=414

Bearer token gerekirContent-Type: application/jsonAccept: application/json

order_id veya order_no parametrelerinden biri zorunludur.

Detay yanıtı; liste yanıtına ek olarak products[], history[], cargo_history[] ve contracts{} alanlarını içerir.

Query Parameters

Field	Type	Description
order_id	integer	Sipariş ID; `order_id` veya `order_no`'dan biri zorunlu
order_no	string	Sipariş numarası; `order_id` veya `order_no`'dan biri zorunlu

Response (200 OK)

{
    "status": true,
    "data": {
        "order_id": 414,
        "customer_id": 38,
        "order_no": "3292609",
        "order_status": "pending_approval",
        "payment_type": "Havale/EFT",
        "bank_definition": "5",
        "payment_status": "pending_approval",
        "name": "Ahmet",
        "surname": "Yılmaz",
        "email": "[email protected]",
        "phone": "+905001234567",
        "shipping": {
            "cargo": "Borusan Lojistik",
            "country": "Türkiye",
            "city": "İstanbul",
            "district": "Bahçelievler",
            "address": "Şirinevler Mah.",
            "delivery_type": "address",
            "pickup_point": "",
            "pickup_code": ""
        },
        "invoice": {
            "type": "individual",
            "name": "Ahmet Yılmaz",
            "country": "Türkiye",
            "city": "İstanbul",
            "district": "Bahçelievler",
            "adres": "Şirinevler Mah.",
            "phone": "+905001234567",
            "tc": "11111111111",
            "company": "",
            "tax_number": "",
            "tax_office": "",
            "invoice_url": ""
        },
        "total_amount": 4161.805,
        "cargo_price": 70.0,
        "extra_pay": {
            "title": "Kapıda Ödeme Bedeli",
            "price": 15
        },
        "discounts": [
            { "title": "Kupon: YAZ25", "value": 50.0 }
        ],
        "card_type": "-",
        "currency": "TL",
        "exchange_rate": 1.0,
        "pos_info": {
            "bank_name": "",
            "card_family": "-",
            "card_installment": ""
        },
        "customer_note": "Kapıda zil çalınmasın.",
        "admin_note": "",
        "pos_result": "",
        "user_device": "Bilgisayar",
        "mobile_device": "",
        "ads_campaign": "",
        "error_message": "",
        "contracts": {
            "mesafeli_satis": "https://example.com/uploads/contracts/sozlesme.pdf",
            "iptal_iade": "",
            "kvkk": "",
            "on_bilgilendirme": ""
        },
        "created_at": 1765974430,
        "created_at_local": "17.06.2025 15:27:10",
        "products": [
            {
                "product_id": 12,
                "name": "Kahve Çekirdeği 250g",
                "image": "https://example.com/uploads/urunler/kahve.jpg",
                "qty": 2,
                "sub_total": 150.0,
                "total": 300.0,
                "product_code": "KHV-250",
                "product_barcode": "8690000000001",
                "tax": 10,
                "options": [
                    { "name": "Öğütme", "value": "Espresso" }
                ],
                "customizations": [
                    { "name": "Kişiye Özel Mesaj", "value": "İyi ki doğdun!" }
                ]
            }
        ],
        "history": [
            {
                "action_type_label": "Hazırlanıyor",
                "action_text": "Sipariş hazırlanmaya başlandı.",
                "created_at": 1765974800,
                "created_at_local": "17.06.2025 15:33:20"
            }
        ],
        "cargo_history": [
            {
                "cargo_company": "Borusan Lojistik",
                "cargo_takipno": "1234567890",
                "created_at": 1765975200,
                "created_at_local": "17.06.2025 15:40:00"
            }
        ]
    }
}

shipping.delivery_type: address (adrese teslim) / pickup_point (Gel Al noktasından teslim). Gel al siparişinde shipping.pickup_point noktanın adını, shipping.pickup_code müşterinin teslimde göstereceği kodu taşır; diğer siparişlerde ikisi boş döner.
extra_pay: ödeme türüne bağlı ek ücret (ör. kapıda ödeme bedeli) varsa {"title", "price"} nesnesi, yoksa boş dizi [].

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/orders/detail?order_id=414' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

PATCHSipariş Güncelle

{{base_url}}/orders?order_id=414

Bearer token gerekirContent-Type: application/json

order_id veya order_no parametrelerinden biri zorunludur.

Yalnızca değiştirmek istediğiniz alanları gönderin.

Otomatik durum geçişi: payment_status: approved gönderildiğinde sipariş hâlâ pending_approval durumundaysa, sipariş durumu otomatik olarak preparing yapılır.

Bu endpoint yalnızca durum, ödeme durumu ve admin notunu günceller. Durum ya da ödeme durumu değiştiğinde sipariş geçmişine otomatik kayıt düşer; sipariş durumu değişikliğinde müşteriye mobil bildirim gider. Kendi açıklamanızla kayıt eklemek ya da SMS / e-posta göndermek için POST /orders/actions kullanın.

Query Parameters

Field	Type	Description
order_id	integer	Sipariş ID; `order_id` veya `order_no`'dan biri zorunlu
order_no	string	Sipariş numarası; `order_id` veya `order_no`'dan biri zorunlu

Body (JSON)

Field	Type	Rules
order_status	string	Sipariş durumu; Values: pending_approval / preparing / shipped / completed / on_hold / cancelled / sent_to_entegra / returned
payment_status	string	Ödeme durumu; Values: pending_approval / approved / cancelled
admin_note	string	Admin notu

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Order updated successfully.",
        "order_id": 414
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "order_status": "preparing",
  "payment_status": "approved",
  "admin_note": "Müşteri arandı, onay alındı."
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/orders?order_id=414' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "order_status": "preparing",
  "payment_status": "approved",
  "admin_note": "Müşteri arandı, onay alındı."
}'

POSTSipariş Aksiyonu

{{base_url}}/orders/actions?order_id=414

Bearer token gerekirContent-Type: application/json

order_id veya order_no parametrelerinden biri zorunludur.

history ve cargo alanlarından en az biri zorunludur; ikisi de aynı istekte gönderilebilir.

Idempotency-Key (önerilir): İsteğe Idempotency-Key başlığı eklenebilir (16–128 karakter; harf, rakam, -, _). Aynı anahtarla aynı sipariş için 24 saat içinde gelen tekrar istek yeniden işlenmez; ilk başarılı yanıt "idempotent": true alanıyla döner, geçmiş kaydı ve bildirimler tekrarlanmaz.

history: ny_order_action tablosuna kayıt ekler, or_durum günceller ve otomasyon motoru tetiklenir. Bildirim gönderilmesi için notifications dizisine sms, mail ve/veya push eklenebilir.

cargo: ny_order_cargo tablosuna kargo takip kaydı ekler, sipariş durumunu otomatik olarak shipped (3) yapar ve otomasyon motoru tetiklenir.

action_type değerleri

Değer	Açıklama
1	Onay Bekliyor
2	Hazırlanıyor
3	Kargolandı
4	Tamamlandı
5	Beklemede
6	İptal Edildi
7	Entegraya Düştü
8	İade

Query Parameters

Field	Type	Description
order_id	integer	Sipariş ID; `order_id` veya `order_no`'dan biri zorunlu
order_no	string	Sipariş numarası; `order_id` veya `order_no`'dan biri zorunlu

Body (JSON)

Field	Type	Rules
history	object	Durum geçmişi kaydı; `history` veya `cargo`'dan en az biri zorunlu
history.action_type	integer - required	Aksiyon tipi; Values: 1–8
history.action_text	string	Aksiyon açıklaması
history.notifications	array	Bildirim kanalları; Values: sms / mail / push
cargo	object	Kargo hareketi kaydı; sipariş durumunu otomatik `shipped` yapar
cargo.company_id	integer - required	Kargo firma ID
cargo.tracking_no	string - required	Kargo takip numarası
cargo.notifications	array	Bildirim kanalları; Values: sms / mail / push

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Actions processed successfully.",
        "order_id": 414
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "history": {
    "action_type": 3,
    "action_text": "Sipariş kargoya verildi.",
    "notifications": [
      "sms",
      "mail"
    ]
  },
  "cargo": {
    "company_id": 4,
    "tracking_no": "1234567890",
    "notifications": [
      "sms",
      "mail"
    ]
  }
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/orders/actions?order_id=414' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "history": {
    "action_type": 3,
    "action_text": "Sipariş kargoya verildi.",
    "notifications": [
      "sms",
      "mail"
    ]
  },
  "cargo": {
    "company_id": 4,
    "tracking_no": "1234567890",
    "notifications": [
      "sms",
      "mail"
    ]
  }
}'

İadeler

7 uç nokta

Müşteri iade taleplerini listeleyin, detaylarını görüntüleyin ve ürün bazlı onay/ret işlemi yapın. İade nedenlerini yönetin.

GETİade Listesi

{{base_url}}/returns?user_id=&order_no=&start_date=&end_date=&lang_id=1&sort=id&order=desc&page=1&limit=50

Bearer token gerekir

İade taleplerini sayfalı olarak listeler. Her kayıt o iadedeki ürün sayısı ve onay/red durumunu özet olarak içerir.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`user_id`	—	Müşteri ID'sine göre filtrele
`order_no`	—	Sipariş numarasına göre filtrele (LIKE arama)
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD)
`end_date`	—	Bitiş tarihi (YYYY-MM-DD)
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)
`sort`	`id`	Sıralama alanı: id \| date
`order`	`desc`	Sıralama yönü: asc \| desc
`page`	`1`	Sayfa numarası (varsayılan: 1)
`limit`	`50`	Sayfa başına kayıt (1–500, varsayılan: 50)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/returns?user_id=&order_no=&start_date=&end_date=&lang_id=1&sort=id&order=desc&page=1&limit=50' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "total": 24,
    "page": 1,
    "limit": 50,
    "items": [
      {
        "iade_id": 12,
        "order_id": 305,
        "user_id": 88,
        "return_id": 3,
        "order_no": "SP-2026-0305",
        "customer_name": "Ahmet Yılmaz",
        "return_explanation": "Ürün hasarlı geldi.",
        "return_name": "Hasarlı Ürün",
        "total": 2,
        "approved": 1,
        "cancelled": 0,
        "created_at": 1747296000,
        "created_at_local": "15.05.2026 - 10:00"
      }
    ]
  }
}

GETİade Detayı

{{base_url}}/returns/detail?id=12&lang_id=1

Bearer token gerekir

Belirtilen iadenin tüm detaylarını ve iade edilen ürünlerin satır bazlı onay/red durumlarını döner.

status: 0 = açık talep, 2 = müşteri talebi geri çekti.
Her ürün satırı kendi iade nedenini (reason_id, reason) taşır.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`id`	`12`	İade ID (zorunlu)
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/returns/detail?id=12&lang_id=1' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıtlar

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "iade_id": 12,
    "order_id": 305,
    "user_id": 88,
    "return_id": 3,
    "order_no": "SP-2026-0305",
    "customer_name": "Ahmet Yılmaz",
    "return_explanation": "Ürün hasarlı geldi.",
    "status": 0,
    "return_reason": "Hasarlı Ürün",
    "products": [
      {
        "row_id": "abc123def456",
        "id": 42,
        "name": "Örnek Ürün",
        "image": "https://example.com/uploads/urunler/example.jpg",
        "code": "PRD-001",
        "link": "https://example.com/ornek-urun",
        "unit_price": 299.9,
        "total_price": 299.9,
        "qty": 1,
        "options": null,
        "reason_id": 3,
        "reason": "Hasarlı Ürün",
        "confirm_status": false,
        "confirm_message": "",
        "cancel_status": false,
        "cancel_message": ""
      }
    ],
    "created_at": 1747296000,
    "created_at_local": "15.05.2026 - 10:00"
  }
}

404 Not FoundHata — İade Bulunamadı

{
  "status": false,
  "error": "not_found",
  "message": "Return not found."
}

PATCHİade Aksiyon (Onayla / Reddet)

{{base_url}}/returns?return_id=12&product_row_id=abc123def456

Bearer token gerekirContent-Type: application/json

Bir iade içindeki tek bir ürün satırını onaylar veya reddeder. Her ürün satırı bağımsız olarak işlenir.

Parametre notu: return_id ve product_row_id query string'de gönderilir; diğer alanlar JSON body'de.

action değerleri:

approve — ürünü onaylar; restore_stock: "true" ise stok geri eklenir; update_cari: "true" ise cari güncellenir (yalnız cari ödemeli siparişlerde); sipariş durumu otomatik olarak 8 (İade Edildi) yapılır
reject — ürünü reddeder

restore_stock / update_cari: "true" veya "false" string olarak gönderilmeli (integer 0/1 kabul edilmez).

Müşteri bildirimi: Talepteki son bekleyen ürün satırı da karara bağlandığında müşteriye sonuç e-postası ve SMS gönderilir (SMS panel ayarına bağlıdır).

Çift işlem koruması: Daha önce onaylanmış veya reddedilmiş ürün satırı için 409 döner.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`return_id`	`12`	İade ID (zorunlu)
`product_row_id`	`abc123def456`	Ürün satır ID'si — İade Detayı yanıtındaki `products[].row_id` değeri (zorunlu)

İstek gövdesi

{
  "action": "approve",
  "message": "İade talebiniz onaylandı.",
  "restore_stock": "true",
  "update_cari": "false"
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/returns?return_id=12&product_row_id=abc123def456' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "action": "approve",
  "message": "İade talebiniz onaylandı.",
  "restore_stock": "true",
  "update_cari": "false"
}'

Örnek yanıtlar

200 OKBaşarılı Yanıt — Onay

{
  "status": true,
  "data": {
    "message": "Product return approved successfully.",
    "return_id": 12,
    "action": "approve",
    "stock_restored": 1
  }
}

409 ConflictHata — Zaten İşlenmiş

{
  "status": false,
  "error": "already_processed",
  "message": "This product return has already been approved."
}

GETİade Nedenleri Listesi

{{base_url}}/returns/reasons?lang_id=1&status=&sort=id&order=asc&page=1&limit=100

Bearer token gerekir

Tanımlı iade nedenlerini sayfalı olarak listeler.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`lang_id`	`1`	Dil ID (varsayılan: 1 = TR)
`status`	—	Durum filtresi: active \| inactive
`sort`	`id`	Sıralama alanı: id \| sort
`order`	`asc`	Sıralama yönü: asc \| desc
`page`	`1`	Sayfa numarası (varsayılan: 1)
`limit`	`100`	Sayfa başına kayıt (1–500, varsayılan: 100)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/returns/reasons?lang_id=1&status=&sort=id&order=asc&page=1&limit=100' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "total": 8,
    "page": 1,
    "limit": 100,
    "items": [
      {
        "id": 1,
        "status": "active",
        "sort": 0,
        "return_name": "Hasarlı Ürün",
        "created_at": 1700000000,
        "created_at_local": "14.11.2023 - 23:13",
        "updated_at": 1747296000,
        "updated_at_local": "15.05.2026 - 10:00"
      }
    ]
  }
}

POSTİade Nedeni Ekle

{{base_url}}/returns/reasons

Bearer token gerekirContent-Type: application/json

Yeni iade nedeni oluşturur.

languages[] tüm aktif diller için gönderilmelidir (allActiveLangs zorunlu). status varsayılan: active.

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Hasarlı Ürün"
    },
    {
      "lang_id": 2,
      "name": "Damaged Product"
    },
    {
      "lang_id": 3,
      "name": "منتج تالف"
    },
    {
      "lang_id": 4,
      "name": "Beschädigtes Produkt"
    },
    {
      "lang_id": 5,
      "name": "Produit endommagé"
    },
    {
      "lang_id": 6,
      "name": "Поврежденный товар"
    },
    {
      "lang_id": 7,
      "name": "Zədələnmiş məhsul"
    }
  ],
  "status": "active",
  "sort": 0
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/returns/reasons' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Hasarlı Ürün"
    },
    {
      "lang_id": 2,
      "name": "Damaged Product"
    },
    {
      "lang_id": 3,
      "name": "منتج تالف"
    },
    {
      "lang_id": 4,
      "name": "Beschädigtes Produkt"
    },
    {
      "lang_id": 5,
      "name": "Produit endommagé"
    },
    {
      "lang_id": 6,
      "name": "Поврежденный товар"
    },
    {
      "lang_id": 7,
      "name": "Zədələnmiş məhsul"
    }
  ],
  "status": "active",
  "sort": 0
}'

Örnek yanıt

201 CreatedBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Return reason created successfully.",
    "return_reason_id": 9
  }
}

PATCHİade Nedeni Güncelle

{{base_url}}/returns/reasons?id=9

Bearer token gerekirContent-Type: application/json

Mevcut iade nedenini günceller. Sadece gönderilen alanlar güncellenir.

languages[] zorunludur ve mağazanın tüm aktif dillerini içermelidir; gönderilen adlar mevcut adların yerine yazılır.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`id`	`9`	Güncellenecek iade nedeni ID (zorunlu)

İstek gövdesi

{
  "languages": [
    {
      "lang_id": 1,
      "name": "Hasarlı / Ayıplı Ürün"
    },
    {
      "lang_id": 2,
      "name": "Damaged / Defective Product"
    }
  ],
  "status": "inactive",
  "sort": 5
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/returns/reasons?id=9' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "languages": [
    {
      "lang_id": 1,
      "name": "Hasarlı / Ayıplı Ürün"
    },
    {
      "lang_id": 2,
      "name": "Damaged / Defective Product"
    }
  ],
  "status": "inactive",
  "sort": 5
}'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Return reason updated successfully.",
    "return_reason_id": 9
  }
}

DELETEİade Nedeni Sil

{{base_url}}/returns/reasons?ids=2,3

Bearer token gerekir

Belirtilen iade nedenlerini siler.

Not: id=1 olan varsayılan iade nedeni silinemez; bu ID dahil edilirse 403 döner.

Toplu silme limiti: Tek istekte en fazla 50 ID gönderilebilir.

Rate limit: 120 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`ids`	`2,3`	Silinecek iade nedeni ID'leri, virgülle ayrılmış (zorunlu)

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/returns/reasons?ids=2,3' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıtlar

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "message": "Return reasons deleted successfully.",
    "deleted_ids": [
      2,
      3
    ],
    "count": 2
  }
}

403 ForbiddenHata — Varsayılan Neden Silinemez

{
  "status": false,
  "error": "forbidden",
  "message": "The default return reason (id=1) cannot be deleted."
}

Hızlı Sepet

5 uç nokta

Tutar bazlı hızlı sepet (fast cart) işlemleri. Belirli bir müşteri için fiyat, taksit, kargo ve tarih aralığı tanımlı özel ödeme linki oluşturur.

GETHızlı Sepet Listesi

{{base_url}}/fast-carts

Bearer token gerekirContent-Type: application/jsonAccept: application/json

Query Parameters

Field	Type	Description
search	string	Sepet adında arama; Max 100 karakter
status	string	Durum filtresi; Values: active / inactive
new_order_status	integer	Sipariş durumu; 0 = sipariş verilmedi, 1 = sipariş verildi
sort	string	Sıralanacak alan; Values: id / cart_name / cart_total / start_date / end_date / cart_status
order	string	Sıralama yönü; Values: asc / desc
page	integer	Sayfa numarası; Min: 1
limit	integer	Sayfa limiti; Min: 1 Max: 500

Response (200 OK)

{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "cart_name": "Yaz Kampanyası",
                "cart_url": "https://www.example.com/sepet/checkout?fast=XXXXX",
                "status": "active",
                "product_type": 1,
                "cart_type": 0,
                "cart_total": 1500.00,
                "start_date": 1714500000,
                "end_date": 1717178400,
                "start_date_local": "30.04.2024",
                "end_date_local": "31.05.2024",
                "created_at": 1714500000,
                "updated_at": 1714500000,
                "created_at_local": "30.04.2024 12:00:00",
                "updated_at_local": "30.04.2024 12:00:00"
            }
        ],
        "pager": {
            "currentPage": 1,
            "totalPages": 1,
            "totalRecords": 1
        }
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/fast-carts' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

GETHızlı Sepet Detayı

{{base_url}}/fast-carts/detail?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur.

Query Parameters

Field	Type	Description
id	integer - required	Hızlı Sepet ID

Response (200 OK)

{
    "status": true,
    "data": {
        "id": 1,
        "cart_name": "Yaz Kampanyası",
        "cart_url": "https://www.example.com/sepet/checkout?fast=XXXXX",
        "status": "active",
        "campaign_status": "inactive",
        "cargo_status": "inactive",
        "cargo_type": 0,
        "free_cargo": [],
        "product_type": 1,
        "cart_type": 0,
        "cart_installment": 1,
        "cart_limit": 0,
        "customer_limit": 0,
        "customers": [
            { "id": 12, "name": "Ahmet Yılmaz ([email protected])" }
        ],
        "region_info": { "id": 215, "name": "Türkiye" },
        "cart_total": 1500.00,
        "amount": {
            "name": "Danışmanlık Hizmeti",
            "price": "1500.00",
            "tax": 20
        },
        "customer_usage": [
            {
                "custome_id": 12,
                "or_no": "ORD-20240501-001",
                "or_id": 55,
                "created_at": 1714600000,
                "created_at_local": "01.05.2024 16:26:40"
            }
        ],
        "start_date": 1714500000,
        "end_date": 1717178400,
        "start_date_local": "30.04.2024 12:00",
        "end_date_local": "31.05.2024 12:00",
        "created_at": 1714500000,
        "updated_at": 1714500000,
        "created_at_local": "30.04.2024 12:00:00",
        "updated_at_local": "30.04.2024 12:00:00"
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/fast-carts/detail?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

POSTHızlı Sepet Ekle

{{base_url}}/fast-carts

Bearer token gerekirContent-Type: application/json

cart_name, amount, amount.name, amount.price, start_date ve end_date alanları zorunludur.

end_date değeri start_date değerinden büyük olmalıdır.

Body (JSON)

Field	Type	Rules
cart_name	string - required	Sepet adı; Max 255 karakter
amount	object - required	Tutar bilgileri
amount.name	string - required	Ürün/hizmet adı; Max 255 karakter
amount.price	decimal - required	Tutar; 0'dan büyük, Max 99999999
amount.tax_rate	integer	KDV oranı; Min 0 (varsayılan: 20)
status	string	Durum; Values: active / inactive (varsayılan: active)
cart_type	integer	Sepet tipi; 0 = herkes kullanabilir, 1 = yalnız üye girişi yapmış müşteriler
cart_campaign	integer	Mağaza kampanyaları (promosyonlar, havale ve mağazadan teslim indirimleri) bu sepette de uygulansın mı; 0 = hayır, 1 = evet
cart_installment	integer	Taksit sayısı; Min 1 Max 12 (varsayılan: 1)
cart_limit	integer	Toplam kullanım limiti; en az 1 olmalı, 0 gönderilirse sepet kullanılamaz
customer_limit	integer	Müşteri başına kullanım limiti; en az 1 olmalı, 0 gönderilirse sepet kullanılamaz
cart_customer	array	Sepetin atandığı müşteri ID listesi; her değer kayıtlı bir müşteri olmalı. Ödeme adımında erişim kısıtı olarak kullanılmaz; sepeti yalnız üyelere açmak için `cart_type: 1` kullanın
cargo_status	integer	Ücretsiz kargo; 0 = kapalı, 1 = açık
cargo_type	integer	Ücretsiz kargonun kapsamı (`cargo_status` = 1 iken); 0 = tüm kargo firmaları, 1 = yalnız `free_cargo` listesindeki firmalar
free_cargo	array	Ücretsiz kargo firması ID listesi; her değer ny_kargo_firma.id'de bulunmalı
region_info	integer	Ülke ID; ny_country.country_id'de bulunmalı (varsayılan: 215 = Türkiye)
start_date	integer - required	Başlangıç tarihi (Unix timestamp)
end_date	integer - required	Bitiş tarihi (Unix timestamp); start_date'den büyük olmalı

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Fast cart created successfully.",
        "id": 1,
        "cart_url": "https://www.example.com/sepet/checkout?fast=XXXXX"
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "cart_name": "Yaz Kampanyası",
  "amount": {
    "name": "Danışmanlık Hizmeti",
    "price": 1500,
    "tax_rate": 20
  },
  "status": "active",
  "cart_type": 0,
  "cart_campaign": 0,
  "cart_installment": 1,
  "cart_limit": 100,
  "customer_limit": 1,
  "cart_customer": [
    12,
    45
  ],
  "cargo_status": 0,
  "cargo_type": 0,
  "free_cargo": [],
  "region_info": 215,
  "start_date": 1714500000,
  "end_date": 1717178400
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/fast-carts' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "cart_name": "Yaz Kampanyası",
  "amount": {
    "name": "Danışmanlık Hizmeti",
    "price": 1500,
    "tax_rate": 20
  },
  "status": "active",
  "cart_type": 0,
  "cart_campaign": 0,
  "cart_installment": 1,
  "cart_limit": 100,
  "customer_limit": 1,
  "cart_customer": [
    12,
    45
  ],
  "cargo_status": 0,
  "cargo_type": 0,
  "free_cargo": [],
  "region_info": 215,
  "start_date": 1714500000,
  "end_date": 1717178400
}'

PATCHHızlı Sepet Düzenle

{{base_url}}/fast-carts?id=1

Bearer token gerekirContent-Type: application/json

id query parametresi zorunludur. Body'de yalnızca güncellenmek istenen alanlar gönderilir.

amount.price gönderilirse cart_total da güncellenir.

Query Parameters

Field	Type	Description
id	integer - required	Hızlı Sepet ID

Body (JSON)

Field	Type	Rules
cart_name	string	Sepet adı; Max 255 karakter
amount	object	Tutar bilgileri
amount.name	string	Ürün/hizmet adı; Max 255 karakter
amount.price	decimal	Tutar; 0'dan büyük, Max 99999999
amount.tax_rate	integer	KDV oranı; Min 0
status	string	Durum; Values: active / inactive
cart_type	integer	Sepet tipi; 0 = herkes kullanabilir, 1 = yalnız üye girişi yapmış müşteriler
cart_campaign	integer	Mağaza kampanyaları (promosyonlar, havale ve mağazadan teslim indirimleri) bu sepette de uygulansın mı; 0 = hayır, 1 = evet
cart_installment	integer	Taksit sayısı; Min 1 Max 12
cart_limit	integer	Toplam kullanım limiti; en az 1 olmalı, 0 gönderilirse sepet kullanılamaz
customer_limit	integer	Müşteri başına kullanım limiti; en az 1 olmalı, 0 gönderilirse sepet kullanılamaz
cart_customer	array	Sepetin atandığı müşteri ID listesi; ödeme adımında erişim kısıtı olarak kullanılmaz
cargo_status	integer	Ücretsiz kargo; 0 = kapalı, 1 = açık
cargo_type	integer	Ücretsiz kargonun kapsamı (`cargo_status` = 1 iken); 0 = tüm kargo firmaları, 1 = yalnız `free_cargo` listesindeki firmalar
free_cargo	array	Ücretsiz kargo firması ID listesi
region_info	integer	Ülke ID
start_date	integer	Başlangıç tarihi (Unix timestamp)
end_date	integer	Bitiş tarihi (Unix timestamp)

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Fast cart updated successfully.",
        "id": 1,
        "cart_url": "https://www.example.com/sepet/checkout?fast=XXXXX"
    }
}

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "cart_name": "Güncellendi Yaz Kampanyası",
  "amount": {
    "name": "Danışmanlık Hizmeti",
    "price": 1800,
    "tax_rate": 20
  },
  "status": "active",
  "end_date": 1719856800
}

İstek örneği

curl --request PATCH 'https://www.example.com/api/ecommerce/v1/fast-carts?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "cart_name": "Güncellendi Yaz Kampanyası",
  "amount": {
    "name": "Danışmanlık Hizmeti",
    "price": 1800,
    "tax_rate": 20
  },
  "status": "active",
  "end_date": 1719856800
}'

DELETEHızlı Sepet Sil

{{base_url}}/fast-carts?id=1

Bearer token gerekirContent-Type: application/jsonAccept: application/json

id parametresi zorunludur. Tek veya virgülle ayrılmış çoklu ID gönderilebilir. Bir seferde maksimum 50 ID silinebilir.

Query Parameters

Field	Type	Description
id	string - required	Silinecek ID(ler); tekil: `1` veya virgüllü: `1,2,3`; Max 50 adet

Response (200 OK)

{
    "status": true,
    "data": {
        "message": "Fast cart deleted successfully.",
        "id": "1"
    }
}

Rate limit: 120 istek/dakika

İstek örneği

curl --request DELETE 'https://www.example.com/api/ecommerce/v1/fast-carts?id=1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Raporlar

8 uç nokta

Satış, sipariş, ürün, stok, müşteri, iade, kupon ve terk edilmiş sepet raporları. Tüm dönem parametreleri: today, 7d, 30d, this_month, last_month, this_year, custom. custom seçildiğinde start_date ve end_date (YYYY-MM-DD) zorunludur.

GETSatış Özeti

{{base_url}}/reports/sales?period=30d&breakdown=

Bearer token gerekir

Belirtilen dönem için finansal satış özetini döner. breakdown parametresi eklenirse günlük veya saatlik sipariş dağılımı da eklenir.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`breakdown`	—	Zaman dağılımı: daily \| hourly (isteğe bağlı)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/sales?period=30d&breakdown=' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "summary": {
      "order_total": 125430.5,
      "order_total_format": "₺125.430,50",
      "order_qty": 312,
      "product_amount": 118200,
      "product_amount_format": "₺118.200,00",
      "total_product": 87,
      "total_product_qty": 540,
      "cargo_total": 4320,
      "cargo_total_format": "₺4.320,00",
      "cargo_qty": 280,
      "maturity_total": 1200,
      "maturity_total_format": "₺1.200,00",
      "maturity_qty": 15,
      "extra_total": 0,
      "extra_total_format": "₺0,00",
      "extra_qty": 0,
      "discount_total": 3250,
      "discount_total_format": "₺3.250,00",
      "discount_qty": 42,
      "average_order_value": 401.99,
      "average_order_value_format": "₺401,99"
    },
    "breakdown": [
      {
        "period": "2026-05-14",
        "order_qty": 18,
        "order_total": 7230.5,
        "order_total_format": "₺7.230,50"
      }
    ]
  }
}

GETSipariş İstatistikleri

{{base_url}}/reports/orders?period=30d&city_limit=10

Bearer token gerekir

Sipariş durumu, ödeme yöntemi, kargo firması ve şehir bazlı dağılımları döner.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`city_limit`	`10`	Şehir dağılımında gösterilecek maksimum şehir sayısı (1–50, varsayılan: 10)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/orders?period=30d&city_limit=10' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "summary": {
      "total_orders": 312,
      "total_revenue": 125430.5,
      "total_revenue_format": "₺125.430,50",
      "average_order_value": 401.99,
      "average_order_value_format": "₺401,99"
    },
    "status_breakdown": [
      {
        "status": "completed",
        "label": "Tamamlandı",
        "order_qty": 210,
        "order_total": 95000,
        "order_total_format": "₺95.000,00"
      },
      {
        "status": "preparing",
        "label": "Hazırlanıyor",
        "order_qty": 45,
        "order_total": 18200,
        "order_total_format": "₺18.200,00"
      },
      {
        "status": "shipped",
        "label": "Kargolandı",
        "order_qty": 30,
        "order_total": 12000,
        "order_total_format": "₺12.000,00"
      },
      {
        "status": "pending_approval",
        "label": "Onay Bekliyor",
        "order_qty": 12,
        "order_total": 4800,
        "order_total_format": "₺4.800,00"
      },
      {
        "status": "cancelled",
        "label": "İptal Edildi",
        "order_qty": 10,
        "order_total": 0,
        "order_total_format": "₺0,00"
      },
      {
        "status": "on_hold",
        "label": "Beklemede",
        "order_qty": 5,
        "order_total": 430.5,
        "order_total_format": "₺430,50"
      }
    ],
    "payment_breakdown": [
      {
        "payment_type": "Kredi Kartı",
        "payment_type_id": 1,
        "order_qty": 250,
        "order_total": 102000,
        "order_total_format": "₺102.000,00"
      },
      {
        "payment_type": "Havale/EFT",
        "payment_type_id": 2,
        "order_qty": 62,
        "order_total": 23430.5,
        "order_total_format": "₺23.430,50"
      }
    ],
    "cargo_breakdown": [
      {
        "cargo_company": "Yurtiçi Kargo",
        "order_qty": 180,
        "cargo_total": 2700,
        "cargo_total_format": "₺2.700,00"
      },
      {
        "cargo_company": "MNG Kargo",
        "order_qty": 132,
        "cargo_total": 1620,
        "cargo_total_format": "₺1.620,00"
      }
    ],
    "city_breakdown": [
      {
        "city": "İstanbul",
        "order_qty": 120,
        "order_total": 48000,
        "order_total_format": "₺48.000,00"
      },
      {
        "city": "Ankara",
        "order_qty": 65,
        "order_total": 26000,
        "order_total_format": "₺26.000,00"
      }
    ]
  }
}

GETEn Çok Satan Ürünler

{{base_url}}/reports/products/top-sellers?period=30d&sort=quantity&limit=10

Bearer token gerekir

Belirtilen dönemde en çok satılan ürünleri ödemesi onaylanmış siparişler baz alınarak listeler.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`sort`	`quantity`	Sıralama: quantity \| revenue (varsayılan: quantity)
`limit`	`10`	Gösterilecek ürün sayısı (1–50, varsayılan: 10)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/products/top-sellers?period=30d&sort=quantity&limit=10' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "sort": "quantity",
    "limit": 10,
    "products": [
      {
        "id": 42,
        "code": "PRD-001",
        "name": "Örnek Ürün",
        "total_qty": 85,
        "total_revenue": 25415,
        "total_revenue_format": "₺25.415,00"
      }
    ]
  }
}

GETStok Durumu

{{base_url}}/reports/stock?threshold=5&limit=50

Bearer token gerekir

Genel stok özeti ve kritik stok altındaki ürünleri döner. Bu endpoint dönem filtresi almaz — anlık stok verisi döner.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`threshold`	`5`	Kritik stok eşiği (1–1000, varsayılan: 5) — bu değer ve altındaki ürünler `low_stock_products` listesine girer
`limit`	`50`	Listede döndürülecek maksimum ürün sayısı (1–200, varsayılan: 50)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/stock?threshold=5&limit=50' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "threshold": 5,
    "summary": {
      "total_products": 320,
      "stock_off": 12,
      "out_of_stock": 8,
      "low_stock": 25,
      "total_stock_value": 485200,
      "total_stock_value_format": "₺485.200,00"
    },
    "low_stock_products": [
      {
        "id": 17,
        "code": "PRD-017",
        "name": "Az Stoklu Ürün",
        "stock_total": 2,
        "price": 199.9,
        "price_format": "₺199,90"
      }
    ]
  }
}

GETMüşteri İstatistikleri

{{base_url}}/reports/customers?period=30d&city_limit=10

Bearer token gerekir

Aktif müşteri sayısını, dönem içindeki yeni kayıt sayısını, tekrar alıcı sayısını ve sipariş bazlı şehir dağılımını döner. repeat_buyers dönemden bağımsızdır: ödemesi onaylı en az 2 siparişi olan üyeleri sayar.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`city_limit`	`10`	Şehir dağılımında gösterilecek maksimum şehir sayısı (1–50, varsayılan: 10)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/customers?period=30d&city_limit=10' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "summary": {
      "total_active_customers": 1540,
      "new_customers_in_period": 87,
      "repeat_buyers": 320
    },
    "top_cities": [
      {
        "city": "İstanbul",
        "order_qty": 120,
        "order_total": 48000,
        "order_total_format": "₺48.000,00"
      },
      {
        "city": "Ankara",
        "order_qty": 65,
        "order_total": 26000,
        "order_total_format": "₺26.000,00"
      }
    ]
  }
}

GETİade İstatistikleri

{{base_url}}/reports/returns?period=30d

Bearer token gerekir

İade sayısı, iade oranı, durum dağılımı ve en çok görülen iade nedenlerini döner. İade oranı aynı dönemdeki toplam sipariş sayısına göre hesaplanır.

status_breakdown her zaman beş durum döner: pending, approved, rejected, partial (kısmen onaylandı), withdrawn (müşteri geri çekti).
top_reasons en fazla 5 nedeni iade edilen ürün adedine göre listeler; return_total ürün adedidir. Müşterinin geri çektiği talepler hariçtir.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/returns?period=30d' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "summary": {
      "total_returns": 18,
      "total_orders": 312,
      "return_rate": 5.77
    },
    "status_breakdown": [
      {
        "status": "pending",
        "label": "Beklemede",
        "return_qty": 8
      },
      {
        "status": "approved",
        "label": "Onaylandı",
        "return_qty": 7
      },
      {
        "status": "rejected",
        "label": "Reddedildi",
        "return_qty": 3
      },
      {
        "status": "partial",
        "label": "Kısmen Onaylandı",
        "return_qty": 0
      },
      {
        "status": "withdrawn",
        "label": "Müşteri Geri Çekti",
        "return_qty": 0
      }
    ],
    "top_reasons": [
      {
        "return_name": "Ürün hasarlı geldi",
        "return_total": 7
      },
      {
        "return_name": "Yanlış ürün gönderildi",
        "return_total": 5
      },
      {
        "return_name": "Ürün beğenilmedi",
        "return_total": 4
      }
    ]
  }
}

GETKupon İstatistikleri

{{base_url}}/reports/coupons?period=30d

Bearer token gerekir

Aktif kupon sayısı, dönemdeki kupon kullanım istatistikleri ve en çok kullanılan 10 kuponu döner.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/coupons?period=30d' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "summary": {
      "active_coupons": 14,
      "total_usage": 42,
      "order_total": 18500,
      "order_total_format": "₺18.500,00",
      "total_discount": 3250,
      "total_discount_format": "₺3.250,00"
    },
    "top_coupons": [
      {
        "coupon_id": 3,
        "code": "YAZ20",
        "usage_count": 18,
        "order_total": 7200,
        "order_total_format": "₺7.200,00",
        "total_discount": 1440,
        "total_discount_format": "₺1.440,00"
      }
    ]
  }
}

GETTerk Edilmiş Sepet

{{base_url}}/reports/abandoned-carts?period=30d&breakdown=

Bearer token gerekir

Üye kullanıcıların terk ettiği sepetlerin özet istatistiklerini döner. breakdown=daily parametresi eklenirse günlük dağılım da eklenir.

Rate limit: 60 istek/dakika

Sorgu parametreleri

Parametre	Örnek değer	Açıklama
`period`	`30d`	Dönem: today \| 7d \| 30d \| this_month \| last_month \| this_year \| custom
`start_date`	—	Başlangıç tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`end_date`	—	Bitiş tarihi (YYYY-MM-DD) — sadece period=custom için zorunlu
`breakdown`	—	Günlük dağılım: daily (isteğe bağlı, tek geçerli değer)

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/reports/abandoned-carts?period=30d&breakdown=' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "period": {
      "label": "Son 30 Gün",
      "start_date": "15.04.2026",
      "end_date": "15.05.2026"
    },
    "summary": {
      "cart_qty": 145,
      "total_value": 28750,
      "total_value_format": "₺28.750,00",
      "total_items": 412
    },
    "breakdown": [
      {
        "period": "2026-05-14",
        "cart_qty": 7,
        "total_value": 1380,
        "total_value_format": "₺1.380,00"
      }
    ]
  }
}

Ayarlar

2 uç nokta

Mağaza firma bilgilerini güncellemek için kullanılan endpoint'ler.

GETFirma Bilgileri Görüntüle

{{base_url}}/settings/company

Bearer token gerekir

Mevcut firma bilgilerini döner. Hassas ve dahili alanlar (logo, settings, ip, domain, theme vb.) yanıta dahil edilmez.

Rate limit: 120 istek/dakika

İstek örneği

curl --request GET 'https://www.example.com/api/ecommerce/v1/settings/company' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Örnek yanıt

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "company_name": "Örnek Mağaza",
    "full_company_name": "Örnek Mağaza Ticaret A.Ş.",
    "company_about": "Hakkımızda kısa açıklama.",
    "company_address": "İstanbul, Türkiye",
    "company_tel1": "+90 212 000 00 00",
    "company_tel2": "+90 532 000 00 00",
    "company_mail1": "[email protected]",
    "company_mail2": "[email protected]",
    "company_description": "<p>Uzun açıklama metni.</p>",
    "working_hours": "Hft içi 09:00 - 18:00",
    "company_location": "<iframe src=\"https://maps.google.com/...\"></iframe>",
    "facebook": "https://facebook.com/ornekmagaza",
    "twitter": "https://twitter.com/ornekmagaza",
    "instagram": "https://instagram.com/ornekmagaza",
    "google": "https://g.page/ornekmagaza",
    "linkedin": "https://linkedin.com/company/ornekmagaza",
    "tiktok": "https://tiktok.com/@ornekmagaza",
    "pinterest": "https://pinterest.com/ornekmagaza",
    "footer_icon_type": 0,
    "header_icon_type": 1
  }
}

POSTFirma Bilgileri Güncelle

{{base_url}}/settings/company

Bearer token gerekirContent-Type: application/json

Firma bilgilerini günceller. Tüm alanlar isteğe bağlıdır; en az bir tanınmış alan gönderilmelidir.

Alanlar:

Alan	Kural	Açıklama
`company_name`	Max 255 karakter	Kısa ticari unvan
`full_company_name`	Max 500 karakter	Tam yasal unvan
`company_about`	Max 5000 karakter	Kısa hakkımızda metni
`company_address`	Max 500 karakter	Açık adres
`company_tel1`	Max 30 karakter	Birincil telefon
`company_tel2`	Max 30 karakter	İkincil telefon
`company_mail1`	Geçerli e-posta; Max 255 karakter	Birincil e-posta
`company_mail2`	Geçerli e-posta; Max 255 karakter	İkincil e-posta
`company_description`	Max 100000 karakter; HTML kabul edilir	Uzun açıklama / hakkımızda
`lang_id`	integer; pozitif tam sayı (varsayılan: 1)	`company_description`'ın kaydedileceği dil
`working_hours`	Max 500 karakter	Çalışma saatleri
`company_location`	Max 10000 karakter; yalnızca Google Maps iframe kabul edilir, diğer kaynaklar otomatik temizlenir	Harita embed kodu
`facebook`	Geçerli https/http URL; Max 500 karakter	Facebook profil URL'i
`twitter`	Geçerli https/http URL; Max 500 karakter	Twitter/X profil URL'i
`instagram`	Geçerli https/http URL; Max 500 karakter	Instagram profil URL'i
`google`	Geçerli https/http URL; Max 500 karakter	Google Business URL'i
`linkedin`	Geçerli https/http URL; Max 500 karakter	LinkedIn profil URL'i
`tiktok`	Geçerli https/http URL; Max 500 karakter	TikTok profil URL'i
`pinterest`	Geçerli https/http URL; Max 500 karakter	Pinterest profil URL'i
`footer_icon_type`	integer; `0` veya `1`	Footer sosyal ikon tipi
`header_icon_type`	integer; `0` veya `1`	Header sosyal ikon tipi

Rate limit: 120 istek/dakika

İstek gövdesi

{
  "company_name": "Örnek Mağaza",
  "full_company_name": "Örnek Mağaza Ticaret A.Ş.",
  "company_about": "Hakkımızda kısa açıklama.",
  "company_address": "İstanbul, Türkiye",
  "company_tel1": "+90 212 000 00 00",
  "company_tel2": "+90 532 000 00 00",
  "company_mail1": "[email protected]",
  "company_mail2": "[email protected]",
  "company_description": "<p>Uzun açıklama / hakkımızda metni. HTML kabul edilir.</p>",
  "working_hours": "Hft içi 09:00 - 18:00",
  "company_location": "<iframe src=\"https://maps.google.com/...\"></iframe>",
  "facebook": "https://facebook.com/ornekmagaza",
  "twitter": "https://twitter.com/ornekmagaza",
  "instagram": "https://instagram.com/ornekmagaza",
  "google": "https://g.page/ornekmagaza",
  "linkedin": "https://linkedin.com/company/ornekmagaza",
  "tiktok": "https://tiktok.com/@ornekmagaza",
  "pinterest": "https://pinterest.com/ornekmagaza",
  "footer_icon_type": 0,
  "header_icon_type": 1
}

İstek örneği

curl --request POST 'https://www.example.com/api/ecommerce/v1/settings/company' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --data '{
  "company_name": "Örnek Mağaza",
  "full_company_name": "Örnek Mağaza Ticaret A.Ş.",
  "company_about": "Hakkımızda kısa açıklama.",
  "company_address": "İstanbul, Türkiye",
  "company_tel1": "+90 212 000 00 00",
  "company_tel2": "+90 532 000 00 00",
  "company_mail1": "[email protected]",
  "company_mail2": "[email protected]",
  "company_description": "<p>Uzun açıklama / hakkımızda metni. HTML kabul edilir.</p>",
  "working_hours": "Hft içi 09:00 - 18:00",
  "company_location": "<iframe src=\"https://maps.google.com/...\"></iframe>",
  "facebook": "https://facebook.com/ornekmagaza",
  "twitter": "https://twitter.com/ornekmagaza",
  "instagram": "https://instagram.com/ornekmagaza",
  "google": "https://g.page/ornekmagaza",
  "linkedin": "https://linkedin.com/company/ornekmagaza",
  "tiktok": "https://tiktok.com/@ornekmagaza",
  "pinterest": "https://pinterest.com/ornekmagaza",
  "footer_icon_type": 0,
  "header_icon_type": 1
}'

Örnek yanıtlar

200 OKBaşarılı Yanıt

{
  "status": true,
  "data": {
    "updated_fields": [
      "company_name",
      "company_mail1",
      "instagram"
    ],
    "description_lang_id": 1
  }
}

400 Bad RequestHata — Tanınan Alan Yok

{
  "status": false,
  "error": "no_fields",
  "message": "Güncellenecek en az bir geçerli alan gönderilmelidir."
}

422 Unprocessable EntityHata — Validasyon

{
  "status": false,
  "error": "validation_error",
  "message": {
    "company_mail1": "company_mail1 alanı geçerli bir e-posta adresi olmalıdır."
  }
}