SelSup Developers

Коомдук API · API Сүрөт

Калькулятор

Калькулятордун акыркы пункттары, анын ичинде так маршруттар, параметрлер, суроо-талап органдары жана кеңейтилген жооп схемалары.

2 чектөө пункттары/api/calculatorТуруктууМашина менен окулуучу сүрөттөмө ↗
{ }

Бул барак түзөтүлүүчү өз алдынча келишим менен камсыз кылынат.

/api/calculator

Колдонууга даяр жумуш жүрүштөрү

Колдонууга даяр жумуш жүрүштөрү

01

Калькуляторду колдонууну баштаңыз

API белгисин колдонуп, биринчиден тесттик маалыматтар менен окуу операцияларын тастыктаңыз.

  1. Токенди сервер тарапка сактап, Authorization башкыга жөнөт.
  2. Керектүү параметрлерди текшерип, суроо же жооп схемасын кеңейтүү.
  3. HTTP абалы жана error туруктуу талаасы колдонмо каталарында иштелип чыгышы керек.

Маалыматтын модели

Маалыматтар структурасы

Бул жерде моделдер бир жолу көрсөтүлгөн жана аларды колдонгон акыркы пункттардан түздөн-түз кеңейтилген.

UnitCalculator31 аймактар
purchasePricenumber · double

Сатып алуу баасы.

purchasePercentnumber · double

Сатып алуу пайызын.

widthinteger · int32

Кеңдиги.

heightinteger · int32

Бийиктиги.

depthinteger · int32

Тереңдик.

categoryIdinteger · int64

Категориялык ID.

servicestring

Кызмат.

salePricenumber · double

Сатуу баасы.

commissionnumber · double

Комиссия.

wildberriesFbsBaseCommissionnumber · double

"Уайлдберриз" ФБР базалык комиссиясы.

wildberriesFbsPlannedTransferHoursnumber · double

"Уайлдберриз" ФБСтин пландаштырылган трансфердик сааттары.

wildberriesFbsTransferNormHoursnumber · double

"Уайлдберриз" ФББ "Норм-Уор" которуусун жүргүзөт.

wildberriesFbsSpeedCoefficientnumber · double

Wildberries Fbs ылдамдык коэффициенти.

wildberriesFbsEffectiveCommissionnumber · double

Wildberries FBS натыйжалуу комиссиясы.

wildberriesFbsTransferHoursSourcestring

"Уайлдберриз" ФБС "Трансфердин сааттары"

wildberriesFbsSpeedCoefficientValidFromstring · date

Wildberries FBS ылдамдык коэффициенти күчүндө.

wildberriesFbsSpeedCoefficientSourcestring

Wildberries Fbs ылдамдык коэффициенти булагы.

logisticnumber · double

Логистикалык.

warehouseRationumber · double

Товардын салыштырмалуулугу.

logisticRationumber · double

Логистикалык көрсөткүч.

ktrnumber · double

КТР.

expensesnumber · double

Чыгымдар.

newPriceByRubnumber · double

Жаңы бааны жууп.

newPriceByMarginalitynumber · double

Жаңы баалар маргиналдык баалар боюнча.

desiredMarginPercentnumber · double

Каалаган маржиналдык пайыздык чен.

desiredProfitRubnumber · double

Каалаган пайданы жууп салуу.

profitnumber · double

Пайдалуу.

markUpnumber · double

- Белгилей кеткиле.

marginalitynumber · double

Ал эми чет элдик.

organizationIdinteger · int64

Уюмдун идентификатору.

taxRatenumber · double

Салыктык чен.

Келишимдин катасы

Колдонмо каталарын кантип кайтаруу керек

error коду ар бир жергиликтүү жерде бирдей, ал эми колдонуучуга багытталган билдирүүнү сервер которат. error айланасында тиркеме логикасын түзүп, localMessageди көрсөтүү үчүн гана колдонуңуз.

error

