SelSup Developers

Public API · API Reference

Parameters

Endpoints for Parameters, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints/api/paramStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/param

Ready-to-use workflows

Ready-to-use workflows

01

Start using Parameters

Use a dedicated API token and validate read operations with test data first.

  1. Keep the token server-side and send it in the Authorization header.
  2. Check required parameters and expand the request or response schema.
  3. Handle the HTTP status and the stable error field in application errors.

Data model

Data structures

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"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

POST

Post Param

/api/param/
Token with write access

Post Param using POST /api/param/.

Request body

application/json
Object fieldsParam
FieldTypeRequiredDescription
name string No Name.
title string No Title.
published boolean No Published.
visible boolean No Visible.
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 No 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 No Service.
useCategoryOption boolean No Use Category Option.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE No Value Type.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT No Display Type.
required boolean No Required.
multiValueAllowed boolean No Multi Value Allowed.
maxValuesCount integer · int32 No Max Values Count.
useDictionary boolean No Use Dictionary.
description string No Description.
groupName string No Group Name.
groupId string No Group Id.
ozonDictionaryId integer · int64 No Ozon Dictionary Id.
dictionaryId integer · int64 No Dictionary Id.
measureId integer · int32 No Measure Id.
measure Measure No Measure.
Object fields Measure
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
units Unit[] No Units.
Array item structure Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
unitsMap object No Units Map.
measureId integer · int32 No Measure Id.
defaultUnit Unit No Default Unit.
Object fields Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
lamodaId string No Lamoda Id.
nationalCatalogId integer · int64 No National Catalog Id.
categoryId integer · int64 No Category Id.
avitoIds integer[] No Avito Ids.
avitoOptionsXmlFileName string No Avito Options Xml File Name.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
aliexpressId integer · int64 No Aliexpress Id.
preset string No Preset.
dictionaryParamId integer · int64 No Dictionary Param Id.
dictionaryKey string No Dictionary Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
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 No Gs1 Class.
useAllCategories boolean No Use All Categories.
oneCId string No One CId.
options Option[] No Options.
Array item structure Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
optionsCache CacheStringOption No Options Cache.
lastRefreshOptions integer · int64 No Last Refresh Options.
optionsCount integer · int32 No Options Count.
isAnalytic boolean No Is Analytic.
analyticOrder integer · int32 No Analytic Order.
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 No Marketplace Service.
id integer · int64 No 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"
}'

Success response

200
Object fields Param
FieldTypeRequiredDescription
name string No Name.
title string No Title.
published boolean No Published.
visible boolean No Visible.
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 No 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 No Service.
useCategoryOption boolean No Use Category Option.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE No Value Type.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT No Display Type.
required boolean No Required.
multiValueAllowed boolean No Multi Value Allowed.
maxValuesCount integer · int32 No Max Values Count.
useDictionary boolean No Use Dictionary.
description string No Description.
groupName string No Group Name.
groupId string No Group Id.
ozonDictionaryId integer · int64 No Ozon Dictionary Id.
dictionaryId integer · int64 No Dictionary Id.
measureId integer · int32 No Measure Id.
measure Measure No Measure.
Object fields Measure
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
units Unit[] No Units.
Array item structure Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
unitsMap object No Units Map.
measureId integer · int32 No Measure Id.
defaultUnit Unit No Default Unit.
Object fields Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
lamodaId string No Lamoda Id.
nationalCatalogId integer · int64 No National Catalog Id.
categoryId integer · int64 No Category Id.
avitoIds integer[] No Avito Ids.
avitoOptionsXmlFileName string No Avito Options Xml File Name.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
aliexpressId integer · int64 No Aliexpress Id.
preset string No Preset.
dictionaryParamId integer · int64 No Dictionary Param Id.
dictionaryKey string No Dictionary Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
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 No Gs1 Class.
useAllCategories boolean No Use All Categories.
oneCId string No One CId.
options Option[] No Options.
Array item structure Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
optionsCache CacheStringOption No Options Cache.
lastRefreshOptions integer · int64 No Last Refresh Options.
optionsCount integer · int32 No Options Count.
isAnalytic boolean No Is Analytic.
analyticOrder integer · int32 No Analytic Order.
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 No Marketplace Service.
id integer · int64 No Id.
{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}
Errors8

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

