SelSup Developers

API · API Ma'lumotnoma

Mahsulot belgilari

Mahsulot belgilarining oxirgi nuqtalari, shu jumladan aniq yo'nalishlar, parametrlar, so'rov organlari va kengaytiriladigan javob sxemalari.

9 yakuniy nuqtalar/api/tagTurg'unMashina o'qiladigan tavsif ↗
{ }

Ushbu sahifani tahrirlash mumkin bo'lgan mustaqil shartnoma bilan ta'minlaydi. Ishlab chiqarishdan oldin sinov ma'lumotlari bilan yozish operatsiyalarini tasdiqlash.

/api/tag

Ishga tayyor ish oqimlari

Ishga tayyor ish oqimlari

01

Mahsulot belgilaridan foydalanish

API tokenidan foydalaning va avval o'qish operatsiyalarini sinov ma'lumotlari bilan tasdiqlash.

  1. Tokeni server tomoniga saqlang va Authorization boshliqida yuboring.
  2. Kerakli parametrlarni tekshiring va so'rov yoki javob sxemasini kengaytiring.
  3. HTTP holatini va error o'rniga dastur xatolarida ishlash.

Ma'lumotlar modeli

Ma'lumotlar tuzilmalari

Modellari bu yerda bir marta ro'yxatga olingan va ularni ishlatadigan oxirgi nuqtalardan to'g'ridan-to'gʻri kengaytirilishi mumkin.

ProductTag3 maydonlar
idinteger · int64

Id.

read-only
namestring

Ism.

Majburiy
clientIdinteger · int64

Mijozning identifikatori.

read-only
FindResponseProductTag1 maydonlar
rowsProductTag[]

Savatlar.

FindResponseProductTagInfo1 maydonlar
rowsProductTagInfo[]

Savatlar.

ProductTagInfo2 maydonlar
productIdinteger · int64

Mahsulot identifikatori.

productTagsProductTag[]

Mahsulot belgilari.

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"
  }
}
UZOʻzbekcha (uz)
{
  "error": "error_brand_already_exists",
  "localMessage": "Base brendi allaqachon mavjud",
  "params": {
    "name": "Base"
  }
}

Keyingi nuqtalar

Keyingi nuqtalar

PUT

Yangiliklar

/api/tag/{tagId}
Yozib olish imkoniyatiga ega token

PUT /api/tag/{tagId}. yordamida oʻrnatilgan

Yo'l parametrlari

MaydonTurMajburiyTavsif
tagId integer · int64 Ha Ishxatnoma.

Talabnoma organi

application/json
Ob'ekt maydonlariProductTag
MaydonTurMajburiyTavsif
id integer · int64 Yoʻq Id.
name string Ha Ism.
clientId integer · int64 Yoʻq Mijozning identifikatori.
curl --request PUT 'https://api.selsup.ru/api/tag/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}'

Muvaffaqiyatli javob

200
Ob'ekt maydonlari ProductTag
MaydonTurMajburiyTavsif
id integer · int64 Yoʻq Id.
name string Ha Ism.
clientId integer · int64 Yoʻq Mijozning identifikatori.
{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}
Xatolar7

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.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_id_and_name_required
Tagning id va nomi talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_id_and_name_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_id_required
Tag id talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_id_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_update_failed
id: {0} bo‘lgan tegni yangilab bo‘lmadi

Uchrashuvda error-dan foydalanish. error_tag_update_failed kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

DELETE

1- taʼrifni yangilash

/api/tag/{tagId}
Yozib olish imkoniyatiga ega token

DELETE /api/tag/{tagId}. yordamida 1 ta belgini yangilash

Yo'l parametrlari

MaydonTurMajburiyTavsif
tagId integer · int64 Ha Ishxatnoma.
curl --request DELETE 'https://api.selsup.ru/api/tag/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200

Javobning tanasi yo'q.

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.

PUT

Mahsulotga etiketani bogʻlash

/api/tag/product/{tagId}/{productId}
Yozib olish imkoniyatiga ega token

PUT /api/tag/product/{tagId}/{productId}. yordamida mahsulotga etiketani bogʻlash

Yo'l parametrlari

MaydonTurMajburiyTavsif
tagId integer · int64 Ha Ishxatnoma.
productId integer · int64 Ha Mahsulot identifikatori.
curl --request PUT 'https://api.selsup.ru/api/tag/product/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200

Javobning tanasi yo'q.

Xatolar6

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.

400error_duplicate_tag_association
Teg allaqachon mahsulotga bog‘langan

Uchrashuvda error-dan foydalanish. error_duplicate_tag_association kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_and_product_id_required
tag va mahsulot ID si talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_and_product_id_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

DELETE

Mahsulotga bogʻliq boʻlgan etiketani

/api/tag/product/{tagId}/{productId}
Yozib olish imkoniyatiga ega token

DELETE /api/tag/product/{tagId}/{productId}. yordamida mahsulotga bogʻlash

Yo'l parametrlari

MaydonTurMajburiyTavsif
tagId integer · int64 Ha Ishxatnoma.
productId integer · int64 Ha Mahsulot identifikatori.
curl --request DELETE 'https://api.selsup.ru/api/tag/product/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200

Javobning tanasi yo'q.

Xatolar5

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.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_and_model_id_required
Tag id va model id talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_and_model_id_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

