SelSup Developers

API · API Đề xuất

Tham số

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

5 điểm cuối/api/paramThườ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/param

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 Parameters

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.

CacheStringOption0 trường
Measure8 trường
idinteger · int32

Id.

namestring

Tên.

nationalCatalogIdinteger · int64

Nữ chỉ số danh mục quốc gia.

wildberriesTypeIdinteger · int64

Wildberries Type ID.

aliexpressCategoryIdinteger · int64

Aliexpress Category ID.

unitsUnit[]

Đơn vị.

unitsMapobject

Bản đồ đơn vị.

measureIdinteger · int32

Đánh giá ID.

Option12 trường
idinteger · int64

Id.

namestring

Tên.

paramIdinteger · int64

- Đơn vị nhận dạng.

ozonIdinteger · int64

- Hình danh Ozon.

wildberriesIdinteger · int64

- Thẻ của Wildberries.

ymIdinteger · int64

- Tôi biết.

aliexpressIdinteger · int64

Aliexpress ID.

clientIdinteger · int64

- Đồ nhận khách hàng.

deletedboolean

- Quá xóa.

oneCIdstring

Một nhân viên.

dictionaryboolean

Từ điển.

optionIdOption

- Nhận dạng tùy chọn.

Param47 trường
namestring

Tên.

titlestring

Tiêu đề.

publishedboolean

Được xuất bản.

visibleboolean

Có thể thấy được.

serviceParamstring

Service Param.

servicestring

Dịch vụ.

useCategoryOptionboolean

Sử dụng tùy chọn Category.

valueTypestring

Tiểu giá trị.

displayTypestring

Tiểu hình hiển thị.

requiredboolean

- Phải.

multiValueAllowedboolean

Multi Value được phép.

maxValuesCountinteger · int32

Max Values Count.

useDictionaryboolean

Sử dụng từ điển.

descriptionstring

Mô tả.

groupNamestring

Tên nhóm.

groupIdstring

Nhóm nhận dạng.

ozonDictionaryIdinteger · int64

Ozon Dictionary ID

dictionaryIdinteger · int64

Từ điển ID.

measureIdinteger · int32

Đánh giá ID.

measureMeasure

Đánh giá.

defaultUnitUnit

Đơn vị mặc định.

ozonIdinteger · int64

- Hình danh Ozon.

wildberriesIdinteger · int64

- Thẻ của Wildberries.

ymIdinteger · int64

- Tôi biết.

lamodaIdstring

Lamoda ID.

nationalCatalogIdinteger · int64

Nữ chỉ số danh mục quốc gia.

categoryIdinteger · int64

Phân loại ID.

avitoIdsinteger[]

Avito IDs.

avitoOptionsXmlFileNamestring

Avito Options Xml Tên tệp.

clientIdinteger · int64

- Đồ nhận khách hàng.

createdDatestring · date-time

Ngày được tạo ra.

aliexpressIdinteger · int64

Aliexpress ID.

presetstring

Đặt trước.

dictionaryParamIdinteger · int64

Từ điển Param ID.

dictionaryKeystring

Từ điển Key.

levelstring

Tăng cấp.

gs1Classstring

Tầng Gs1.

useAllCategoriesboolean

Sử dụng tất cả các loại.

oneCIdstring

Một nhân viên.

optionsOption[]

Các lựa chọn.

optionsCacheCacheStringOption

Các tùy chọn Cache.

lastRefreshOptionsinteger · int64

Các tùy chọn mới nhất.

optionsCountinteger · int32

Các lựa chọn có giá trị.

isAnalyticboolean

Là nhà phân tích.

analyticOrderinteger · int32

Đơn vị phân tích.

marketplaceServicestring

Dịch vụ thị trường.

idinteger · int64

Id.

Unit3 trường
namestring

Tên.

measureIdinteger · int32

Đánh giá ID.

idinteger · int32

Id.

SuggestParam1 trường
numberstring

Số.

SuggestResponse3 trường
apiversioninteger · int32

Sự phản đối.

resultSuggestParam[]

Kết quả.

emptyboolean

Không có gì.

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

POST

Post Param

/api/param/
Tấm mã với quyền truy cập viết

Post Param sử dụng POST /api/param/.

