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

Wildberries ФББ базалық комиссиясы.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries FBS-тің жоспарланған трансферттік уақыты.

wildberriesFbsTransferNormHoursnumber · double

Wildberries FBS-тің Нормальдық сағаттарды ауыстыруы.

wildberriesFbsSpeedCoefficientnumber · double

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

wildberriesFbsEffectiveCommissionnumber · double

Wildberries FBS тиімді комиссиясы.

wildberriesFbsTransferHoursSourcestring

Wildberries FBS трансферттік сағат көзі.

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"
  }
}
KKҚазақша (kk)
{
  "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 Жоқ Wildberries ФББ базалық комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жоқ Wildberries FBS-тің жоспарланған трансферттік уақыты.
wildberriesFbsTransferNormHours number · double Жоқ Wildberries FBS-тің Нормальдық сағаттарды ауыстыруы.
wildberriesFbsSpeedCoefficient number · double Жоқ Wildberries Fbs жылдамдық коэффициенті.
wildberriesFbsEffectiveCommission number · double Жоқ Wildberries FBS тиімді комиссиясы.
wildberriesFbsTransferHoursSource string Жоқ Wildberries FBS трансферттік сағат көзі.
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 Жоқ Wildberries ФББ базалық комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жоқ Wildberries FBS-тің жоспарланған трансферттік уақыты.
wildberriesFbsTransferNormHours number · double Жоқ Wildberries FBS-тің Нормальдық сағаттарды ауыстыруы.
wildberriesFbsSpeedCoefficient number · double Жоқ Wildberries Fbs жылдамдық коэффициенті.
wildberriesFbsEffectiveCommission number · double Жоқ Wildberries FBS тиімді комиссиясы.
wildberriesFbsTransferHoursSource string Жоқ Wildberries FBS трансферттік сағат көзі.
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
Санат табылмады

Аяқ нүктесі error. Қолданба логикада error_category_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_depth_not_found
Тереңдік көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_depth_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_height_not_found
Биіктік көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_height_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_no_client
Клиент табылмады немесе жойылды. Қолдау қызметіне жазыңыз

Аяқ нүктесі error. Қолданба логикада error_no_client тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_organization_not_found
Ұйым табылмады

Аяқ нүктесі error. Қолданба логикада error_organization_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_purchase_percent_not_found
Сатып алу пайызы көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_purchase_percent_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

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

Аяқ нүктесі error. Қолданба логикада error_sale_price_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_service_not_found
Маркетплейс таңдалмаған

Аяқ нүктесі error. Қолданба логикада error_service_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_width_not_found
Ені көрсетілмеген

Аяқ нүктесі 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 Жоқ Wildberries ФББ базалық комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жоқ Wildberries FBS-тің жоспарланған трансферттік уақыты.
wildberriesFbsTransferNormHours number · double Жоқ Wildberries FBS-тің Нормальдық сағаттарды ауыстыруы.
wildberriesFbsSpeedCoefficient number · double Жоқ Wildberries Fbs жылдамдық коэффициенті.
wildberriesFbsEffectiveCommission number · double Жоқ Wildberries FBS тиімді комиссиясы.
wildberriesFbsTransferHoursSource string Жоқ Wildberries FBS трансферттік сағат көзі.
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 Жоқ Wildberries ФББ базалық комиссиясы.
wildberriesFbsPlannedTransferHours number · double Жоқ Wildberries FBS-тің жоспарланған трансферттік уақыты.
wildberriesFbsTransferNormHours number · double Жоқ Wildberries FBS-тің Нормальдық сағаттарды ауыстыруы.
wildberriesFbsSpeedCoefficient number · double Жоқ Wildberries Fbs жылдамдық коэффициенті.
wildberriesFbsEffectiveCommission number · double Жоқ Wildberries FBS тиімді комиссиясы.
wildberriesFbsTransferHoursSource string Жоқ Wildberries FBS трансферттік сағат көзі.
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
Санат табылмады

Аяқ нүктесі error. Қолданба логикада error_category_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_depth_not_found
Тереңдік көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_depth_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

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

Аяқ нүктесі error. Қолданба логикада error_fill_purchase_price тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_height_not_found
Биіктік көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_height_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_no_client
Клиент табылмады немесе жойылды. Қолдау қызметіне жазыңыз

Аяқ нүктесі error. Қолданба логикада error_no_client тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_organization_not_found
Ұйым табылмады

Аяқ нүктесі error. Қолданба логикада error_organization_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_purchase_percent_not_found
Сатып алу пайызы көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_purchase_percent_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_service_not_found
Маркетплейс таңдалмаған

Аяқ нүктесі error. Қолданба логикада error_service_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_width_not_found
Ені көрсетілмеген

Аяқ нүктесі error. Қолданба логикада error_width_not_found тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

Authorization

Сынақ өтiнiштерiне арналған белгі

Токен осы браузердің локальдық сақтауында қалады және api.selsup.ru-ға Authorization сұраныс басында ғана жіберіледі.

Байқап көру

Шын сұраныс параметрлері

Тікелей API жауап

SelSup жауапын көру үшін сұрау жіберу.