SelSup Developers

Public API · API Referencja

Parametry

Punkty końcowe dla parametrów, w tym dokładne trasy, parametry, organy żądania i rozszerzalne schematy odpowiedzi.

5 punkty końcowe/api/paramStabilnyOpis czytelny maszynowo ↗
{ }

Strona ta jest wspierana przez edytowalny samodzielny kontrakt.

/api/param

Gotowe do użytkowania przepływy robocze

Gotowe do użytkowania przepływy robocze

01

Zacznij używać parametrów

Użyj dedykowanego tokena API i najpierw sprawdź operacje odczytu z danymi testowymi.

  1. Trzymaj token z serwera i wysłać go w nagłówku Authorization.
  2. Sprawdź wymagane parametry i poszerz schemat żądania lub odpowiedzi.
  3. Zrób z statusem HTTP i stabilnym pole error w przypadku błędów aplikacyjnych.

Model danych

Struktura danych

Modele są wymienione tutaj raz i mogą być również rozszerzane bezpośrednio z punktów końcowych, które je wykorzystują.

CacheStringOption0 pola
Measure8 pola
idinteger · int32

Id.

namestring

- Nazwa.

nationalCatalogIdinteger · int64

- Tożsamość krajowa.

wildberriesTypeIdinteger · int64

Identyfikator typu Wildberries.

aliexpressCategoryIdinteger · int64

Aliexpress Kategoria Id.

unitsUnit[]

Jednostki.

unitsMapobject

Mapa jednostek.

measureIdinteger · int32

Id. pomiaru.

Option12 pola
idinteger · int64

Id.

namestring

- Nazwa.

paramIdinteger · int64

- Id Param.

ozonIdinteger · int64

Idę ozonową.

wildberriesIdinteger · int64

Id Wildberries.

ymIdinteger · int64

- Idę.

aliexpressIdinteger · int64

Id Aliexpress.

clientIdinteger · int64

Id klientów.

deletedboolean

- Zlikwidowane.

oneCIdstring

Jeden CID.

dictionaryboolean

- Słownik.

optionIdOption

Id opcji.

Param47 pola
namestring

- Nazwa.

titlestring

Tytuł.

publishedboolean

- Opublikowana.

visibleboolean

Widoczne.

serviceParamstring

Serwis Param.

servicestring

- W służbie.

useCategoryOptionboolean

Użyj opcji Kategoria.

valueTypestring

Typ wartości.

displayTypestring

Typ wyświetlacza.

requiredboolean

- To konieczne.

multiValueAllowedboolean

Wzwolona wieloma wartościami.

maxValuesCountinteger · int32

Max wartości liczą.

useDictionaryboolean

Użyj słownika.

descriptionstring

Opis.

groupNamestring

Nazwa grupy.

groupIdstring

Id grupy.

ozonDictionaryIdinteger · int64

Id słownika ozonowego.

dictionaryIdinteger · int64

Id słownika.

measureIdinteger · int32

Id. pomiaru.

measureMeasure

- Mierzenie.

defaultUnitUnit

Połączenie domyślne.

ozonIdinteger · int64

Idę ozonową.

wildberriesIdinteger · int64

Id Wildberries.

ymIdinteger · int64

- Idę.

lamodaIdstring

Id Lamoda.

nationalCatalogIdinteger · int64

- Tożsamość krajowa.

categoryIdinteger · int64

Kategoria ID.

avitoIdsinteger[]

Avito ID.

avitoOptionsXmlFileNamestring

Avito Options Xml Nazwa pliku.

clientIdinteger · int64

Id klientów.

createdDatestring · date-time

Tworzony Termin.

aliexpressIdinteger · int64

Id Aliexpress.

presetstring

- Przedwykonawki.

dictionaryParamIdinteger · int64

Słownik Param Id.

dictionaryKeystring

Klucz słownika.

levelstring

Poziom.

gs1Classstring

Klasy Gs1.

useAllCategoriesboolean

Użyj wszystkich kategorii.

oneCIdstring

Jeden CID.

optionsOption[]

- Możliwości.

optionsCacheCacheStringOption

Opcje Cache.

lastRefreshOptionsinteger · int64

Ostatnie opcje odświeżenia.

optionsCountinteger · int32

Optywy liczą.

isAnalyticboolean

Jest analitykiem.

analyticOrderinteger · int32

- Rozkaz analityczny.

marketplaceServicestring

Usługa rynkowa.

idinteger · int64

Id.

Unit3 pola
namestring

- Nazwa.

measureIdinteger · int32

Id. pomiaru.

idinteger · int32

Id.

SuggestParam1 pola
numberstring