Cơ quan yêu cầu

application/json
Các trường đối tượngParam
TrườngLoạiBắt buộcMô tả
name string Không Tên.
title string Không Tiêu đề.
published boolean Không Được xuất bản.
visible boolean Không Có thể thấy được.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY Không Service Param.
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ụ.
useCategoryOption boolean Không Sử dụng tùy chọn Category.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Không Tiểu giá trị.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Không Tiểu hình hiển thị.
required boolean Không - Phải.
multiValueAllowed boolean Không Multi Value được phép.
maxValuesCount integer · int32 Không Max Values Count.
useDictionary boolean Không Sử dụng từ điển.
description string Không Mô tả.
groupName string Không Tên nhóm.
groupId string Không Nhóm nhận dạng.
ozonDictionaryId integer · int64 Không Ozon Dictionary ID
dictionaryId integer · int64 Không Từ điển ID.
measureId integer · int32 Không Đánh giá ID.
measure Measure Không Đánh giá.
Các trường đối tượng Measure
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
wildberriesTypeId integer · int64 Không Wildberries Type ID.
aliexpressCategoryId integer · int64 Không Aliexpress Category ID.
units Unit[] Không Đơn vị.
Cấu trúc của mục array Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
unitsMap object Không Bản đồ đơn vị.
measureId integer · int32 Không Đánh giá ID.
defaultUnit Unit Không Đơn vị mặc định.
Các trường đối tượng Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
lamodaId string Không Lamoda ID.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
categoryId integer · int64 Không Phân loại ID.
avitoIds integer[] Không Avito IDs.
avitoOptionsXmlFileName string Không Avito Options Xml Tên tệp.
clientId integer · int64 Không - Đồ nhận khách hàng.
createdDate string · date-time Không Ngày được tạo ra.
aliexpressId integer · int64 Không Aliexpress ID.
preset string Không Đặt trước.
dictionaryParamId integer · int64 Không Từ điển Param ID.
dictionaryKey string Không Từ điển Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT Không Tăng cấp.
gs1Class stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Tầng Gs1.
useAllCategories boolean Không Sử dụng tất cả các loại.
oneCId string Không Một nhân viên.
options Option[] Không Các lựa chọn.
Cấu trúc của mục array Option
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
paramId integer · int64 Không - Đơn vị nhận dạng.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
aliexpressId integer · int64 Không Aliexpress ID.
clientId integer · int64 Không - Đồ nhận khách hàng.
deleted boolean Không - Quá xóa.
oneCId string Không Một nhân viên.
dictionary boolean Không Từ điển.
optionId Option Không - Nhận dạng tùy chọn.
optionsCache CacheStringOption Không Các tùy chọn Cache.
lastRefreshOptions integer · int64 Không Các tùy chọn mới nhất.
optionsCount integer · int32 Không Các lựa chọn có giá trị.
isAnalytic boolean Không Là nhà phân tích.
analyticOrder integer · int32 Không Đơn vị phân tích.
marketplaceService 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ụ thị trường.
id integer · int64 Không Id.
curl --request POST 'https://api.selsup.ru/api/param/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}'

Phản ứng thành công

