Kidswearworld API(v1.0.0) Son Güncelleme: 01.03.2021

Kidswearworld API ile birlikte kidswearworld üzerinde size ait tüm verileri işleyebilir, kendi uygulamalarınız ile entegre edebilirsiniz.

Kidswearworld API modülümüzü her geçen gün geliştiriyoruz, görüşlerinizi bize destek@kidswearworld.com adresinden iletebilirsiniz.

Sezon Listeleme

Bu endpoint ile birlikte Kidswearworld'deki bütün sezonları çekebilirsiniz. Sezonlar ürünleri eklerken sezon seçmenize yardımcı olucaktır.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "count": "2",
    "content": [
        {
           "id": "1",
           "title": "2020 Yaz",
        },
        {
           "id": "2",
           "title": "2020 Kış",
        }
    ]
  }

Marka Listeleme

Bu endpoint ile birlikte Kidswearworld'deki firmaya ait markaları çekebilirsiniz. Markalar ürünleri eklerken marka seçmenize yardımcı olucaktır.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "count": "2",
    "content": [
        {
           "id": "1",
           "title": "Kidswearworld",
        },
        {
           "id": "2",
           "title": "JoinDigital",
        }
    ]
  }

Koleksiyon Listeleme

Bu endpoint ile birlikte Kidswearworld'deki bütün koleksiyonları çekebilirsiniz. Koleksiyonlar ürünleri eklerken koleksiyon seçmenize yardımcı olucaktır.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "count": "2",
    "content": [
        {
           "id": "1",
           "title": "Yaz Koleksiyonu",
        },
        {
           "id": "2",
           "title": "Kış Koleksiyonu",
        }
    ]
  }

Kategorileri Listeleme

Bu endpoint ile birlikte Kidswearworld'deki ana kategorileri çekebilirsiniz. Kategoriler ürünleri eklerken kategori seçmenize yardımcı olucaktır.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "count": "3",
    "content": [
        {
           "id": "110",
           "title": "Ev Tekstili",
           "parentID": "0",
        },
        {
           "id": "109",
           "title": "Aksesuar",
           "parentID": "0",
        },
        {
           "id": "108",
           "title": "Hamile İç Giyim",
           "parentID": "0",
        },
    ]
  }

Tüm Kategorileri Listelemek

Bu endpoint ile birlikte Kidswearworld'deki tüm kategorileri listeleyebilirsiniz.

Endpoint
Header(Authantication)
Response(application/json)

{
    "status": "success",
    "code": "200",
    "count": 6,
    "content": [
        {
            "id": "110",
            "title": "Ev Tekstili",
            "parentID": "0",
            "sub_category": [
                {
                    "id": "144",
                    "title": "Minder",
                    "parentID": "110"
                },
                {
                    "id": "143",
                    "title": "Yastık / Yorgan",
                    "parentID": "110"
                },
                {
                    "id": "126",
                    "title": "Uyku Seti",
                    "parentID": "110"
                },
                {
                    "id": "125",
                    "title": "Nevresim Takımı",
                    "parentID": "110"
                }
            ]
        }
      
    ]
}

Alt Kategorileri Listeleme

Bu endpoint ile birlikte Kidswearworld'deki ana kategorileri çekebilirsiniz. Kategoriler ürünleri eklerken kategori seçmenize yardımcı olucaktır. Eğer alt kategori yok ise content false değeri döndürür.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "id": "110",
    "parentID": "0",
    "title": "Ev Tekstili",
    "count": "4",
    "content": [
        {
           "id": "144",
           "title": "Minder",
           "parentID": "110",
        },
        {
           "id": "143",
           "title": "Yastık / Yorgan",
           "parentID": "110",
        },
        {
           "id": "126",
           "title": "Uyku Seti",
           "parentID": "110",
        },
        {
           "id": "125",
           "title": "Nevresim Takımı",
           "parentID": "110",
        },
    ]
  }

Ürün Varyantlarını Listelemek