FieldTypeRequiredDescription
id integer · int64 Yes Id.
curl --request GET 'https://api.selsup.ru/api/param/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields Param
FieldTypeRequiredDescription
name string No Name.
title string No Title.
published boolean No Published.
visible boolean No Visible.
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 No 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 No Service.
useCategoryOption boolean No Use Category Option.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE No Value Type.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT No Display Type.
required boolean No Required.
multiValueAllowed boolean No Multi Value Allowed.
maxValuesCount integer · int32 No Max Values Count.
useDictionary boolean No Use Dictionary.
description string No Description.
groupName string No Group Name.
groupId string No Group Id.
ozonDictionaryId integer · int64 No Ozon Dictionary Id.
dictionaryId integer · int64 No Dictionary Id.
measureId integer · int32 No Measure Id.
measure Measure No Measure.
Object fields Measure
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
units Unit[] No Units.
Array item structure Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
unitsMap object No Units Map.
measureId integer · int32 No Measure Id.
defaultUnit Unit No Default Unit.
Object fields Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
lamodaId string No Lamoda Id.
nationalCatalogId integer · int64 No National Catalog Id.
categoryId integer · int64 No Category Id.
avitoIds integer[] No Avito Ids.
avitoOptionsXmlFileName string No Avito Options Xml File Name.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
aliexpressId integer · int64 No Aliexpress Id.
preset string No Preset.
dictionaryParamId integer · int64 No Dictionary Param Id.
dictionaryKey string No Dictionary Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
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 No Gs1 Class.
useAllCategories boolean No Use All Categories.
oneCId string No One CId.
options Option[] No Options.
Array item structure Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
optionsCache CacheStringOption No Options Cache.
lastRefreshOptions integer · int64 No Last Refresh Options.
optionsCount integer · int32 No Options Count.
isAnalytic boolean No Is Analytic.
analyticOrder integer · int32 No Analytic Order.
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 No Marketplace Service.
id integer · int64 No Id.
{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}
Errors5

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.

GET

Get Param Suggest Required

/api/param/preset/{service}/{organizationId}/{preset}
Token with read access

Get Param Suggest Required using GET /api/param/preset/{service}/{organizationId}/{preset}.

Path parameters

FieldTypeRequiredDescription
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 Yes Service.
preset stringSUGGEST_REQUIRED Yes Preset.
organizationId integer · int64 Yes Organization Id.

Query parameters

FieldTypeRequiredDescription
attrId integer · int64 Yes Attr Id.
number string Yes Number.
curl --request GET 'https://api.selsup.ru/api/param/preset/NONE/1001/SUGGEST_REQUIRED?attrId=1001&number=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields SuggestResponse
FieldTypeRequiredDescription
apiversion integer · int32 No Apiversion.
result SuggestParam[] No Result.
Array item structure SuggestParam
FieldTypeRequiredDescription
number string No Number.
empty boolean No Empty.
{
  "apiversion": 1,
  "result": "string",
  "empty": false
}
Errors8

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

FieldTypeRequiredDescription
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'

Success response

200
Array item structure Param[]
FieldTypeRequiredDescription
name string No Name.
title string No Title.
published boolean No Published.
visible boolean No Visible.
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 No 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 No Service.
useCategoryOption boolean No Use Category Option.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE No Value Type.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT No Display Type.
required boolean No Required.
multiValueAllowed boolean No Multi Value Allowed.
maxValuesCount integer · int32 No Max Values Count.
useDictionary boolean No Use Dictionary.
description string No Description.
groupName string No Group Name.
groupId string No Group Id.
ozonDictionaryId integer · int64 No Ozon Dictionary Id.
dictionaryId integer · int64 No Dictionary Id.
measureId integer · int32 No Measure Id.
measure Measure No Measure.
Object fields Measure
FieldTypeRequiredDescription
id integer · int32 No Id.
name string No Name.
nationalCatalogId integer · int64 No National Catalog Id.
wildberriesTypeId integer · int64 No Wildberries Type Id.
aliexpressCategoryId integer · int64 No Aliexpress Category Id.
units Unit[] No Units.
Array item structure Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
unitsMap object No Units Map.
measureId integer · int32 No Measure Id.
defaultUnit Unit No Default Unit.
Object fields Unit
FieldTypeRequiredDescription
name string No Name.
measureId integer · int32 No Measure Id.
id integer · int32 No Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
lamodaId string No Lamoda Id.
nationalCatalogId integer · int64 No National Catalog Id.
categoryId integer · int64 No Category Id.
avitoIds integer[] No Avito Ids.
avitoOptionsXmlFileName string No Avito Options Xml File Name.
clientId integer · int64 No Client Id.
createdDate string · date-time No Created Date.
aliexpressId integer · int64 No Aliexpress Id.
preset string No Preset.
dictionaryParamId integer · int64 No Dictionary Param Id.
dictionaryKey string No Dictionary Key.
level stringCATEGORY, MODEL, VIEW, PRODUCT No Level.
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 No Gs1 Class.
useAllCategories boolean No Use All Categories.
oneCId string No One CId.
options Option[] No Options.
Array item structure Option
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
paramId integer · int64 No Param Id.
ozonId integer · int64 No Ozon Id.
wildberriesId integer · int64 No Wildberries Id.
ymId integer · int64 No Ym Id.
aliexpressId integer · int64 No Aliexpress Id.
clientId integer · int64 No Client Id.
deleted boolean No Deleted.
oneCId string No One CId.
dictionary boolean No Dictionary.
optionId Option No Option Id.
optionsCache CacheStringOption No Options Cache.
lastRefreshOptions integer · int64 No Last Refresh Options.
optionsCount integer · int32 No Options Count.
isAnalytic boolean No Is Analytic.
analyticOrder integer · int32 No Analytic Order.
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 No Marketplace Service.
id integer · int64 No Id.
[
  "string"
]
Errors3

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.

DELETE

Delete Param

/api/param/{paramId}
Token with write access

Delete Param using DELETE /api/param/{paramId}.

Path parameters

FieldTypeRequiredDescription
paramId integer · int64 Yes Param Id.
curl --request DELETE 'https://api.selsup.ru/api/param/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors6

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.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.