Интеграция логикасы үчүн туруктуу машина окуй турган код.

localMessage

API белги колдонуучусунун тилинде көрсөтүүгө даяр билдирүү.

params

Сервер тарабынан локалдаштырылган билдирүү шаблондоруна интерполяцияланган баалуулуктар.

localMessage API белгиси ээси болгон колдонуучунун lang талаасын колдонот. Документация тили жана Accept-Language башчысы аны өзгөртпөйт; колдонуучу тилди конфигурациялабаган учурда орусча колдонулат.

RUКолдонуучунун жергиликтүү жергилиги ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
KYКыргызча (ky)
{
  "error": "error_brand_already_exists",
  "localMessage": "Base бренди мурунтан эле бар",
  "params": {
    "name": "Base"
  }
}

Акыркы пункттар

Акыркы пункттар

GET

Пайда

/api/calculator/profit
Окуу мүмкүнчүлүгү бар белги

GET /api/calculator/profit. колдонуу менен пайда

Сурамжылоо параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
purchasePrice number · double Жок Сатып алуу баасы.
purchasePercent number · double Жок Сатып алуу пайызын.
width integer · int32 Жок Кеңдиги.
height integer · int32 Жок Бийиктиги.
depth integer · int32 Жок Тереңдик.
categoryId integer · int64 Жок Категориялык 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 Жок Кызмат.
salePrice number · double Жок Сатуу баасы.
commission number · double Жок Комиссия.
wildberriesFbsBaseCommission number · double Жок "Уайлдберриз" ФБР базалык комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жок "Уайлдберриз" ФБСтин пландаштырылган трансфердик сааттары.
wildberriesFbsTransferNormHours number · double Жок "Уайлдберриз" ФББ "Норм-Уор" которуусун жүргүзөт.
wildberriesFbsSpeedCoefficient number · double Жок Wildberries Fbs ылдамдык коэффициенти.
wildberriesFbsEffectiveCommission number · double Жок Wildberries FBS натыйжалуу комиссиясы.
wildberriesFbsTransferHoursSource string Жок "Уайлдберриз" ФБС "Трансфердин сааттары"
wildberriesFbsSpeedCoefficientValidFrom string · date Жок Wildberries FBS ылдамдык коэффициенти күчүндө.
wildberriesFbsSpeedCoefficientSource string Жок Wildberries Fbs ылдамдык коэффициенти булагы.
logistic number · double Жок Логистикалык.
warehouseRatio number · double Жок Товардын салыштырмалуулугу.
logisticRatio number · double Жок Логистикалык көрсөткүч.
ktr number · double Жок КТР.
expenses number · double Жок Чыгымдар.
newPriceByRub number · double Жок Жаңы бааны жууп.
newPriceByMarginality number · double Жок Жаңы баалар маргиналдык баалар боюнча.
desiredMarginPercent number · double Жок Каалаган маржиналдык пайыздык чен.
desiredProfitRub number · double Жок Каалаган пайданы жууп салуу.
profit number · double Жок Пайдалуу.
markUp number · double Жок - Белгилей кеткиле.
marginality number · double Жок Ал эми чет элдик.
organizationId integer · int64 Жок Уюмдун идентификатору.
taxRate number · double Жок Салыктык чен.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
Объекттердин талаалары UnitCalculator
ТалааТүрүМилдеттүүСүрөттөмө
purchasePrice number · double Жок Сатып алуу баасы.
purchasePercent number · double Жок Сатып алуу пайызын.
width integer · int32 Жок Кеңдиги.
height integer · int32 Жок Бийиктиги.
depth integer · int32 Жок Тереңдик.
categoryId integer · int64 Жок Категориялык 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 Жок Кызмат.
salePrice number · double Жок Сатуу баасы.
commission number · double Жок Комиссия.
wildberriesFbsBaseCommission number · double Жок "Уайлдберриз" ФБР базалык комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жок "Уайлдберриз" ФБСтин пландаштырылган трансфердик сааттары.
wildberriesFbsTransferNormHours number · double Жок "Уайлдберриз" ФББ "Норм-Уор" которуусун жүргүзөт.
wildberriesFbsSpeedCoefficient number · double Жок Wildberries Fbs ылдамдык коэффициенти.
wildberriesFbsEffectiveCommission number · double Жок Wildberries FBS натыйжалуу комиссиясы.
wildberriesFbsTransferHoursSource string Жок "Уайлдберриз" ФБС "Трансфердин сааттары"
wildberriesFbsSpeedCoefficientValidFrom string · date Жок Wildberries FBS ылдамдык коэффициенти күчүндө.
wildberriesFbsSpeedCoefficientSource string Жок Wildberries Fbs ылдамдык коэффициенти булагы.
logistic number · double Жок Логистикалык.
warehouseRatio number · double Жок Товардын салыштырмалуулугу.
logisticRatio number · double Жок Логистикалык көрсөткүч.
ktr number · double Жок КТР.
expenses number · double Жок Чыгымдар.
newPriceByRub number · double Жок Жаңы бааны жууп.
newPriceByMarginality number · double Жок Жаңы баалар маргиналдык баалар боюнча.
desiredMarginPercent number · double Жок Каалаган маржиналдык пайыздык чен.
desiredProfitRub number · double Жок Каалаган пайданы жууп салуу.
profit number · double Жок Пайдалуу.
markUp number · double Жок - Белгилей кеткиле.
marginality number · double Жок Ал эми чет элдик.
organizationId integer · int64 Жок Уюмдун идентификатору.
taxRate number · double Жок Салыктык чен.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Каталар12

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

