SelSup Developers

API · API Đề xuất

Máy tính

Các điểm cuối cho máy tính, bao gồm các tuyến đường chính xác, các tham số, các cơ quan yêu cầu và các chương trình phản hồi có thể mở rộng.

2 điểm cuối/api/calculatorThường ổn địnhMô tả có thể đọc được bằng máy ↗
{ }

Trang này được hỗ trợ bởi một hợp đồng độc lập có thể chỉnh sửa. Thiết lập các hoạt động viết bằng dữ liệu thử nghiệm trước khi sử dụng sản xuất.

/api/calculator

Các dòng công việc sẵn sàng sử dụng

Các dòng công việc sẵn sàng sử dụng

01

Bắt đầu sử dụng máy tính

Sử dụng mã thông báo API chuyên dụng và xác nhận các hoạt động đọc bằng dữ liệu thử nghiệm trước.

  1. Giữ token bên máy chủ và gửi nó trong tiêu đề Authorization.
  2. Kiểm tra các tham số cần thiết và mở rộng quy trình yêu cầu hoặc phản hồi.
  3. xử lý trạng thái HTTP và trường error ổn định trong lỗi ứng dụng.

Mô hình dữ liệu

Các cấu trúc dữ liệu

Các mô hình được liệt kê một lần ở đây và cũng có thể được mở rộng trực tiếp từ các điểm cuối sử dụng chúng.

UnitCalculator31 trường
purchasePricenumber · double

Giá mua.

purchasePercentnumber · double

% mua hàng.

widthinteger · int32

Lớn.

heightinteger · int32

Tốc độ.

depthinteger · int32

Đâu sâu.

categoryIdinteger · int64

Phân loại ID.

servicestring

Dịch vụ.

salePricenumber · double

Giá bán.

commissionnumber · double

Ủy ban.

wildberriesFbsBaseCommissionnumber · double

Ủy ban cơ sở FBI Wildberries.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries FBS đã lên kế hoạch chuyển nhượng giờ.

wildberriesFbsTransferNormHoursnumber · double

Wildberries Fbs chuyển đổi giờ chuẩn.

wildberriesFbsSpeedCoefficientnumber · double

Wildberries Fbs Speed Coefficient.

wildberriesFbsEffectiveCommissionnumber · double

Ủy ban hiệu quả của Wildberries FBS.

wildberriesFbsTransferHoursSourcestring

Wildberries Fbs chuyển đổi giờ nguồn.

wildberriesFbsSpeedCoefficientValidFromstring · date

Wildberries Fbs Speed Coefficient Valid từ

wildberriesFbsSpeedCoefficientSourcestring

Nguồn số lượng tốc độ Fbs của Wildberries.

logisticnumber · double

Logistic.

warehouseRationumber · double

Tỷ lệ kho.

logisticRationumber · double

Tỷ lệ logistics.

ktrnumber · double

Ktr.

expensesnumber · double

Chi phí.

newPriceByRubnumber · double

Giá mới của Rub.

newPriceByMarginalitynumber · double

Giá mới theo mức marginal.

desiredMarginPercentnumber · double

% lợi nhuận được mong muốn.

desiredProfitRubnumber · double

Tháo lợi nhuận mong muốn.

profitnumber · double

Lợi nhuận.

markUpnumber · double

Đánh dấu lên.

marginalitynumber · double

Sự ngã ngã.

organizationIdinteger · int64

Đơn vị tổ chức.

taxRatenumber · double

Tỷ lệ thuế.

Hợp đồng lỗi

Cách trả lại lỗi ứng dụng

Mã error giống nhau ở mọi địa điểm, trong khi thông điệp đối diện người dùng được dịch bởi máy chủ. Xây dựng logic ứng dụng xung quanh error và sử dụng localMessage chỉ cho hiển thị.

error

Mã máy tính có thể đọc ổn định cho logic tích hợp.

localMessage

Thông điệp sẵn sàng hiển thị trong ngôn ngữ của người dùng mã thông báo API.

params

Các giá trị được máy chủ liên kết vào mẫu tin nhắn địa phương.

localMessage sử dụng trường lang của người dùng sở hữu mã thông báo API. Ngôn ngữ tài liệu và tiêu đề Accept-Language không thay đổi nó; tiếng Nga được sử dụng khi người dùng không có ngôn ngữ được cấu hình.

RUUser locale là ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
VNTiếng Việt (vn)
{
  "error": "error_brand_already_exists",
  "localMessage": "Thương hiệu Base đã tồn tại",
  "params": {
    "name": "Base"
  }
}

Điểm cuối

Điểm cuối

GET

Lợi nhuận

/api/calculator/profit
Tấm mã với truy cập đọc