Numer.

SuggestResponse3 pola
apiversioninteger · int32

- Nie. - Nie, nie.

resultSuggestParam[]

Wynik.

emptyboolean

- Nie ma.

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
PLPolski (pl)
{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

Punkty końcowe

POST

Post Param

/api/param/
Token z dostępem do pisania

Post Param używając POST /api/param/.

Organ wnioskujący

application/json
Połączenia obiektuParam
PoleTypWymaganeOpis
name string Nie - Nazwa.
title string Nie Tytuł.
published boolean Nie - Opublikowana.
visible boolean Nie Widoczne.
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 Nie Serwis 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 Nie - W służbie.
useCategoryOption boolean Nie Użyj opcji Kategoria.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Nie Typ wartości.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Nie Typ wyświetlacza.
required boolean Nie - To konieczne.
multiValueAllowed boolean Nie Wzwolona wieloma wartościami.
maxValuesCount integer · int32 Nie Max wartości liczą.
useDictionary boolean Nie Użyj słownika.
description string Nie Opis.
groupName string Nie Nazwa grupy.
groupId string Nie Id grupy.
ozonDictionaryId integer · int64 Nie Id słownika ozonowego.
dictionaryId integer · int64 Nie Id słownika.
measureId integer · int32 Nie Id. pomiaru.
measure Measure Nie - Mierzenie.
Połączenia obiektu Measure
PoleTypWymaganeOpis
id integer · int32 Nie Id.
name string Nie - Nazwa.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
wildberriesTypeId integer · int64 Nie Identyfikator typu Wildberries.
aliexpressCategoryId integer · int64 Nie Aliexpress Kategoria Id.
units Unit[] Nie Jednostki.
Struktura pozycji zestawu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
unitsMap object Nie Mapa jednostek.
measureId integer · int32 Nie Id. pomiaru.
defaultUnit Unit Nie Połączenie domyślne.
Połączenia obiektu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
lamodaId string Nie Id Lamoda.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
categoryId integer · int64 Nie Kategoria ID.
avitoIds integer[] Nie Avito ID.
avitoOptionsXmlFileName string Nie Avito Options Xml Nazwa pliku.
clientId integer · int64 Nie Id klientów.
createdDate string · date-time Nie Tworzony Termin.
aliexpressId integer · int64 Nie Id Aliexpress.
preset string Nie - Przedwykonawki.
dictionaryParamId integer · int64 Nie Słownik Param Id.
dictionaryKey string Nie Klucz słownika.
level stringCATEGORY, MODEL, VIEW, PRODUCT Nie Poziom.
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 Nie Klasy Gs1.
useAllCategories boolean Nie Użyj wszystkich kategorii.
oneCId string Nie Jeden CID.
options Option[] Nie - Możliwości.
Struktura pozycji zestawu Option
PoleTypWymaganeOpis
id integer · int64 Nie Id.
name string Nie - Nazwa.
paramId integer · int64 Nie - Id Param.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
aliexpressId integer · int64 Nie Id Aliexpress.
clientId integer · int64 Nie Id klientów.
deleted boolean Nie - Zlikwidowane.
oneCId string Nie Jeden CID.
dictionary boolean Nie - Słownik.
optionId Option Nie Id opcji.
optionsCache CacheStringOption Nie Opcje Cache.
lastRefreshOptions integer · int64 Nie Ostatnie opcje odświeżenia.
optionsCount integer · int32 Nie Optywy liczą.
isAnalytic boolean Nie Jest analitykiem.
analyticOrder integer · int32 Nie - Rozkaz analityczny.
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 Nie Usługa rynkowa.
id integer · int64 Nie 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"
}'

Odpowiedź udana