Bu endpoint ile birlikte Kidswearworld'deki kategoriye bağlı ürün varyantlarını çekebilirsiniz.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "count": "3",
    "content": [
        {
           "id": "14",
           "title": "Ay",
        },
        {
           "id": "13",
           "title": "Yaş",
        }
        {
           "id": "10",
           "title": "Renk",
        }
    ]
  }

Ürün Varyant Değerlerini Listelemek

Bu endpoint ile birlikte Kidswearworld'deki ürün varyantlarının değerlerini çekebilirsiniz. Ürün eklerken yardımcı olucaktır.

Endpoint
Header(Authantication)
Response(application/json)

  {
    
    "status": "success",
    "code": "200",
    "title": "Renk",
    "id": "10",
    "count": "4",
    "content": [
        {
           "id": "107",
           "title": "Beyaz",
        },
        {
           "id": "108",
           "title": "Siyah",
        },
        {
           "id": "109",
           "title": "Mavi",
        },
        {
           "id": "110",
           "title": "Kırmızı",
        }
    ]
  }

Ürün Ekleme/Güncelleme

Bu endpoint ile birlikte Kidswearworld'a ürünlerinizi aktarabilirsiniz. Ürün güncellemek için gene bu endpointi kullanabilirsiniz
güncellemek istediğiniz ürünün idsini göndermeniz yeterlidir. Para birimi olarak şuan sadece USD kullanılıcaktır.

Endpoint
Header(Authantication)
Request (application/json)
    
    {
        "status":"1",
        "product_code":"00005",
        "public_showroom":"1",
        "vip_showroom":"0",
        "brand_id":"69",
        "category":"67",
        "season_id":"24",
        "collection_id": [83,84],
        "gender":"erkek", // erkek,kiz,unisex
        "price": "10",
        "stock": "150",
        "pack_quantity": "3", // paketdeki ürün adeti
        "kdv": "18",
        "variants":
        [
            {
                "price": "100",
                "stock":  "10",
                "pack_quantity": "3", // paketdeki ürün adeti
                "stock_code":  "1005",
                "barcode":  "1000000",
                "variant":[
                    { 
                        "name":"Renk",
                        "value":"Beyaz"
                    },
                    { 
                        "name":"Yaş",
                        "value":"1-2-3"
                    }
                ]
            }
        ],
        "images": [
            {
                "order":"0",
                "image": "https://app.kidswearworld.com/images/urunler/125/3101.jpg"
            },
            {
                "order":"1",
                "image": "https://app.kidswearworld.com/images/urunler/125/3101.jpg"
            }
        ]
    }
    
    
Response (application/json)
    
    {
        "status": "success",
        "code": "200",
        "message": "Ürün başarıyla eklendi.",
        "product_id": "4273"
    }
    
    

Toplu Ürün Güncelleme

Bu endpoint ile birlikte Kidswearworld'a ürünlerinizin toplu olarak fiyat,stok kısımlarını güncelleyebilirsiniz. Maksimum 30 ürün gönderebilirsiniz.
Aşağıdaki örnekte varyantsız ürün ile varyant güncelleme örneği gösterilmiştir. Eğer varyantsız bir ürünü güncellemek istiyorsanız product_id ile güncellemek istediğiniz değerleri göndermeniz yeterli.
Eğer varyant güncellemek isterseniz. O varyanta ait stok kodu, variant değerini 1 ve ana ürün idsini göndermeniz yeterli.

Endpoint
Header(Authantication)
Request (application/json)
    
    {
        "items": [
            {
                "price": 211.55,
                "stock": 35,
                "product_id": 4576
            },
            {
                "price": 3112.55,
                "stock": 35,
                "product_id": 4578,
                "stock_code": "10052",
                "variant": 1
            }
        ]
    }
    
    
Response (application/json)
    
    {
        "status": "success",
        "message": "Güncelleme işlemi başarılı."
    }
    
    

