Models are listed once here and can also be expanded directly from the endpoints that use them.
CacheStringOption0 fields
Measure8 fields
idinteger · int32
Id.
namestring
Name.
nationalCatalogIdinteger · int64
National Catalog Id.
wildberriesTypeIdinteger · int64
Wildberries Type Id.
aliexpressCategoryIdinteger · int64
Aliexpress Category Id.
unitsUnit[]
Units.
unitsMapobject
Units Map.
measureIdinteger · int32
Measure Id.
Option12 fields
idinteger · int64
Id.
namestring
Name.
paramIdinteger · int64
Param Id.
ozonIdinteger · int64
Ozon Id.
wildberriesIdinteger · int64
Wildberries Id.
ymIdinteger · int64
Ym Id.
aliexpressIdinteger · int64
Aliexpress Id.
clientIdinteger · int64
Client Id.
deletedboolean
Deleted.
oneCIdstring
One CId.
dictionaryboolean
Dictionary.
optionIdOption
Option Id.
Param47 fields
namestring
Name.
titlestring
Title.
publishedboolean
Published.
visibleboolean
Visible.
serviceParamstring
Service Param.
servicestring
Service.
useCategoryOptionboolean
Use Category Option.
valueTypestring
Value Type.
displayTypestring
Display Type.
requiredboolean
Required.
multiValueAllowedboolean
Multi Value Allowed.
maxValuesCountinteger · int32
Max Values Count.
useDictionaryboolean
Use Dictionary.
descriptionstring
Description.
groupNamestring
Group Name.
groupIdstring
Group Id.
ozonDictionaryIdinteger · int64
Ozon Dictionary Id.
dictionaryIdinteger · int64
Dictionary Id.
measureIdinteger · int32
Measure Id.
measureMeasure
Measure.
defaultUnitUnit
Default Unit.
ozonIdinteger · int64
Ozon Id.
wildberriesIdinteger · int64
Wildberries Id.
ymIdinteger · int64
Ym Id.
lamodaIdstring
Lamoda Id.
nationalCatalogIdinteger · int64
National Catalog Id.
categoryIdinteger · int64
Category Id.
avitoIdsinteger[]
Avito Ids.
avitoOptionsXmlFileNamestring
Avito Options Xml File Name.
clientIdinteger · int64
Client Id.
createdDatestring · date-time
Created Date.
aliexpressIdinteger · int64
Aliexpress Id.
presetstring
Preset.
dictionaryParamIdinteger · int64
Dictionary Param Id.
dictionaryKeystring
Dictionary Key.
levelstring
Level.
gs1Classstring
Gs1 Class.
useAllCategoriesboolean
Use All Categories.
oneCIdstring
One CId.
optionsOption[]
Options.
optionsCacheCacheStringOption
Options Cache.
lastRefreshOptionsinteger · int64
Last Refresh Options.
optionsCountinteger · int32
Options Count.
isAnalyticboolean
Is Analytic.
analyticOrderinteger · int32
Analytic Order.
marketplaceServicestring
Marketplace Service.
idinteger · int64
Id.
Unit3 fields
namestring
Name.
measureIdinteger · int32
Measure Id.
idinteger · int32
Id.
SuggestParam1 fields
numberstring
Number.
SuggestResponse3 fields
apiversioninteger · int32
Apiversion.
resultSuggestParam[]
Result.
emptyboolean
Empty.
Error contract
How application errors are returned
The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.
error
Stable machine-readable code for integration logic.
localMessage
Display-ready message in the API token user's language.
params
Values interpolated by the server into the localized message template.
文
localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.
RUUser locale is ru
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}
Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑
401auth_required
Authentication required
Authorization is missing, empty, or contains an invalid token.
400error_access_denied
Insufficient permissions
The token exists, but its role cannot perform this operation.
500error_unknown
Unexpected error
Internal failure. Save the request time and contact support; do not blindly retry a mutation.
400error_param_empty_display_type
Type not specified
Endpoint-specific error. Use the stable error_param_empty_display_type code in application logic; localMessage contains the translation shown above.
400error_param_empty_level
parameter level is empty
Endpoint-specific error. Use the stable error_param_empty_level code in application logic; localMessage contains the translation shown above.
400error_param_empty_name
Parameter name not specified
Endpoint-specific error. Use the stable error_param_empty_name code in application logic; localMessage contains the translation shown above.
400error_param_empty_value_type
Parameter value type not specified
Endpoint-specific error. Use the stable error_param_empty_value_type code in application logic; localMessage contains the translation shown above.
400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.
Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.
GET
Param
/api/param/{id}
Token with read access
Param using GET /api/param/{id}.
Path parameters
Field
Type
Required
Description
id
integer · int64
Yes
Id.
curl --request GET 'https://api.selsup.ru/api/param/1001' \
--header 'Authorization: YOUR_API_TOKEN'
Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑
401auth_required
Authentication required
Authorization is missing, empty, or contains an invalid token.
400error_access_denied
Insufficient permissions
The token exists, but its role cannot perform this operation.
500error_unknown
Unexpected error
Internal failure. Save the request time and contact support; do not blindly retry a mutation.
400error_no_client
The client was not found or has been deleted. Write to support
Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.
400error_not_found_param_by_id
parameter by ID not found
Endpoint-specific error. Use the stable error_not_found_param_by_id code in application logic; localMessage contains the translation shown above.
Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑
401auth_required
Authentication required
Authorization is missing, empty, or contains an invalid token.
400error_access_denied
Insufficient permissions
The token exists, but its role cannot perform this operation.
500error_unknown
Unexpected error
Internal failure. Save the request time and contact support; do not blindly retry a mutation.
400error_no_integration_with_nc
National Catalog token not received
Endpoint-specific error. Use the stable error_no_integration_with_nc code in application logic; localMessage contains the translation shown above.
400error_service_did_not_find_any_results
The service did not find any results for the given parameters {number}.
Endpoint-specific error. Use the stable error_service_did_not_find_any_results code in application logic; localMessage contains the translation shown above.
400error_service_not_implemented
Service not implemented
Endpoint-specific error. Use the stable error_service_not_implemented code in application logic; localMessage contains the translation shown above.
400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.
Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.
400error_token_expired_or_revoked
API token revoked or entered incorrectly
Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.
GET
Params
/api/param/find
Token with read access
Params using GET /api/param/find.
Query parameters
Field
Type
Required
Description
nationalCatalogId
integer · int64
No
National Catalog Id.
wildberriesTypeId
integer · int64
No
Wildberries Type Id.
wildberriesCategoryId
integer · int64
No
Wildberries Category Id.
ozonCategoryId
integer · int64
No
Ozon Category Id.
ozonDescriptionCategoryId
integer · int64
No
Ozon Description Category Id.
aliexpressCategoryId
integer · int64
No
Aliexpress Category Id.
lamodaCategoryId
integer · int64
No
Lamoda Category Id.
kaspiCategoryId
string
No
Kaspi Category Id.
avitoCategoryId
integer · int64
No
Avito Category Id.
yandexMarketCategoryId
integer · int64
No
Yandex Market Category Id.
categoryId
integer · int32
No
Category Id.
useAllCategories
boolean
No
Use All Categories.
useCategoryOption
boolean
No
Use Category Option.
limit
integer · int32
No
Limit.
page
integer · int32
No
Page.
count
boolean
No
Count.
sortBy
string
No
Sort By.
ascending
boolean
No
Ascending.
curl --request GET 'https://api.selsup.ru/api/param/find?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'
Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑
401auth_required
Authentication required
Authorization is missing, empty, or contains an invalid token.
400error_access_denied
Insufficient permissions
The token exists, but its role cannot perform this operation.
500error_unknown
Unexpected error
Internal failure. Save the request time and contact support; do not blindly retry a mutation.
Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑
401auth_required
Authentication required
Authorization is missing, empty, or contains an invalid token.
400error_access_denied
Insufficient permissions
The token exists, but its role cannot perform this operation.
500error_unknown
Unexpected error
Internal failure. Save the request time and contact support; do not blindly retry a mutation.
400error_no_client
The client was not found or has been deleted. Write to support
Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.
400error_remove_param
Can't delete setting
Endpoint-specific error. Use the stable error_remove_param code in application logic; localMessage contains the translation shown above.
400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.
Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.