200
Połączenia obiektu Param
PoleTypWymaganeOpis
name string Nie - Nazwa.
title string Nie Tytuł.
published boolean Nie - Opublikowana.
visible boolean Nie Widoczne.
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 Nie Serwis 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 Nie - W służbie.
useCategoryOption boolean Nie Użyj opcji Kategoria.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Nie Typ wartości.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Nie Typ wyświetlacza.
required boolean Nie - To konieczne.
multiValueAllowed boolean Nie Wzwolona wieloma wartościami.
maxValuesCount integer · int32 Nie Max wartości liczą.
useDictionary boolean Nie Użyj słownika.
description string Nie Opis.
groupName string Nie Nazwa grupy.
groupId string Nie Id grupy.
ozonDictionaryId integer · int64 Nie Id słownika ozonowego.
dictionaryId integer · int64 Nie Id słownika.
measureId integer · int32 Nie Id. pomiaru.
measure Measure Nie - Mierzenie.
Połączenia obiektu Measure
PoleTypWymaganeOpis
id integer · int32 Nie Id.
name string Nie - Nazwa.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
wildberriesTypeId integer · int64 Nie Identyfikator typu Wildberries.
aliexpressCategoryId integer · int64 Nie Aliexpress Kategoria Id.
units Unit[] Nie Jednostki.
Struktura pozycji zestawu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
unitsMap object Nie Mapa jednostek.
measureId integer · int32 Nie Id. pomiaru.
defaultUnit Unit Nie Połączenie domyślne.
Połączenia obiektu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
lamodaId string Nie Id Lamoda.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
categoryId integer · int64 Nie Kategoria ID.
avitoIds integer[] Nie Avito ID.
avitoOptionsXmlFileName string Nie Avito Options Xml Nazwa pliku.
clientId integer · int64 Nie Id klientów.
createdDate string · date-time Nie Tworzony Termin.
aliexpressId integer · int64 Nie Id Aliexpress.
preset string Nie - Przedwykonawki.
dictionaryParamId integer · int64 Nie Słownik Param Id.
dictionaryKey string Nie Klucz słownika.
level stringCATEGORY, MODEL, VIEW, PRODUCT Nie Poziom.
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 Nie Klasy Gs1.
useAllCategories boolean Nie Użyj wszystkich kategorii.
oneCId string Nie Jeden CID.
options Option[] Nie - Możliwości.
Struktura pozycji zestawu Option
PoleTypWymaganeOpis
id integer · int64 Nie Id.
name string Nie - Nazwa.
paramId integer · int64 Nie - Id Param.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
aliexpressId integer · int64 Nie Id Aliexpress.
clientId integer · int64 Nie Id klientów.
deleted boolean Nie - Zlikwidowane.
oneCId string Nie Jeden CID.
dictionary boolean Nie - Słownik.
optionId Option Nie Id opcji.
optionsCache CacheStringOption Nie Opcje Cache.
lastRefreshOptions integer · int64 Nie Ostatnie opcje odświeżenia.
optionsCount integer · int32 Nie Optywy liczą.
isAnalytic boolean Nie Jest analitykiem.
analyticOrder integer · int32 Nie - Rozkaz analityczny.
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 Nie Usługa rynkowa.
id integer · int64 Nie Id.
{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}
Władze8

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_param_empty_display_type
Nie podano typu

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_param_empty_display_type; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_param_empty_level
poziom parametru jest pusty

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_param_empty_level; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_param_empty_name
Nie podano nazwy parametru

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_param_empty_name; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_param_empty_value_type
Nie określono typu wartości parametru

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_param_empty_value_type; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Param

/api/param/{id}
Token z dostępem do odczytu

Param używający GET /api/param/{id}.

Parametry ścieżki

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

Odpowiedź udana

200
Połączenia obiektu Param
PoleTypWymaganeOpis
name string Nie - Nazwa.
title string Nie Tytuł.
published boolean Nie - Opublikowana.
visible boolean Nie Widoczne.
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 Nie Serwis 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 Nie - W służbie.
useCategoryOption boolean Nie Użyj opcji Kategoria.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Nie Typ wartości.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Nie Typ wyświetlacza.
required boolean Nie - To konieczne.
multiValueAllowed boolean Nie Wzwolona wieloma wartościami.
maxValuesCount integer · int32 Nie Max wartości liczą.
useDictionary boolean Nie Użyj słownika.
description string Nie Opis.
groupName string Nie Nazwa grupy.
groupId string Nie Id grupy.
ozonDictionaryId integer · int64 Nie Id słownika ozonowego.
dictionaryId integer · int64 Nie Id słownika.
measureId integer · int32 Nie Id. pomiaru.
measure Measure Nie - Mierzenie.
Połączenia obiektu Measure
PoleTypWymaganeOpis
id integer · int32 Nie Id.
name string Nie - Nazwa.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
wildberriesTypeId integer · int64 Nie Identyfikator typu Wildberries.
aliexpressCategoryId integer · int64 Nie Aliexpress Kategoria Id.
units Unit[] Nie Jednostki.
Struktura pozycji zestawu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
unitsMap object Nie Mapa jednostek.
measureId integer · int32 Nie Id. pomiaru.
defaultUnit Unit Nie Połączenie domyślne.
Połączenia obiektu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
lamodaId string Nie Id Lamoda.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
categoryId integer · int64 Nie Kategoria ID.
avitoIds integer[] Nie Avito ID.
avitoOptionsXmlFileName string Nie Avito Options Xml Nazwa pliku.
clientId integer · int64 Nie Id klientów.
createdDate string · date-time Nie Tworzony Termin.
aliexpressId integer · int64 Nie Id Aliexpress.
preset string Nie - Przedwykonawki.
dictionaryParamId integer · int64 Nie Słownik Param Id.
dictionaryKey string Nie Klucz słownika.
level stringCATEGORY, MODEL, VIEW, PRODUCT Nie Poziom.
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 Nie Klasy Gs1.
useAllCategories boolean Nie Użyj wszystkich kategorii.
oneCId string Nie Jeden CID.
options Option[] Nie - Możliwości.
Struktura pozycji zestawu Option
PoleTypWymaganeOpis
id integer · int64 Nie Id.
name string Nie - Nazwa.
paramId integer · int64 Nie - Id Param.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
aliexpressId integer · int64 Nie Id Aliexpress.
clientId integer · int64 Nie Id klientów.
deleted boolean Nie - Zlikwidowane.
oneCId string Nie Jeden CID.
dictionary boolean Nie - Słownik.
optionId Option Nie Id opcji.
optionsCache CacheStringOption Nie Opcje Cache.
lastRefreshOptions integer · int64 Nie Ostatnie opcje odświeżenia.
optionsCount integer · int32 Nie Optywy liczą.
isAnalytic boolean Nie Jest analitykiem.
analyticOrder integer · int32 Nie - Rozkaz analityczny.
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 Nie Usługa rynkowa.
id integer · int64 Nie Id.
{
  "name": "Example",
  "title": "Example",
  "published": false,
  "visible": false,
  "serviceParam": "NAME",
  "service": "NONE"
}
Władze5

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_not_found_param_by_id
parametr według ID nie znaleziony

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_not_found_param_by_id; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Zwróć uwagę na propozycję Parama