Ürün Durumu Güncelleme

Bu endpoint ile birlikte Kidswearworld'a ürünlerinizi toplu olarak satışa kapatabilir veya açabilirsiniz. Maksimum toplu olarak 50 ürün gönderebilirsiniz.

Endpoint
Header(Authantication)
Request (application/json)
    
    {
        "items": [4564,4565],
        "status": 0
    }
    
    
Response (application/json)
    
    {
        "status": "success",
        "message": "Ürün durumu başarıyla değiştirildi."
    }
    
    

Ürün Sorgulama

Bu endpoint ile birlikte stok kodunuz Kidswearworld'deki ürünlerinizi sorgulayabilirsiniz.

Endpoint
Header(Authantication)
Response(application/json)

  {
    "status": "success",
    "code": "200",
    "content": {
        "product_id": "4686",
        "status": 0,
        "product_code": "PJE6769.Lacivert.86-92",
        "public_showroom": "0",
        "vip_showroom": "0",
        "brand_id": "69",
        "category": "55",
        "season_id": "4",
        "price": "15.60",
        "kdv": "8",
        "stock": "5"
    }
}

Sipariş Listeleme

Bu endpoint ile birlikte Kidswearworld'deki bütün siparişlerinizi çekebilirsiniz.
Sipariş durumuna göre siparişleri çekmek için status değişkenini göndermeniz yeterlidir.
Örn: https://api.kidswearworld.com/yass/orders?status=yeni-siparis

Sipariş Durumları:
yeni-siparis = Yeni siparişleri döndürür.
kargoya-verildi = Kargoya verilen siparişleri döndürür.
teslim-edildi = Teslim edilen siparişleri döndürür.
iptal-edildi = İptal edilen siparişleri döndürür.

Endpoint
Header(Authantication)
Response(application/json)

{
    "status": "success",
    "code": "200",
    "page": 1,
    "count": 1,
    "content": [
        {
            "id": "16",
            "orderDate": "20-05-2021",
            "orderDateUnix": "1614580016",
            "orderNumber": "3783016",
            "status": "New",
            "paymentStatus": "Waiting", // Waiting, Cancel, Success
            "totalPrice": "590.00",
            "currencyCode": "USD",
            "shipmentAddress": {
                "id": "31",
                "firstName": "Kidswear",
                "lastName": "Kullanıcısı",
                "email": "destek@kidswearworld.com",
                "phone": "+905422032208",
                "country": "Turkey",
                "city": "Bursa",
                "countryCode": "TR",
                "district": "Kazım Karabekir",
                "postalCode": "16340",
                "address": "Kazım Karabekir Mh. Muhsin Yazıcıoğlu Blv. No:64/A Yıldırım/BURSA",
                "company_name": "Kidswearworld",
                "tax_number": "000000000",
                "tax_office": "Setbaşı"
            },
            "invoiceAddress": {
                "id": "32",
                "firstName": "Kidswear",
                "lastName": "Kullanıcısı",
                "phone": "+905422032208",
                "country": "Turkey",
                "city": "Bursa",
                "countryCode": "TR",
                "district": "Kazım Karabekir",
                "postalCode": "16340",
                "address": "Kazım Karabekir Mh. Muhsin Yazıcıoğlu Blv. No:64/A Yıldırım/BURSA",
                "company_name": "Kidswearworld",
                "tax_number": "000000000",
                "tax_office": "Setbaşı"
            },
            "lines": [
                {
                    "id": "19",
                    "productCode": "00003",
                    "variant": true,
                    "price": "500.00",
                    "quantity": "1",
                    "kdv_price": "0",
                    "total_price": "590.00",
                    "kdv": "0"
                },
                {
                    "id": "20",
                    "productCode": "00003",
                    "variant": true,
                    "price": "500.00",
                    "quantity": "1",
                    "kdv_price": "0",
                    "total_price": "590.00",
                    "kdv": "0"
                }
            ]
        },
    ]
}