200
Các trường đối tượng Param
TrườngLoạiBắt buộcMô tả
name string Không Tên.
title string Không Tiêu đề.
published boolean Không Được xuất bản.
visible boolean Không Có thể thấy được.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY Không Service Param.
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ụ.
useCategoryOption boolean Không Sử dụng tùy chọn Category.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Không Tiểu giá trị.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Không Tiểu hình hiển thị.
required boolean Không - Phải.
multiValueAllowed boolean Không Multi Value được phép.
maxValuesCount integer · int32 Không Max Values Count.
useDictionary boolean Không Sử dụng từ điển.
description string Không Mô tả.
groupName string Không Tên nhóm.
groupId string Không Nhóm nhận dạng.
ozonDictionaryId integer · int64 Không Ozon Dictionary ID
dictionaryId integer · int64 Không Từ điển ID.
measureId integer · int32 Không Đánh giá ID.
measure Measure Không Đánh giá.
Các trường đối tượng Measure
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
wildberriesTypeId integer · int64 Không Wildberries Type ID.
aliexpressCategoryId integer · int64 Không Aliexpress Category ID.
units Unit[] Không Đơn vị.
Cấu trúc của mục array Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
unitsMap object Không Bản đồ đơn vị.
measureId integer · int32 Không Đánh giá ID.
defaultUnit Unit Không Đơn vị mặc định.
Các trường đối tượng Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
lamodaId string Không Lamoda ID.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
categoryId integer · int64 Không Phân loại ID.
avitoIds integer[] Không Avito IDs.
avitoOptionsXmlFileName string Không Avito Options Xml Tên tệp.
clientId integer · int64 Không - Đồ nhận khách hàng.
createdDate string · date-time Không Ngày được tạo ra.
aliexpressId integer · int64 Không Aliexpress ID.
preset string Không Đặt trước.
dictionaryParamId integer · int64 Không Từ điển Param ID.
dictionaryKey string Không Từ điển Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT Không Tăng cấp.
gs1Class stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Tầng Gs1.
useAllCategories boolean Không Sử dụng tất cả các loại.
oneCId string Không Một nhân viên.
options Option[] Không Các lựa chọn.
Cấu trúc của mục array Option
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
paramId integer · int64 Không - Đơn vị nhận dạng.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
aliexpressId integer · int64 Không Aliexpress ID.
clientId integer · int64 Không - Đồ nhận khách hàng.
deleted boolean Không - Quá xóa.
oneCId string Không Một nhân viên.
dictionary boolean Không Từ điển.
optionId Option Không - Nhận dạng tùy chọn.
optionsCache CacheStringOption Không Các tùy chọn Cache.
lastRefreshOptions integer · int64 Không Các tùy chọn mới nhất.
optionsCount integer · int32 Không Các lựa chọn có giá trị.
isAnalytic boolean Không Là nhà phân tích.
analyticOrder integer · int32 Không Đơn vị phân tích.
marketplaceService 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ụ thị trường.
id integer · int64 Không Id.
{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}
Hầm lẫn8

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_param_empty_display_type
Chưa chỉ định loại

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

400error_param_empty_level
cấp độ tham số trống

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

400error_param_empty_name
Chưa chỉ định tên tham số

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

400error_param_empty_value_type
Chưa chỉ định loại giá trị tham số

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

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

GET

Param

/api/param/{id}
Tấm mã với truy cập đọc

Param sử dụng GET /api/param/{id}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
id integer · int64 Id.
curl --request GET 'https://api.selsup.ru/api/param/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng Param
TrườngLoạiBắt buộcMô tả
name string Không Tên.
title string Không Tiêu đề.
published boolean Không Được xuất bản.
visible boolean Không Có thể thấy được.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY Không Service Param.
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ụ.
useCategoryOption boolean Không Sử dụng tùy chọn Category.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Không Tiểu giá trị.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Không Tiểu hình hiển thị.
required boolean Không - Phải.
multiValueAllowed boolean Không Multi Value được phép.
maxValuesCount integer · int32 Không Max Values Count.
useDictionary boolean Không Sử dụng từ điển.
description string Không Mô tả.
groupName string Không Tên nhóm.
groupId string Không Nhóm nhận dạng.
ozonDictionaryId integer · int64 Không Ozon Dictionary ID
dictionaryId integer · int64 Không Từ điển ID.
measureId integer · int32 Không Đánh giá ID.
measure Measure Không Đánh giá.
Các trường đối tượng Measure
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
wildberriesTypeId integer · int64 Không Wildberries Type ID.
aliexpressCategoryId integer · int64 Không Aliexpress Category ID.
units Unit[] Không Đơn vị.
Cấu trúc của mục array Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
unitsMap object Không Bản đồ đơn vị.
measureId integer · int32 Không Đánh giá ID.
defaultUnit Unit Không Đơn vị mặc định.
Các trường đối tượng Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
lamodaId string Không Lamoda ID.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
categoryId integer · int64 Không Phân loại ID.
avitoIds integer[] Không Avito IDs.
avitoOptionsXmlFileName string Không Avito Options Xml Tên tệp.
clientId integer · int64 Không - Đồ nhận khách hàng.
createdDate string · date-time Không Ngày được tạo ra.
aliexpressId integer · int64 Không Aliexpress ID.
preset string Không Đặt trước.
dictionaryParamId integer · int64 Không Từ điển Param ID.
dictionaryKey string Không Từ điển Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT Không Tăng cấp.
gs1Class stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Tầng Gs1.
useAllCategories boolean Không Sử dụng tất cả các loại.
oneCId string Không Một nhân viên.
options Option[] Không Các lựa chọn.
Cấu trúc của mục array Option
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
paramId integer · int64 Không - Đơn vị nhận dạng.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
aliexpressId integer · int64 Không Aliexpress ID.
clientId integer · int64 Không - Đồ nhận khách hàng.
deleted boolean Không - Quá xóa.
oneCId string Không Một nhân viên.
dictionary boolean Không Từ điển.
optionId Option Không - Nhận dạng tùy chọn.
optionsCache CacheStringOption Không Các tùy chọn Cache.
lastRefreshOptions integer · int64 Không Các tùy chọn mới nhất.
optionsCount integer · int32 Không Các lựa chọn có giá trị.
isAnalytic boolean Không Là nhà phân tích.
analyticOrder integer · int32 Không Đơn vị phân tích.
marketplaceService 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ụ thị trường.
id integer · int64 Không Id.
{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}
Hầm lẫn5

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_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_not_found_param_by_id
không tìm thấy tham số theo ID

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