/api/param/preset/{service}/{organizationId}/{preset}
Token z dostępem do odczytu

Uzyskaj sugestię Param wymagana przy użyciu GET /api/param/preset/{service}/{organizationId}/{preset}.

Parametry ścieżki

PoleTypWymaganeOpis
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 Tak - W służbie.
preset stringSUGGEST_REQUIRED Tak - Przedwykonawki.
organizationId integer · int64 Tak Id organizacyjny.

Parametry zapytania

PoleTypWymaganeOpis
attrId integer · int64 Tak - Przytr.
number string Tak Numer.
curl --request GET 'https://api.selsup.ru/api/param/preset/NONE/1001/SUGGEST_REQUIRED?attrId=1001&number=string' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu SuggestResponse
PoleTypWymaganeOpis
apiversion integer · int32 Nie - Nie. - Nie, nie.
result SuggestParam[] Nie Wynik.
Struktura pozycji zestawu SuggestParam
PoleTypWymaganeOpis
number string Nie Numer.
empty boolean Nie - Nie ma.
{
  "apiversion": 1,
  "result": "string",
  "empty": false
}
Władze8

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_integration_with_nc
Nie otrzymano tokenu Katalogu Narodowego

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_integration_with_nc; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_service_did_not_find_any_results
Serwis nie znalazł wyników dla podanych parametrów {number}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_service_did_not_find_any_results; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_service_not_implemented
Serwis nie zaimplementowany

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_service_not_implemented; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_token_expired_or_revoked
Token API został odwołany lub wprowadzony nieprawidłowo. Sprawdź, czy klucz API ma pełną funkcjonalność. Wygeneruj nowy klucz i zastąp w SELSUP, ponieważ klucze mają okres ważności.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_token_expired_or_revoked; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Params

/api/param/find
Token z dostępem do odczytu

Paramery używające GET /api/param/find.

Parametry zapytania

