Logotipa maydonlari rasm yuklanganidan keyin paydo bo'ladi. API-da ishtirok etmaydigan umumiy model maydonlar qasddan chetga chiqariladi.
Brand10 maydonlar
brandIdinteger
SelSup hisobida marka identifikatori.
read-only
namestring
Markaz nomi. Oldingi va orqa tomonni saqlashda olib tashlanadi.
Majburiy
logoUrlstring
Joriy logotipning ommaviy URL-nomasi.
read-only
logoSizeinteger
Logotip hajmi bytelarda.
read-only
logoWidthinteger
Logotip kengligi piksellarda.
read-only
logoHeightinteger
Logotipi balandligi piksellarda.
read-only
deletedboolean
Markaz arxivga olinganmi yoki yo'qmi.
ozonNamestring
Ozon katalogidagi brend nomi.
nullable
ozonIdinteger · int64
Ozondagi brend identifikatori.
nullable
oneCIdstring
1C-dagi tashqi marka identifikatori.
nullable
Xato shartnomasi
Ilovalar xatolarini qaytarib berish usuli
error kodlari har bir joyda bir xil, foydalanuvchiga qaratilgan xabar server tomonidan tarjima qilinadi. error atrofida dastur mantiqasini quring va localMessage-dan faqat ko'rsatish uchun foydalaning.
error
Integratsiya mantiqasini yaratish uchun barqaror mashina o'qiladigan kod.
localMessage
API token foydalanuvchisining tilida ko'rsatishga tayyor xabar.
params
Server tomonidan mahalliylashtirilgan xabar namunalariga interpolatsiya qilingan qiymatlar.
文
localMessage API tokenini egallagan foydalanuvchining lang maydoni ishlatiladi. Hujjat tili va Accept-Language boshliq uni o'zgartirmaydi; foydalanuvchi tilni moslamasa rus tilida ishlatiladigan.
RUFoydalanuvchi manzili ru
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}
Ro'yxatlar, qidirish va sinxronlashtirish uchun asosiy tugma nuqtasi. Bu joriy hisobdan brendlarni qaytaradi va barqaror sahifalashni qo'llab-quvvatlaydi.
i
to'liq faqat count=true bo'lganda qaytariladi. Keyingi sahifalar uchun hisobni o'chirib qo'ying.
Soʻrov parametrlari
Maydon
Tur
Majburiy
Tavsif
query
string
Yoʻq
Brend nomida qidirish uchun substring.
deleted
boolean
Yoʻq
Arxivga o'rnatilgan uchun haqiqiy, faol uchun yolg'on. Ikkalasi ham qaytarilmasin.
brandOneCId
string
Yoʻq
1Cning aniq tashqi identifikatori.
hasOzonId
boolean
Yoʻq
faqat Ozonga xarita qilingan brendlarni qaytarish uchun haqiqiy.
limitStandart qiymat: 50
integer
Yoʻq
Har sahifada 500 gacha rekordlar.
pageStandart qiymat: 1
integer
Yoʻq
Sahifa raqami 1-dan boshlanadi.
countStandart qiymat: false
boolean
Yoʻq
To'liq o'yinlar sonini o'zgartirish.
sortBy
stringNAME, BRANDID
Yoʻq
Marka nomi uchun ism, ichki identifikator uchun brend.
ascendingStandart qiymat: false
boolean
Yoʻq
Yuqorida ko'tarilish uchun haqiqiy, pastga tushish uchun yolg'on.
curl --request GET 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
GET
Barcha brendlarni ro'yxatga oling
/api/brand/all
Oʻqish imkoniyatiga ega token
Hisobdagi har bir brendni ismlari bo'yicha ajratish.
i
Katta direktoriyalar va takrorlanuvchi sinxronlashtirish uchun /find-dan sahifalashtirish bilan foydalaning.
curl --request GET 'https://api.selsup.ru/api/brand/all' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
GET
Kimlik belgisi bilan tanlang
/api/brand/{brandId}
Oʻqish imkoniyatiga ega token
Markani joriy hisobdan ichki identifikator bilan qaytaradi.
i
Joriy implementatsiya HTTP 404 o'rniga noma'lum brandId uchun bo'sh qiymatni qaytaradi. Bo'sh javobni boshqarish.
Yo'l parametrlari
Maydon
Tur
Majburiy
Tavsif
brandId
integer
Ha
SelSup-da marka identifikatori.
curl --request GET 'https://api.selsup.ru/api/brand/8124' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
POST
Brendi yaratish
/api/brand
Yozib olish imkoniyatiga ega token
Joriy hisobda brend yaratadi. Oddiy holat uchun nom yetarli.
i
Nomlar holatga nisbatan nisbatan nisbatan hissiy emas; Base va base bir xil brend sifatida ko'rib chiqiladi.
Talabnoma organi
application/json
Maydon
Tur
Majburiy
Tavsif
name
string
Ha
Noyob, bo'sh emas marka nomi.
ozonName
string
Yoʻq
Ozon direktoriyasidan nom, agar ma'lum bo'lsa.
ozonId
integer · int64
Yoʻq
Ozon marka identifikatori kartalar oldindan import qilinmasdan yuborilganda.
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
400error_empty_brand_name
Не указано название бренда
nom yo'q, bo'sh yoki faqat oq bo'lakni o'z ichiga oladi.
400error_brand_already_exists
{name} brendi allaqachon mavjud
Hisobotda allaqachon holatga nisbatan hissiy ziddiyat mavjud. params.name ziddiyatli nomni o'z ichiga oladi.
400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.
Xizmatdan foydalanish uchun tarif to'lash. error_subscription_expired-dan integratsiya mantiqasida foydalaning.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
PUT
Brendi yangilanishi
/api/brand/{brandId}
Yozib olish imkoniyatiga ega token
tahrirlanadigan brend maydonlarini almashtiradi. ID URL-dan keladi; JSON-da brandId yubormang.
i
Bu PUT, shuning uchun saqlab qolish uchun kerak bo'lgan barcha qiymatlarni kiriting. Logo maydonlari alohida oxirgi nuqtalar tomonidan boshqariladi.
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
400error_empty_brand_name
Не указано название бренда
nom yo'q, bo'sh yoki faqat oq bo'lakni o'z ichiga oladi.
400error_brand_already_exists
{name} brendi allaqachon mavjud
Hisobotda allaqachon holatga nisbatan hissiy ziddiyat mavjud. params.name ziddiyatli nomni o'z ichiga oladi.
400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.
Xizmatdan foydalanish uchun tarif to'lash. error_subscription_expired-dan integratsiya mantiqasida foydalaning.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
DELETE
Markani o'chirish, arxivlash yoki tiklash
/api/brand/{brandId}
Yozib olish imkoniyatiga ega token
SelSup-da "deleted=true" bilan qattiq o'chirishni urish. Agar ma'lumot mavjud bo'lsa, markani arxivga oladi. "delete=false" uni tiklaydi.
Yo'l parametrlari
Maydon
Tur
Majburiy
Tavsif
brandId
integer
Ha
Marka identifikatori.
Soʻrov parametrlari
Maydon
Tur
Majburiy
Tavsif
deleted
boolean
Ha
o'chirish yoki arxivlash uchun haqiqiy; tiklash uchun yolg'on.
Referentlar o'chirishni oldini oldi, shuning uchun marka arxivga olingan.
brand_has_been_restore
Markaz arxivdan tiklandi.
"brand_signed_as_deleted"
Xatolar3
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
POST
Logotipni yuklash
/api/brand/{brandId}/image
Yozib olish imkoniyatiga ega token
Rasmni multipart/form-data. sifatida yuklaydi Mavjud logotip o'rniga o'rnatiladi.
i
Ikkilamchi faylni faylga yuboring; bu oxirgi nuqta JSON-ni qabul qilmaydi.
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
400error_brand_to_found
{name} brendi topilmadi
brandId joriy hisobda mavjud emas. hujjat error kodini API tomonidan qaytarilganidek saqlaydi.
400error_wrong_image_format
Fayl uchun noto'g'ri rasm formati: {name}
Fayl qo'llab-quvvatlanadigan rasm formatida dekodlash mumkin emas.
400error_max_upload_size_exceeded
Допустимый размер файла превышен
Ko'p qismli talab server yuklash cheklovidan oshadi.
400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.
Xizmatdan foydalanish uchun tarif to'lash. error_subscription_expired-dan integratsiya mantiqasida foydalaning.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
DELETE
Logotipni oʻchirish
/api/brand/{brandId}/image
Yozib olish imkoniyatiga ega token
Logotip faylini o'chirib tashlaydi va uning o'lchamlarini marka rekordida qayta o'rnatadi.
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
400error_brand_to_found
{name} brendi topilmadi
brandId joriy hisobda mavjud emas. hujjat error kodini API tomonidan qaytarilganidek saqlaydi.
400error_empty_brand_logo
Brendda rasm yo‘q
Logotipsiz brend uchun logotipni o'chirish talab qilindi.
400error_cant_remove_brand_logo
Brend tasvirini o‘chirib bo‘lmaydi
Xamishxona faylni o'chirib tashlab yoki marka rekordini yangilab bo'lmadi.
400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.
Xizmatdan foydalanish uchun tarif to'lash. error_subscription_expired-dan integratsiya mantiqasida foydalaning.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
POST
Birlashtirish nusxalari
/api/brand/{brandId}/merge/{removeBrandId}
Yozib olish imkoniyatiga ega token
Mahsulot modellarini BrandId-ni olib tashlashdan BrandId -ga ko'chirish, so'ngra BrandIdni olib qo'yishni doimiy ravishda olib tashlaydi.
i
Bu bekor qilinmaydi. Brandid saqlanib qoladi; olib tashlash BrandId olib tashlanadigan nusxa hisoblanadi.
Yo'l parametrlari
Maydon
Tur
Majburiy
Tavsif
brandId
integer
Ha
Bosh marka identifikatori.
removeBrandId
integer
Ha
O'chirish uchun nusxali marka identifikatori.
curl --request POST 'https://api.selsup.ru/api/brand/8124/merge/9012' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
400error_brand_not_found
Brend topilmadi: {name}
Birlashtirishga talab qilingan brendlardan biri joriy hisobda mavjud emas.
400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.
Xizmatdan foydalanish uchun tarif to'lash. error_subscription_expired-dan integratsiya mantiqasida foydalaning.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.