SelSup Developers

API · API Ma'lumotnoma

Hisoblovchi

Kalkulator uchun yakuniy nuqtalar, shu jumladan aniq yo'nalishlar, parametrlar, so'rov organlari va kengaytiriladigan javob sxemalari.

2 yakuniy nuqtalar/api/calculatorTurg'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/calculator

Ishga tayyor ish oqimlari

Ishga tayyor ish oqimlari

01

Hisoblovchidan 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.

UnitCalculator31 maydonlar
purchasePricenumber · double

Xarid narxi.

purchasePercentnumber · double

Xarid foizlari.

widthinteger · int32

Kenglik.

heightinteger · int32

Yuqorilik.

depthinteger · int32

chuqurlik.

categoryIdinteger · int64

Kategoriya ID.

servicestring

Xizmat.

salePricenumber · double

Savdo narxi.

commissionnumber · double

Komissiya.

wildberriesFbsBaseCommissionnumber · double

Wildberries FBI baza komissiyasi.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries FBSning transfer soatlari rejalashtirilgan.

wildberriesFbsTransferNormHoursnumber · double

Wildberries FBS normaviy soatlarni o'tkazadi.

wildberriesFbsSpeedCoefficientnumber · double

Wildberries Fbs tezlik koeffitsiyenti.

wildberriesFbsEffectiveCommissionnumber · double

Wildberries FBSning samarali komissiyasi.

wildberriesFbsTransferHoursSourcestring

Wildberries FBS o'tkazish soatlari manbai.

wildberriesFbsSpeedCoefficientValidFromstring · date

Wildberries FBS tezlik koeffitsiyenti haqiqiy.

wildberriesFbsSpeedCoefficientSourcestring

Wildberries Fbs tezlik koeffitsiyenti manbai.

logisticnumber · double

Logistika.

warehouseRationumber · double

Ombor nisbati.

logisticRationumber · double

Logistika nisbati.

ktrnumber · double

Ktr.

expensesnumber · double

Xarajatlar.

newPriceByRubnumber · double

Yangi narxni ko'tarish.

newPriceByMarginalitynumber · double

Yangi narx marginallik bo'yicha.

desiredMarginPercentnumber · double

Istilgan marjin foizlari.

desiredProfitRubnumber · double

Istagan foydalarni o'chirib tashlash.

profitnumber · double

Qimmatli.

markUpnumber · double

O'zingizni belgilab qo'ying.

marginalitynumber · double

Marjinallik.

organizationIdinteger · int64

Tashkilot identifikatori.

taxRatenumber · double

Soliq stavkalari.

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

GET

Qimmatli qog'ozlar

/api/calculator/profit
Oʻqish imkoniyatiga ega token

GET /api/calculator/profit.dan foydalangan holda foyda

Soʻrov parametrlari