Lợi nhuận sử dụng GET /api/calculator/profit.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
purchasePrice number · double Không Giá mua.
purchasePercent number · double Không % mua hàng.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
categoryId integer · int64 Không Phân loại 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 Không Dịch vụ.
salePrice number · double Không Giá bán.
commission number · double Không Ủy ban.
wildberriesFbsBaseCommission number · double Không Ủy ban cơ sở FBI Wildberries.
wildberriesFbsPlannedTransferHours number · double Không Wildberries FBS đã lên kế hoạch chuyển nhượng giờ.
wildberriesFbsTransferNormHours number · double Không Wildberries Fbs chuyển đổi giờ chuẩn.
wildberriesFbsSpeedCoefficient number · double Không Wildberries Fbs Speed Coefficient.
wildberriesFbsEffectiveCommission number · double Không Ủy ban hiệu quả của Wildberries FBS.
wildberriesFbsTransferHoursSource string Không Wildberries Fbs chuyển đổi giờ nguồn.
wildberriesFbsSpeedCoefficientValidFrom string · date Không Wildberries Fbs Speed Coefficient Valid từ
wildberriesFbsSpeedCoefficientSource string Không Nguồn số lượng tốc độ Fbs của Wildberries.
logistic number · double Không Logistic.
warehouseRatio number · double Không Tỷ lệ kho.
logisticRatio number · double Không Tỷ lệ logistics.
ktr number · double Không Ktr.
expenses number · double Không Chi phí.
newPriceByRub number · double Không Giá mới của Rub.
newPriceByMarginality number · double Không Giá mới theo mức marginal.
desiredMarginPercent number · double Không % lợi nhuận được mong muốn.
desiredProfitRub number · double Không Tháo lợi nhuận mong muốn.
profit number · double Không Lợi nhuận.
markUp number · double Không Đánh dấu lên.
marginality number · double Không Sự ngã ngã.
organizationId integer · int64 Không Đơn vị tổ chức.
taxRate number · double Không Tỷ lệ thuế.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng UnitCalculator
TrườngLoạiBắt buộcMô tả
purchasePrice number · double Không Giá mua.
purchasePercent number · double Không % mua hàng.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
categoryId integer · int64 Không Phân loại 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 Không Dịch vụ.
salePrice number · double Không Giá bán.
commission number · double Không Ủy ban.
wildberriesFbsBaseCommission number · double Không Ủy ban cơ sở FBI Wildberries.
wildberriesFbsPlannedTransferHours number · double Không Wildberries FBS đã lên kế hoạch chuyển nhượng giờ.
wildberriesFbsTransferNormHours number · double Không Wildberries Fbs chuyển đổi giờ chuẩn.
wildberriesFbsSpeedCoefficient number · double Không Wildberries Fbs Speed Coefficient.
wildberriesFbsEffectiveCommission number · double Không Ủy ban hiệu quả của Wildberries FBS.
wildberriesFbsTransferHoursSource string Không Wildberries Fbs chuyển đổi giờ nguồn.
wildberriesFbsSpeedCoefficientValidFrom string · date Không Wildberries Fbs Speed Coefficient Valid từ
wildberriesFbsSpeedCoefficientSource string Không Nguồn số lượng tốc độ Fbs của Wildberries.
logistic number · double Không Logistic.
warehouseRatio number · double Không Tỷ lệ kho.
logisticRatio number · double Không Tỷ lệ logistics.
ktr number · double Không Ktr.
expenses number · double Không Chi phí.
newPriceByRub number · double Không Giá mới của Rub.
newPriceByMarginality number · double Không Giá mới theo mức marginal.
desiredMarginPercent number · double Không % lợi nhuận được mong muốn.
desiredProfitRub number · double Không Tháo lợi nhuận mong muốn.
profit number · double Không Lợi nhuận.
markUp number · double Không Đánh dấu lên.
marginality number · double Không Sự ngã ngã.
organizationId integer · int64 Không Đơn vị tổ chức.
taxRate number · double Không Tỷ lệ thuế.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Hầm lẫn12

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_category_not_found
Không tìm thấy danh mục

error cụ thể cho điểm cuối. Sử dụng mã error_category_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_depth_not_found
Не указана глубина

error cụ thể cho điểm cuối. Sử dụng mã error_depth_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

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

error cụ thể cho điểm cuối. Sử dụng mã error_height_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_purchase_percent_not_found
Не указан процент выкупа

error cụ thể cho điểm cuối. Sử dụng mã error_purchase_percent_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_sale_price_not_found
Chưa chỉ định giá bán

error cụ thể cho điểm cuối. Sử dụng mã error_sale_price_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_service_not_found
Marketplace không được chọn

error cụ thể cho điểm cuối. Sử dụng mã error_service_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_width_not_found
Не указана ширина

error cụ thể cho điểm cuối. Sử dụng mã error_width_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Giá

/api/calculator/price
Tấm mã với truy cập đọc