GET

Tìm được đề xuất của Param

/api/param/preset/{service}/{organizationId}/{preset}
Tấm mã với truy cập đọc

Nhận Param đề nghị cần sử dụng GET /api/param/preset/{service}/{organizationId}/{preset}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
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 Dịch vụ.
preset stringSUGGEST_REQUIRED Đặt trước.
organizationId integer · int64 Đơn vị tổ chức.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
attrId integer · int64 - Cảnh sát.
number string Số.
curl --request GET 'https://api.selsup.ru/api/param/preset/NONE/1001/SUGGEST_REQUIRED?attrId=1001&number=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng SuggestResponse
TrườngLoạiBắt buộcMô tả
apiversion integer · int32 Không Sự phản đối.
result SuggestParam[] Không Kết quả.
Cấu trúc của mục array SuggestParam
TrườngLoạiBắt buộcMô tả
number string Không Số.
empty boolean Không Không có gì.
{
  "apiversion": 1,
  "result": "string",
  "empty": false
}
Hầm lẫn8

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_no_integration_with_nc
Mã thông báo Danh mục quốc gia không nhận được

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

400error_service_did_not_find_any_results
Dịch vụ không tìm thấy kết quả nào cho tham số đã cho {number}.

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

400error_service_not_implemented
Dịch vụ chưa được triển khai

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

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

400error_token_expired_or_revoked
Mã thông báo API bị thu hồi hoặc nhập không chính xác

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

GET

Params

/api/param/find
Tấm mã với truy cập đọc