400error_category_not_found
Категория табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_category_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_depth_not_found
Тереңдик көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_depth_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_height_not_found
Бийиктик көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_height_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_organization_not_found
Уюм табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_organization_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_purchase_percent_not_found
Сатып алуу пайызы көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_purchase_percent_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_sale_price_not_found
Сатуу баасы көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_sale_price_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_service_not_found
Маркетплейс тандалган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_service_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_width_not_found
Туурасы көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_width_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

GET

Баасы

/api/calculator/price
Окуу мүмкүнчүлүгү бар белги

GET /api/calculator/price. баасы

Сурамжылоо параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
purchasePrice number · double Жок Сатып алуу баасы.
purchasePercent number · double Жок Сатып алуу пайызын.
width integer · int32 Жок Кеңдиги.
height integer · int32 Жок Бийиктиги.
depth integer · int32 Жок Тереңдик.
categoryId integer · int64 Жок Категориялык 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 Жок Кызмат.
salePrice number · double Жок Сатуу баасы.
commission number · double Жок Комиссия.
wildberriesFbsBaseCommission number · double Жок "Уайлдберриз" ФБР базалык комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жок "Уайлдберриз" ФБСтин пландаштырылган трансфердик сааттары.
wildberriesFbsTransferNormHours number · double Жок "Уайлдберриз" ФББ "Норм-Уор" которуусун жүргүзөт.
wildberriesFbsSpeedCoefficient number · double Жок Wildberries Fbs ылдамдык коэффициенти.
wildberriesFbsEffectiveCommission number · double Жок Wildberries FBS натыйжалуу комиссиясы.
wildberriesFbsTransferHoursSource string Жок "Уайлдберриз" ФБС "Трансфердин сааттары"
wildberriesFbsSpeedCoefficientValidFrom string · date Жок Wildberries FBS ылдамдык коэффициенти күчүндө.
wildberriesFbsSpeedCoefficientSource string Жок Wildberries Fbs ылдамдык коэффициенти булагы.
logistic number · double Жок Логистикалык.
warehouseRatio number · double Жок Товардын салыштырмалуулугу.
logisticRatio number · double Жок Логистикалык көрсөткүч.
ktr number · double Жок КТР.
expenses number · double Жок Чыгымдар.
newPriceByRub number · double Жок Жаңы бааны жууп.
newPriceByMarginality number · double Жок Жаңы баалар маргиналдык баалар боюнча.
desiredMarginPercent number · double Жок Каалаган маржиналдык пайыздык чен.
desiredProfitRub number · double Жок Каалаган пайданы жууп салуу.
profit number · double Жок Пайдалуу.
markUp number · double Жок - Белгилей кеткиле.
marginality number · double Жок Ал эми чет элдик.
organizationId integer · int64 Жок Уюмдун идентификатору.
taxRate number · double Жок Салыктык чен.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
Объекттердин талаалары UnitCalculator
ТалааТүрүМилдеттүүСүрөттөмө
purchasePrice number · double Жок Сатып алуу баасы.
purchasePercent number · double Жок Сатып алуу пайызын.
width integer · int32 Жок Кеңдиги.
height integer · int32 Жок Бийиктиги.
depth integer · int32 Жок Тереңдик.
categoryId integer · int64 Жок Категориялык 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 Жок Кызмат.
salePrice number · double Жок Сатуу баасы.
commission number · double Жок Комиссия.
wildberriesFbsBaseCommission number · double Жок "Уайлдберриз" ФБР базалык комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жок "Уайлдберриз" ФБСтин пландаштырылган трансфердик сааттары.
wildberriesFbsTransferNormHours number · double Жок "Уайлдберриз" ФББ "Норм-Уор" которуусун жүргүзөт.
wildberriesFbsSpeedCoefficient number · double Жок Wildberries Fbs ылдамдык коэффициенти.
wildberriesFbsEffectiveCommission number · double Жок Wildberries FBS натыйжалуу комиссиясы.
wildberriesFbsTransferHoursSource string Жок "Уайлдберриз" ФБС "Трансфердин сааттары"
wildberriesFbsSpeedCoefficientValidFrom string · date Жок Wildberries FBS ылдамдык коэффициенти күчүндө.
wildberriesFbsSpeedCoefficientSource string Жок Wildberries Fbs ылдамдык коэффициенти булагы.
logistic number · double Жок Логистикалык.
warehouseRatio number · double Жок Товардын салыштырмалуулугу.
logisticRatio number · double Жок Логистикалык көрсөткүч.
ktr number · double Жок КТР.
expenses number · double Жок Чыгымдар.
newPriceByRub number · double Жок Жаңы бааны жууп.
newPriceByMarginality number · double Жок Жаңы баалар маргиналдык баалар боюнча.
desiredMarginPercent number · double Жок Каалаган маржиналдык пайыздык чен.
desiredProfitRub number · double Жок Каалаган пайданы жууп салуу.
profit number · double Жок Пайдалуу.
markUp number · double Жок - Белгилей кеткиле.
marginality number · double Жок Ал эми чет элдик.
organizationId integer · int64 Жок Уюмдун идентификатору.
taxRate number · double Жок Салыктык чен.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Каталар12

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

400error_category_not_found
Категория табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_category_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_depth_not_found
Тереңдик көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_depth_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_fill_purchase_price
Сатып алуу баасы жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_fill_purchase_price кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_height_not_found
Бийиктик көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_height_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_organization_not_found
Уюм табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_organization_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_purchase_percent_not_found
Сатып алуу пайызы көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_purchase_percent_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_service_not_found
Маркетплейс тандалган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_service_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_width_not_found
Туурасы көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_width_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

Authorization

Сынак өтүнүчтөрү үчүн белги

Токен бул браузердин локалдык сактагычында калат жана API.selsup.ru сайтына Authorization өтүнүч башкычасында гана жөнөтүлөт.

Байкап көрүү

Чыныгы өтүнүч параметрлери

API түздөн-түз жооп

SelSup жоопту көрүү үчүн өтүнүч жөнөтүү.