Giá sử dụng GET /api/calculator/price.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
purchasePrice number · double Không Giá mua.
purchasePercent number · double Không % mua hàng.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
categoryId integer · int64 Không Phân loại 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 Không Dịch vụ.
salePrice number · double Không Giá bán.
commission number · double Không Ủy ban.
wildberriesFbsBaseCommission number · double Không Ủy ban cơ sở FBI Wildberries.
wildberriesFbsPlannedTransferHours number · double Không Wildberries FBS đã lên kế hoạch chuyển nhượng giờ.
wildberriesFbsTransferNormHours number · double Không Wildberries Fbs chuyển đổi giờ chuẩn.
wildberriesFbsSpeedCoefficient number · double Không Wildberries Fbs Speed Coefficient.
wildberriesFbsEffectiveCommission number · double Không Ủy ban hiệu quả của Wildberries FBS.
wildberriesFbsTransferHoursSource string Không Wildberries Fbs chuyển đổi giờ nguồn.
wildberriesFbsSpeedCoefficientValidFrom string · date Không Wildberries Fbs Speed Coefficient Valid từ
wildberriesFbsSpeedCoefficientSource string Không Nguồn số lượng tốc độ Fbs của Wildberries.
logistic number · double Không Logistic.
warehouseRatio number · double Không Tỷ lệ kho.
logisticRatio number · double Không Tỷ lệ logistics.
ktr number · double Không Ktr.
expenses number · double Không Chi phí.
newPriceByRub number · double Không Giá mới của Rub.
newPriceByMarginality number · double Không Giá mới theo mức marginal.
desiredMarginPercent number · double Không % lợi nhuận được mong muốn.
desiredProfitRub number · double Không Tháo lợi nhuận mong muốn.
profit number · double Không Lợi nhuận.
markUp number · double Không Đánh dấu lên.
marginality number · double Không Sự ngã ngã.
organizationId integer · int64 Không Đơn vị tổ chức.
taxRate number · double Không Tỷ lệ thuế.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng UnitCalculator
TrườngLoạiBắt buộcMô tả
purchasePrice number · double Không Giá mua.
purchasePercent number · double Không % mua hàng.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
categoryId integer · int64 Không Phân loại 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 Không Dịch vụ.
salePrice number · double Không Giá bán.
commission number · double Không Ủy ban.
wildberriesFbsBaseCommission number · double Không Ủy ban cơ sở FBI Wildberries.
wildberriesFbsPlannedTransferHours number · double Không Wildberries FBS đã lên kế hoạch chuyển nhượng giờ.
wildberriesFbsTransferNormHours number · double Không Wildberries Fbs chuyển đổi giờ chuẩn.
wildberriesFbsSpeedCoefficient number · double Không Wildberries Fbs Speed Coefficient.
wildberriesFbsEffectiveCommission number · double Không Ủy ban hiệu quả của Wildberries FBS.
wildberriesFbsTransferHoursSource string Không Wildberries Fbs chuyển đổi giờ nguồn.
wildberriesFbsSpeedCoefficientValidFrom string · date Không Wildberries Fbs Speed Coefficient Valid từ
wildberriesFbsSpeedCoefficientSource string Không Nguồn số lượng tốc độ Fbs của Wildberries.
logistic number · double Không Logistic.
warehouseRatio number · double Không Tỷ lệ kho.
logisticRatio number · double Không Tỷ lệ logistics.
ktr number · double Không Ktr.
expenses number · double Không Chi phí.
newPriceByRub number · double Không Giá mới của Rub.
newPriceByMarginality number · double Không Giá mới theo mức marginal.
desiredMarginPercent number · double Không % lợi nhuận được mong muốn.
desiredProfitRub number · double Không Tháo lợi nhuận mong muốn.
profit number · double Không Lợi nhuận.
markUp number · double Không Đánh dấu lên.
marginality number · double Không Sự ngã ngã.
organizationId integer · int64 Không Đơn vị tổ chức.
taxRate number · double Không Tỷ lệ thuế.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Hầm lẫn12

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_category_not_found
Không tìm thấy danh mục

error cụ thể cho điểm cuối. Sử dụng mã error_category_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_depth_not_found
Не указана глубина

error cụ thể cho điểm cuối. Sử dụng mã error_depth_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_fill_purchase_price
Нет закупочной цены

error cụ thể cho điểm cuối. Sử dụng mã error_fill_purchase_price ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

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

error cụ thể cho điểm cuối. Sử dụng mã error_height_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_purchase_percent_not_found
Не указан процент выкупа

error cụ thể cho điểm cuối. Sử dụng mã error_purchase_percent_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_service_not_found
Marketplace không được chọn

error cụ thể cho điểm cuối. Sử dụng mã error_service_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_width_not_found
Не указана ширина

error cụ thể cho điểm cuối. Sử dụng mã error_width_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

Authorization

Tỷ hiệu cho các yêu cầu thử nghiệm

Các token vẫn ở trong localStorage của trình duyệt này và chỉ được gửi trong tiêu đề Authorization của các yêu cầu đến api.selsup.ru.

Thử

Các tham số yêu cầu thực

Đáp lại API trực tiếp

Gửi yêu cầu để xem phản ứng SelSup.