Các param sử dụng GET /api/param/find.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
wildberriesTypeId integer · int64 Không Wildberries Type ID.
wildberriesCategoryId integer · int64 Không Wildberries Category ID.
ozonCategoryId integer · int64 Không Hình dạng Ozon
ozonDescriptionCategoryId integer · int64 Không Mô tả Ozon Category ID.
aliexpressCategoryId integer · int64 Không Aliexpress Category ID.
lamodaCategoryId integer · int64 Không Lamoda Category ID.
kaspiCategoryId string Không Caspi Category ID.
avitoCategoryId integer · int64 Không Avito Category ID.
yandexMarketCategoryId integer · int64 Không Yandex Market Category ID.
categoryId integer · int32 Không Phân loại ID.
useAllCategories boolean Không Sử dụng tất cả các loại.
useCategoryOption boolean Không Sử dụng tùy chọn Category.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy string Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/param/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array Param[]
TrườngLoạiBắt buộcMô tả
name string Không Tên.
title string Không Tiêu đề.
published boolean Không Được xuất bản.
visible boolean Không Có thể thấy được.
serviceParam stringNAME, MODEL_NAME, MAIN_IMAGE_URL, TNVED, RICH_CONTENT, DESCRIPTION, TNVED_GROUP, MATERIALS, GENDER, IMAGES, BRAND, PACK_WEIGHT_GR, PACK_WEIGHT_KG, MADE_IN_COUNTRY, MARKING, WILDBERRIES_ARTICLE, WILDBERRIES_COLOR, WILDBERRIES_SIZE, REAL_SIZE, PACK_WIDTH, PACK_HEIGHT, PACK_DEPTH, PACK_LENGTH, MANUFACTURER, MEASURES, DOCUMENT_LINK, DOCUMENT_NAME, KEYWORDS, SEASON, ARTICLE, COLOR, SIZE, MATERIALS_WB, LAUNDRY Không Service Param.
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ụ.
useCategoryOption boolean Không Sử dụng tùy chọn Category.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Không Tiểu giá trị.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Không Tiểu hình hiển thị.
required boolean Không - Phải.
multiValueAllowed boolean Không Multi Value được phép.
maxValuesCount integer · int32 Không Max Values Count.
useDictionary boolean Không Sử dụng từ điển.
description string Không Mô tả.
groupName string Không Tên nhóm.
groupId string Không Nhóm nhận dạng.
ozonDictionaryId integer · int64 Không Ozon Dictionary ID
dictionaryId integer · int64 Không Từ điển ID.
measureId integer · int32 Không Đánh giá ID.
measure Measure Không Đánh giá.
Các trường đối tượng Measure
TrườngLoạiBắt buộcMô tả
id integer · int32 Không Id.
name string Không Tên.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
wildberriesTypeId integer · int64 Không Wildberries Type ID.
aliexpressCategoryId integer · int64 Không Aliexpress Category ID.
units Unit[] Không Đơn vị.
Cấu trúc của mục array Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
unitsMap object Không Bản đồ đơn vị.
measureId integer · int32 Không Đánh giá ID.
defaultUnit Unit Không Đơn vị mặc định.
Các trường đối tượng Unit
TrườngLoạiBắt buộcMô tả
name string Không Tên.
measureId integer · int32 Không Đánh giá ID.
id integer · int32 Không Id.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
lamodaId string Không Lamoda ID.
nationalCatalogId integer · int64 Không Nữ chỉ số danh mục quốc gia.
categoryId integer · int64 Không Phân loại ID.
avitoIds integer[] Không Avito IDs.
avitoOptionsXmlFileName string Không Avito Options Xml Tên tệp.
clientId integer · int64 Không - Đồ nhận khách hàng.
createdDate string · date-time Không Ngày được tạo ra.
aliexpressId integer · int64 Không Aliexpress ID.
preset string Không Đặt trước.
dictionaryParamId integer · int64 Không Từ điển Param ID.
dictionaryKey string Không Từ điển Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT Không Tăng cấp.
gs1Class stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Không Tầng Gs1.
useAllCategories boolean Không Sử dụng tất cả các loại.
oneCId string Không Một nhân viên.
options Option[] Không Các lựa chọn.
Cấu trúc của mục array Option
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
paramId integer · int64 Không - Đơn vị nhận dạng.
ozonId integer · int64 Không - Hình danh Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
ymId integer · int64 Không - Tôi biết.
aliexpressId integer · int64 Không Aliexpress ID.
clientId integer · int64 Không - Đồ nhận khách hàng.
deleted boolean Không - Quá xóa.
oneCId string Không Một nhân viên.
dictionary boolean Không Từ điển.
optionId Option Không - Nhận dạng tùy chọn.
optionsCache CacheStringOption Không Các tùy chọn Cache.
lastRefreshOptions integer · int64 Không Các tùy chọn mới nhất.
optionsCount integer · int32 Không Các lựa chọn có giá trị.
isAnalytic boolean Không Là nhà phân tích.
analyticOrder integer · int32 Không Đơn vị phân tích.
marketplaceService 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ụ thị trường.
id integer · int64 Không Id.
[
  "string"
]
Hầm lẫn3

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.

DELETE

Xóa Param

/api/param/{paramId}
Tấm mã với quyền truy cập viết

Xóa Param bằng cách sử dụng DELETE /api/param/{paramId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
paramId integer · int64 - Đơn vị nhận dạng.
curl --request DELETE 'https://api.selsup.ru/api/param/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
"string"
Hầm lẫn6

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_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_remove_param
Không thể xóa cài đặt

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổ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.