MaydonTurMajburiyTavsif
purchasePrice number · double Yoʻq Xarid narxi.
purchasePercent number · double Yoʻq Xarid foizlari.
width integer · int32 Yoʻq Kenglik.
height integer · int32 Yoʻq Yuqorilik.
depth integer · int32 Yoʻq chuqurlik.
categoryId integer · int64 Yoʻq Kategoriya ID.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yoʻq Xizmat.
salePrice number · double Yoʻq Savdo narxi.
commission number · double Yoʻq Komissiya.
wildberriesFbsBaseCommission number · double Yoʻq Wildberries FBI baza komissiyasi.
wildberriesFbsPlannedTransferHours number · double Yoʻq Wildberries FBSning transfer soatlari rejalashtirilgan.
wildberriesFbsTransferNormHours number · double Yoʻq Wildberries FBS normaviy soatlarni o'tkazadi.
wildberriesFbsSpeedCoefficient number · double Yoʻq Wildberries Fbs tezlik koeffitsiyenti.
wildberriesFbsEffectiveCommission number · double Yoʻq Wildberries FBSning samarali komissiyasi.
wildberriesFbsTransferHoursSource string Yoʻq Wildberries FBS o'tkazish soatlari manbai.
wildberriesFbsSpeedCoefficientValidFrom string · date Yoʻq Wildberries FBS tezlik koeffitsiyenti haqiqiy.
wildberriesFbsSpeedCoefficientSource string Yoʻq Wildberries Fbs tezlik koeffitsiyenti manbai.
logistic number · double Yoʻq Logistika.
warehouseRatio number · double Yoʻq Ombor nisbati.
logisticRatio number · double Yoʻq Logistika nisbati.
ktr number · double Yoʻq Ktr.
expenses number · double Yoʻq Xarajatlar.
newPriceByRub number · double Yoʻq Yangi narxni ko'tarish.
newPriceByMarginality number · double Yoʻq Yangi narx marginallik bo'yicha.
desiredMarginPercent number · double Yoʻq Istilgan marjin foizlari.
desiredProfitRub number · double Yoʻq Istagan foydalarni o'chirib tashlash.
profit number · double Yoʻq Qimmatli.
markUp number · double Yoʻq O'zingizni belgilab qo'ying.
marginality number · double Yoʻq Marjinallik.
organizationId integer · int64 Yoʻq Tashkilot identifikatori.
taxRate number · double Yoʻq Soliq stavkalari.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200
Ob'ekt maydonlari UnitCalculator
MaydonTurMajburiyTavsif
purchasePrice number · double Yoʻq Xarid narxi.
purchasePercent number · double Yoʻq Xarid foizlari.
width integer · int32 Yoʻq Kenglik.
height integer · int32 Yoʻq Yuqorilik.
depth integer · int32 Yoʻq chuqurlik.
categoryId integer · int64 Yoʻq Kategoriya ID.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yoʻq Xizmat.
salePrice number · double Yoʻq Savdo narxi.
commission number · double Yoʻq Komissiya.
wildberriesFbsBaseCommission number · double Yoʻq Wildberries FBI baza komissiyasi.
wildberriesFbsPlannedTransferHours number · double Yoʻq Wildberries FBSning transfer soatlari rejalashtirilgan.
wildberriesFbsTransferNormHours number · double Yoʻq Wildberries FBS normaviy soatlarni o'tkazadi.
wildberriesFbsSpeedCoefficient number · double Yoʻq Wildberries Fbs tezlik koeffitsiyenti.
wildberriesFbsEffectiveCommission number · double Yoʻq Wildberries FBSning samarali komissiyasi.
wildberriesFbsTransferHoursSource string Yoʻq Wildberries FBS o'tkazish soatlari manbai.
wildberriesFbsSpeedCoefficientValidFrom string · date Yoʻq Wildberries FBS tezlik koeffitsiyenti haqiqiy.
wildberriesFbsSpeedCoefficientSource string Yoʻq Wildberries Fbs tezlik koeffitsiyenti manbai.
logistic number · double Yoʻq Logistika.
warehouseRatio number · double Yoʻq Ombor nisbati.
logisticRatio number · double Yoʻq Logistika nisbati.
ktr number · double Yoʻq Ktr.
expenses number · double Yoʻq Xarajatlar.
newPriceByRub number · double Yoʻq Yangi narxni ko'tarish.
newPriceByMarginality number · double Yoʻq Yangi narx marginallik bo'yicha.
desiredMarginPercent number · double Yoʻq Istilgan marjin foizlari.
desiredProfitRub number · double Yoʻq Istagan foydalarni o'chirib tashlash.
profit number · double Yoʻq Qimmatli.
markUp number · double Yoʻq O'zingizni belgilab qo'ying.
marginality number · double Yoʻq Marjinallik.
organizationId integer · int64 Yoʻq Tashkilot identifikatori.
taxRate number · double Yoʻq Soliq stavkalari.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Xatolar12

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_category_not_found
Kategoriya topilmadi

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

400error_depth_not_found
Chuqurlik ko‘rsatilmagan

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

400error_height_not_found
Не указана высота

Uchrashuvda error-dan foydalanish. error_height_not_found 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_organization_not_found
Tashkilot topilmadi

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

400error_purchase_percent_not_found
Sotib olish foizi ko'rsatilmagan

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

400error_sale_price_not_found
Sotish narxi ko'rsatilmagan

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

400error_service_not_found
Marketpleys tanlanmagan

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

400error_width_not_found
Kenglik ko‘rsatilmagan

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

GET

Narx

/api/calculator/price
Oʻqish imkoniyatiga ega token

GET /api/calculator/price. foydalangan holda narx

Soʻrov parametrlari