PoleTypWymaganeOpis
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
wildberriesTypeId integer · int64 Nie Identyfikator typu Wildberries.
wildberriesCategoryId integer · int64 Nie Id kategoria Wildberries.
ozonCategoryId integer · int64 Nie Id kategorii ozonu.
ozonDescriptionCategoryId integer · int64 Nie Ozon opis Kategoria Id.
aliexpressCategoryId integer · int64 Nie Aliexpress Kategoria Id.
lamodaCategoryId integer · int64 Nie Id kategorii Lamoda.
kaspiCategoryId string Nie Id kategoria Kaspi.
avitoCategoryId integer · int64 Nie Id kategorii Avito.
yandexMarketCategoryId integer · int64 Nie Id kategoria Yandex Market.
categoryId integer · int32 Nie Kategoria ID.
useAllCategories boolean Nie Użyj wszystkich kategorii.
useCategoryOption boolean Nie Użyj opcji Kategoria.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy string Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
curl --request GET 'https://api.selsup.ru/api/param/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Struktura pozycji zestawu Param[]
PoleTypWymaganeOpis
name string Nie - Nazwa.
title string Nie Tytuł.
published boolean Nie - Opublikowana.
visible boolean Nie Widoczne.
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 Nie Serwis 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 Nie - W służbie.
useCategoryOption boolean Nie Użyj opcji Kategoria.
valueType stringBOOLEAN, LONG, DOUBLE, ENUM, TEXT, DATE Nie Typ wartości.
displayType stringSELECT, SUGGEST, TEXT, CHECKBOX, LONGTEXT Nie Typ wyświetlacza.
required boolean Nie - To konieczne.
multiValueAllowed boolean Nie Wzwolona wieloma wartościami.
maxValuesCount integer · int32 Nie Max wartości liczą.
useDictionary boolean Nie Użyj słownika.
description string Nie Opis.
groupName string Nie Nazwa grupy.
groupId string Nie Id grupy.
ozonDictionaryId integer · int64 Nie Id słownika ozonowego.
dictionaryId integer · int64 Nie Id słownika.
measureId integer · int32 Nie Id. pomiaru.
measure Measure Nie - Mierzenie.
Połączenia obiektu Measure
PoleTypWymaganeOpis
id integer · int32 Nie Id.
name string Nie - Nazwa.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
wildberriesTypeId integer · int64 Nie Identyfikator typu Wildberries.
aliexpressCategoryId integer · int64 Nie Aliexpress Kategoria Id.
units Unit[] Nie Jednostki.
Struktura pozycji zestawu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
unitsMap object Nie Mapa jednostek.
measureId integer · int32 Nie Id. pomiaru.
defaultUnit Unit Nie Połączenie domyślne.
Połączenia obiektu Unit
PoleTypWymaganeOpis
name string Nie - Nazwa.
measureId integer · int32 Nie Id. pomiaru.
id integer · int32 Nie Id.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
lamodaId string Nie Id Lamoda.
nationalCatalogId integer · int64 Nie - Tożsamość krajowa.
categoryId integer · int64 Nie Kategoria ID.
avitoIds integer[] Nie Avito ID.
avitoOptionsXmlFileName string Nie Avito Options Xml Nazwa pliku.
clientId integer · int64 Nie Id klientów.
createdDate string · date-time Nie Tworzony Termin.
aliexpressId integer · int64 Nie Id Aliexpress.
preset string Nie - Przedwykonawki.
dictionaryParamId integer · int64 Nie Słownik Param Id.
dictionaryKey string Nie Klucz słownika.
level stringCATEGORY, MODEL, VIEW, PRODUCT Nie Poziom.
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 Nie Klasy Gs1.
useAllCategories boolean Nie Użyj wszystkich kategorii.
oneCId string Nie Jeden CID.
options Option[] Nie - Możliwości.
Struktura pozycji zestawu Option
PoleTypWymaganeOpis
id integer · int64 Nie Id.
name string Nie - Nazwa.
paramId integer · int64 Nie - Id Param.
ozonId integer · int64 Nie Idę ozonową.
wildberriesId integer · int64 Nie Id Wildberries.
ymId integer · int64 Nie - Idę.
aliexpressId integer · int64 Nie Id Aliexpress.
clientId integer · int64 Nie Id klientów.
deleted boolean Nie - Zlikwidowane.
oneCId string Nie Jeden CID.
dictionary boolean Nie - Słownik.
optionId Option Nie Id opcji.
optionsCache CacheStringOption Nie Opcje Cache.
lastRefreshOptions integer · int64 Nie Ostatnie opcje odświeżenia.
optionsCount integer · int32 Nie Optywy liczą.
isAnalytic boolean Nie Jest analitykiem.
analyticOrder integer · int32 Nie - Rozkaz analityczny.
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 Nie Usługa rynkowa.
id integer · int64 Nie Id.
[
  "string"
]
Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

DELETE

Usunięcie Paramu

/api/param/{paramId}
Token z dostępem do pisania

Usunięcie Paramu za pomocą DELETE /api/param/{paramId}.

Parametry ścieżki

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

Odpowiedź udana

200
"string"
Władze6

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_remove_param
Nie można usunąć parametru

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_remove_param; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

Authorization

Token do wniosków o badania

Token pozostaje w lokalnym magazynie przeglądarki i jest wysyłany tylko w nagłówku Authorization z wniosków na api.selsup.ru.

Wypróbuj

Prawdziwe parametry żądania

Odpowiedź API

Wyślij wniosek o zapoznanie się z odpowiedzią SelSup.