PUT

Modellari bilan bogʻlash

/api/tag/model/{tagId}/{modelId}
Yozib olish imkoniyatiga ega token

PUT /api/tag/model/{tagId}/{modelId}. yordamida modelga bogʻlash

Yo'l parametrlari

MaydonTurMajburiyTavsif
tagId integer · int64 Ha Ishxatnoma.
modelId integer · int64 Ha Model ID.
curl --request PUT 'https://api.selsup.ru/api/tag/model/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200

Javobning tanasi yo'q.

Xatolar6

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.

400error_duplicate_tag_association
Teg allaqachon mahsulotga bog‘langan

Uchrashuvda error-dan foydalanish. error_duplicate_tag_association kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_and_model_id_required
Tag id va model id talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_and_model_id_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

DELETE

Modelga bogʻliq boʻlmagan belgi

/api/tag/model/{tagId}/{modelId}
Yozib olish imkoniyatiga ega token

DELETE /api/tag/model/{tagId}/{modelId}. yordamida modelga bogʻlash

Yo'l parametrlari

MaydonTurMajburiyTavsif
tagId integer · int64 Ha Ishxatnoma.
modelId integer · int64 Ha Model ID.
curl --request DELETE 'https://api.selsup.ru/api/tag/model/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200

Javobning tanasi yo'q.

Xatolar5

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.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_and_model_id_required
Tag id va model id talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_and_model_id_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

POST

Tugmalar birikmasini yaratish

/api/tag
Yozib olish imkoniyatiga ega token

POST /api/tag. yordamida belgi yaratish

Talabnoma organi

application/json
Ob'ekt maydonlariProductTag
MaydonTurMajburiyTavsif
id integer · int64 Yoʻq Id.
name string Ha Ism.
clientId integer · int64 Yoʻq Mijozning identifikatori.
curl --request POST 'https://api.selsup.ru/api/tag' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}'

Muvaffaqiyatli javob

200
Ob'ekt maydonlari ProductTag
MaydonTurMajburiyTavsif
id integer · int64 Yoʻq Id.
name string Ha Ism.
clientId integer · int64 Yoʻq Mijozning identifikatori.
{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}
Xatolar6

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.

400error_duplicate_tag_name
Bunday nomdagi teg allaqachon mavjud: {0}

Uchrashuvda error-dan foydalanish. error_duplicate_tag_name kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

400error_tag_name_required
Teg nomi talab qilinadi

Uchrashuvda error-dan foydalanish. error_tag_name_required kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

GET

Tugmalar birikmasini topish

/api/tag/find
Oʻqish imkoniyatiga ega token

GET /api/tag/find. yordamida belgilarni qidirish

Soʻrov parametrlari

MaydonTurMajburiyTavsif
query string Yoʻq Savol.
productId integer · int64 Yoʻq Mahsulot identifikatori.
limit integer · int32 Yoʻq Chegara.
page integer · int32 Yoʻq Sahifa.
count boolean Yoʻq Count.
sortBy stringID, NAME Yoʻq O'rnatilgan.
ascending boolean Yoʻq O'sish.
curl --request GET 'https://api.selsup.ru/api/tag/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200
Ob'ekt maydonlari FindResponseProductTag
MaydonTurMajburiyTavsif
rows ProductTag[] Yoʻq Savatlar.
Array elementining tuzilishi ProductTag
MaydonTurMajburiyTavsif
id integer · int64 Yoʻq Id.
name string Ha Ism.
clientId integer · int64 Yoʻq Mijozning identifikatori.
{
  "rows": "string"
}
Xatolar4

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.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

GET

Model belgilarini toping

/api/tag/find/{modelId}
Oʻqish imkoniyatiga ega token

GET /api/tag/find/{modelId}. yordamida Model belgilarini qidirish

Yo'l parametrlari

MaydonTurMajburiyTavsif
modelId integer · int64 Ha Model ID.
curl --request GET 'https://api.selsup.ru/api/tag/find/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200
Ob'ekt maydonlari FindResponseProductTagInfo
MaydonTurMajburiyTavsif
rows ProductTagInfo[] Yoʻq Savatlar.
Array elementining tuzilishi ProductTagInfo
MaydonTurMajburiyTavsif
productId integer · int64 Yoʻq Mahsulot identifikatori.
productTags ProductTag[] Yoʻq Mahsulot belgilari.
Array elementining tuzilishi ProductTag
MaydonTurMajburiyTavsif
id integer · int64 Yoʻq Id.
name string Ha Ism.
clientId integer · int64 Yoʻq Mijozning identifikatori.
{
  "rows": "string"
}
Xatolar4

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.

400error_no_client
Mijoz topilmadi yoki o'chirilgan. Qo'llab-quvvatlash xizmatiga yozing

Uchrashuvda error-dan foydalanish. error_no_client kodini qo'llash logikasida ishlating; localMessageda yuqorida ko'rsatilgan tarjima mavjud.

Authorization

Sinov talablari uchun belgisi

Token ushbu brauzerning localStorage-da qoladi va faqat api.selsup.ru nomli so'rovlarning Authorization boshliqida yuboriladi.

Sinab koʻrish

Haqiqiy talab parametrlari

API- ning jonli javoblari

SelSup javobini ko'rish uchun iltimos yuboring.