MaydonTurMajburiyTavsif
purchasePrice number · double Yoʻq Xarid narxi.
purchasePercent number · double Yoʻq Xarid foizlari.
width integer · int32 Yoʻq Kenglik.
height integer · int32 Yoʻq Yuqorilik.
depth integer · int32 Yoʻq chuqurlik.
categoryId integer · int64 Yoʻq Kategoriya ID.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yoʻq Xizmat.
salePrice number · double Yoʻq Savdo narxi.
commission number · double Yoʻq Komissiya.
wildberriesFbsBaseCommission number · double Yoʻq Wildberries FBI baza komissiyasi.
wildberriesFbsPlannedTransferHours number · double Yoʻq Wildberries FBSning transfer soatlari rejalashtirilgan.
wildberriesFbsTransferNormHours number · double Yoʻq Wildberries FBS normaviy soatlarni o'tkazadi.
wildberriesFbsSpeedCoefficient number · double Yoʻq Wildberries Fbs tezlik koeffitsiyenti.
wildberriesFbsEffectiveCommission number · double Yoʻq Wildberries FBSning samarali komissiyasi.
wildberriesFbsTransferHoursSource string Yoʻq Wildberries FBS o'tkazish soatlari manbai.
wildberriesFbsSpeedCoefficientValidFrom string · date Yoʻq Wildberries FBS tezlik koeffitsiyenti haqiqiy.
wildberriesFbsSpeedCoefficientSource string Yoʻq Wildberries Fbs tezlik koeffitsiyenti manbai.
logistic number · double Yoʻq Logistika.
warehouseRatio number · double Yoʻq Ombor nisbati.
logisticRatio number · double Yoʻq Logistika nisbati.
ktr number · double Yoʻq Ktr.
expenses number · double Yoʻq Xarajatlar.
newPriceByRub number · double Yoʻq Yangi narxni ko'tarish.
newPriceByMarginality number · double Yoʻq Yangi narx marginallik bo'yicha.
desiredMarginPercent number · double Yoʻq Istilgan marjin foizlari.
desiredProfitRub number · double Yoʻq Istagan foydalarni o'chirib tashlash.
profit number · double Yoʻq Qimmatli.
markUp number · double Yoʻq O'zingizni belgilab qo'ying.
marginality number · double Yoʻq Marjinallik.
organizationId integer · int64 Yoʻq Tashkilot identifikatori.
taxRate number · double Yoʻq Soliq stavkalari.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Muvaffaqiyatli javob

200
Ob'ekt maydonlari UnitCalculator
MaydonTurMajburiyTavsif
purchasePrice number · double Yoʻq Xarid narxi.
purchasePercent number · double Yoʻq Xarid foizlari.
width integer · int32 Yoʻq Kenglik.
height integer · int32 Yoʻq Yuqorilik.
depth integer · int32 Yoʻq chuqurlik.
categoryId integer · int64 Yoʻq Kategoriya ID.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yoʻq Xizmat.
salePrice number · double Yoʻq Savdo narxi.
commission number · double Yoʻq Komissiya.
wildberriesFbsBaseCommission number · double Yoʻq Wildberries FBI baza komissiyasi.
wildberriesFbsPlannedTransferHours number · double Yoʻq Wildberries FBSning transfer soatlari rejalashtirilgan.
wildberriesFbsTransferNormHours number · double Yoʻq Wildberries FBS normaviy soatlarni o'tkazadi.
wildberriesFbsSpeedCoefficient number · double Yoʻq Wildberries Fbs tezlik koeffitsiyenti.
wildberriesFbsEffectiveCommission number · double Yoʻq Wildberries FBSning samarali komissiyasi.
wildberriesFbsTransferHoursSource string Yoʻq Wildberries FBS o'tkazish soatlari manbai.
wildberriesFbsSpeedCoefficientValidFrom string · date Yoʻq Wildberries FBS tezlik koeffitsiyenti haqiqiy.
wildberriesFbsSpeedCoefficientSource string Yoʻq Wildberries Fbs tezlik koeffitsiyenti manbai.
logistic number · double Yoʻq Logistika.
warehouseRatio number · double Yoʻq Ombor nisbati.
logisticRatio number · double Yoʻq Logistika nisbati.
ktr number · double Yoʻq Ktr.
expenses number · double Yoʻq Xarajatlar.
newPriceByRub number · double Yoʻq Yangi narxni ko'tarish.
newPriceByMarginality number · double Yoʻq Yangi narx marginallik bo'yicha.
desiredMarginPercent number · double Yoʻq Istilgan marjin foizlari.
desiredProfitRub number · double Yoʻq Istagan foydalarni o'chirib tashlash.
profit number · double Yoʻq Qimmatli.
markUp number · double Yoʻq O'zingizni belgilab qo'ying.
marginality number · double Yoʻq Marjinallik.
organizationId integer · int64 Yoʻq Tashkilot identifikatori.
taxRate number · double Yoʻq Soliq stavkalari.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Xatolar12

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_category_not_found
Kategoriya topilmadi

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

400error_depth_not_found
Chuqurlik ko‘rsatilmagan

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

400error_fill_purchase_price
Sotib olish narxi yo'q

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

400error_height_not_found
Не указана высота

Uchrashuvda error-dan foydalanish. error_height_not_found 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_organization_not_found
Tashkilot topilmadi

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

400error_purchase_percent_not_found
Sotib olish foizi ko'rsatilmagan

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

400error_service_not_found
Marketpleys tanlanmagan

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

400error_width_not_found
Kenglik ko‘rsatilmagan

Uchrashuvda error-dan foydalanish. error_width_not_found 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.