SelSup Developers

Продукциянын референттүү маалыматы · API Сүрөт

Бренддер

Бренддерди түзүп, таап, Озон жана 1С тармактарына картага салып, логотиптерди башкарып, дубликаттарды коопсуз бириктирүү.

9 чектөө пункттары/api/brandТуруктууМашина менен окулуучу сүрөттөмө ↗
{ }

SelSup продуктусунун ар бир бренди керек. брендсиз товарлар үчүн, биринчи кезекте атайын No brand жазуусун түзүп, анын идентификаторуну өнүмдөрдүн карталарында колдонуңуз.

/api/brand

Колдонууга даяр жумуш жүрүштөрү

Колдонууга даяр жумуш жүрүштөрү

01

Продукту түзүүдөн мурун брендди табуу же түзүү

Эгер саптар бош болсо, брендди түзүп, продукт картасынын бренддин IDсин сактаңыз.

  1. GET /api/brand/find суроону жана count=true менен чал.
  2. Арызга карата аталыштарды сансыз салыштырып көргүлө.
  3. Эгерде дал келбесе, POST /api/brand аты менен жөнөтүңүз.
  4. Продукциянын моделин түзүүдө жооптун бренддин ID-ин колдонуңуз.
02

1C каталогун синхрондоо

1C ачкычын бир CIdде сактап, бир өтүнүч менен бүт каталогду жүктөп алуунун ордуна баракчаларды алып кел.

  1. БРАНДИД тарабынан бир жолу 50500 жазууну сураңыз.
  2. Биринчи өтүнүч боюнча эсеп=чын коюңуз.
  3. BrandOneCId тарабынан табылган жоголгон жазууларды түзүү же жаңылоо.
03

Продукциялык шилтемелерди жоготпой эле көчүрмөсүн алып салуу

Merge продукт моделдерин дубликаттан баштапкы брендге көчүрүп, андан кийин дубликатты жок кылат.

  1. Эки бренддин идентификаторлорун алып келип текшерип көрүңүз.
  2. Негизги бренддин идентификациясын өткөрүп, дубликаттын идентификациясына киргизиңиз.
  3. Биринчи брендди кайра алып келип, тиешелүү продукцияны текшерип көрүңүз.

Маалыматтын модели

Бранддагы талаалар чындыгында кайтып келишти

Logo талаалары сүрөт жүктөлгөндөн кийин пайда болот. API катышпаган бөлүшүлгөн моделдеги талаалар атайылап жокко чыгарылат.

Brand10 аймактар
brandIdinteger

SelSup эсебиндеги бренддин идентификатору.

read-only
namestring

Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.

Милдеттүү
logoUrlstring

Учурдагы логотиптин коомдук URL-сайты.

read-only
logoSizeinteger

Логотиптин өлчөмү байттордо.

read-only
logoWidthinteger

Логотиптин туурасы пикселде.

read-only
logoHeightinteger

Логотиптин бийиктиги пикселде.

read-only
deletedboolean

Бренддин архивдештирилгендиги.

ozonNamestring

Озон каталогундагы бренд.

nullable
ozonIdinteger · int64

Озондогу марканын идентификатору.

nullable
oneCIdstring

1C бөлүгүндөгү тышкы маркалык идентификатор.

nullable

Келишимдин катасы

Колдонмо каталарын кантип кайтаруу керек

error коду ар бир жергиликтүү жерде бирдей, ал эми колдонуучуга багытталган билдирүүнү сервер которат. error айланасында тиркеме логикасын түзүп, localMessageди көрсөтүү үчүн гана колдонуңуз.

error

Интеграция логикасы үчүн туруктуу машина окуй турган код.

localMessage

API белги колдонуучусунун тилинде көрсөтүүгө даяр билдирүү.

params

Сервер тарабынан локалдаштырылган билдирүү шаблондоруна интерполяцияланган баалуулуктар.

localMessage API белгиси ээси болгон колдонуучунун lang талаасын колдонот. Документация тили жана Accept-Language башчысы аны өзгөртпөйт; колдонуучу тилди конфигурациялабаган учурда орусча колдонулат.

RUКолдонуучунун жергиликтүү жергилиги ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
KYКыргызча (ky)
{
  "error": "error_brand_already_exists",
  "localMessage": "Base бренди мурунтан эле бар",
  "params": {
    "name": "Base"
  }
}

Акыркы пункттар

Акыркы пункттар

GET

Бренддерди табуу

/api/brand/find
Окуу мүмкүнчүлүгү бар белги

Тизмелерди, издөө жана синхрондоо үчүн негизги чекит. Бул учурдагы эсептен бренддерди кайтарат жана туруктуу баракчалоону колдойт.

i

конуштун = true дегенди киргизгенде гана жалпысы кайтарылат. Кийинки барактар үчүн конушты өчүрүү.

Сурамжылоо параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
query string Жок Бренддин аталышында издөө үчүн субстринг.
deleted boolean Жок Архивдештирилген үчүн чын, активдүү үчүн жалган.
brandOneCId string Жок Туура сырткы 1С идентификатору.
hasOzonId boolean Жок Озонго жөнөтүлгөн бренддерди гана кайтаруу үчүн ишенимдүү.
limitДемейки маани: 50 integer Жок Баракчасына 500гө чейин жазуулар.
pageДемейки маани: 1 integer Жок Беттин саны 1-ден башталат.
countДемейки маани: false boolean Жок Толук шайкештиктердин жалпы санын кош.
sortBy stringNAME, BRANDID Жок Бренддин аты-жөнү, ички идентификатордун БРАНДИ.
ascendingДемейки маани: false boolean Жок Ал эми төмөндөш үчүн жалган.
curl --request GET 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
ТалааТүрүМилдеттүүСүрөттөмө
rows Brand[] Ооба Учурдагы баракчадагы бренддер.
Топтун элементтеринин түзүлүшү Brand
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
totalЖашоо шарты: count=true integer Жок Толугу менен дал келет; эсеп=чын болгондо гана бар.
page integer Ооба Учурдагы барактын номери.
hasNextPage boolean Ооба башка баракка киргенде туура болот.
{
  "rows": [
    {
      "brandId": 8124,
      "name": "Base",
      "deleted": false,
      "ozonName": "BASE"
    }
  ],
  "total": 1,
  "page": 1,
  "hasNextPage": false
}
Каталар3

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

GET

Бардык бренддерди тизмекте

/api/brand/all
Окуу мүмкүнчүлүгү бар белги

Эсептеги ар бир брендди аты-жөнү менен тартипке келтирүү.

i

Чоң каталогдор жана кайталанган синхрондоо үчүн /find баракчалоо менен колдонуңуз.

curl --request GET 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
Топтун элементтеринин түзүлүшү Brand[]
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
[
  {
    "brandId": 8124,
    "name": "Base",
    "deleted": false
  },
  {
    "brandId": 8125,
    "name": "Air",
    "deleted": false
  }
]
Каталар3

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

GET

Идентификация боюнча марка алыңыз

/api/brand/{brandId}
Окуу мүмкүнчүлүгү бар белги

Акчалык эсептен марканы ички идентификатору менен кайтарып берет.

i

Азыркы ишке ашыруу HTTP 404-дин ордуна белгисиз BrandId үчүн бош маанини кайтарат.

Жол параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Ооба SelSup маркасынын идентификатору.
curl --request GET 'https://api.selsup.ru/api/brand/8124' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
Объекттердин талаалары Brand
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
{
  "brandId": 8124,
  "name": "Base",
  "deleted": false,
  "ozonName": "BASE",
  "ozonId": 100582
}
Каталар3

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

POST

Бренд түзүү

/api/brand
Жазуу мүмкүнчүлүгү бар белги

Акчадагы эсепке бренд түзөт.

i

Аты-жөнү салыштыруу үчүн, Base жана base бир эле бренд катары каралат.

Талап боюнча орган

application/json
ТалааТүрүМилдеттүүСүрөттөмө
name string Ооба Өзгөчө, бош эмес бренд.
ozonName string Жок Озон каталогунан аты, эгер белгилүү болсо.
ozonId integer · int64 Жок Карталар алдын ала импорттолбостон жөнөтүлгөндө Ozon маркасынын идентификатору.
oneCId string Жок 1C-теги туруктуу тышкы бренд ачкычы.
curl --request POST 'https://api.selsup.ru/api/brand' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Base",
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}'

Ийгиликтүү жооп

200
Объекттердин талаалары Brand
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
{
  "brandId": 8124,
  "name": "Base",
  "deleted": false,
  "ozonName": "BASE",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
Каталар6

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

400error_empty_brand_name
Бренддин аталышы көрсөтүлгөн эмес

аты жок, бош же тек гана ак мейкиндикти камтыйт.

400error_brand_already_exists
{name} бренди мурунтан эле бар

Бул эсепте буга чейин эле иш-аракетке карата сезимтал эмес шайкеш келүү бар. params.name каршылыктуу аталыштарды камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Кызматты колдонууну улантуу үчүн тарифти төлөп, интеграция логикасында error_subscription_expired колдонуңуз.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

PUT

Брендди жаңыртуу

/api/brand/{brandId}
Жазуу мүмкүнчүлүгү бар белги

Жаңыртуучу бренд талааларын алмаштырат. ID URLден келет; JSON-те BrandId жөнөтбө.

i

Бул PUT, ошондуктан сактоо үчүн керек болгон ар бир наркы камтыйт. логотип талаалары өзүнчө аяктык пункттар тарабынан башкарылат.

Жол параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Ооба Бренд жаңылануу үчүн.

Талап боюнча орган

application/json
ТалааТүрүМилдеттүүСүрөттөмө
name string Ооба Жаңы уникалдуу аталыш.
deletedДемейки маани: false boolean Жок Архивденген абал.
ozonName string Жок Озондогу бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1С бөлүгүндөгү марканын идентификатору.
curl --request PUT 'https://api.selsup.ru/api/brand/8124' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}'

Ийгиликтүү жооп

200
Объекттердин талаалары Brand
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
{
  "brandId": 8124,
  "name": "Base Studio",
  "deleted": false,
  "ozonName": "BASE STUDIO",
  "ozonId": 100582,
  "oneCId": "BRAND-001"
}
Каталар6

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

400error_empty_brand_name
Бренддин аталышы көрсөтүлгөн эмес

аты жок, бош же тек гана ак мейкиндикти камтыйт.

400error_brand_already_exists
{name} бренди мурунтан эле бар

Бул эсепте буга чейин эле иш-аракетке карата сезимтал эмес шайкеш келүү бар. params.name каршылыктуу аталыштарды камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Кызматты колдонууну улантуу үчүн тарифти төлөп, интеграция логикасында error_subscription_expired колдонуңуз.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

DELETE

Брендди өчүрүү, архивдөө же калыбына келтирүү

/api/brand/{brandId}
Жазуу мүмкүнчүлүгү бар белги

SelSup менен катуу жок кылуу аракет кылынат. Эгер шилтемелер бар болсо, ал ордуна брендди архивдейт.

Жол параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Ооба Марканын идентификатору.

Сурамжылоо параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
deleted boolean Ооба жок кылуу үчүн туура же архивдөө үчүн туура эмес; калыбына келтирүү үчүн туура.
curl --request DELETE 'https://api.selsup.ru/api/brand/8124?deleted=true' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
brand_has_been_removed

Ал белги түбөлүккө жок кылынган.

brand_signed_as_deleted

Ал эми шилтемелер жок кылынбай калгандыктан, бренд архивден чыгарылган.

brand_has_been_restore

Ал архивден калыбына келтирилген.

"brand_signed_as_deleted"
Каталар3

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

POST

Логотипти жүктөп алуу

/api/brand/{brandId}/image
Жазуу мүмкүнчүлүгү бар белги

Multipart/form-data. сүрөтү жүктөлөт.

i

Бинардык файлды файлга жөнөтүү; бул чекит JSONти кабыл албайт.

Жол параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Ооба Марканын идентификатору.

Талап боюнча орган

multipart/form-data
ТалааТүрүМилдеттүүСүрөттөмө
file binary Ооба Сүрөт файлы колдоого алынган форматта.
curl --request POST 'https://api.selsup.ru/api/brand/8124/image' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./logo.png'

Ийгиликтүү жооп

200
Объекттердин талаалары Brand
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
{
  "brandId": 8124,
  "name": "Base",
  "logoUrl": "https://files.selsup.ru/brand/8124.png",
  "logoSize": 18420,
  "logoWidth": 512,
  "logoHeight": 512,
  "deleted": false
}
Каталар7

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

400error_brand_to_found
{name} бренди табылган жок

brandId учурдагы эсепке кирбейт. документ error кодун API кайтарып бергендей сактап калат.

400error_wrong_image_format
Файл үчүн сүрөттүн туура эмес форматы: {name}

Файл колдоого алынган сүрөт форматы катары чечмелендирилбеди.

400error_max_upload_size_exceeded
Файлдын уруксат берилген өлчөмү ашты

Көп бөлүктүү өтүнүч сервердеги жүктөө чегинен ашып түшөт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Кызматты колдонууну улантуу үчүн тарифти төлөп, интеграция логикасында error_subscription_expired колдонуңуз.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

DELETE

Логотипти өчүрүү

/api/brand/{brandId}/image
Жазуу мүмкүнчүлүгү бар белги

Логотип файлын өчүрүп, анын өлчөмдөрүн бренддин жазуусунда калыбына келтирүү.

Жол параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Ооба Марканын идентификатору.
curl --request DELETE 'https://api.selsup.ru/api/brand/8124/image' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200
Объекттердин талаалары Brand
ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Жок SelSup эсебиндеги бренддин идентификатору.
name string Ооба Топтун аты. алдын алуу жана арттагы орунду сактоо менен алып салынат.
logoUrl string Жок Учурдагы логотиптин коомдук URL-сайты.
logoSize integer Жок Логотиптин өлчөмү байттордо.
logoWidth integer Жок Логотиптин туурасы пикселде.
logoHeight integer Жок Логотиптин бийиктиги пикселде.
deletedДемейки маани: false boolean Жок Бренддин архивдештирилгендиги.
ozonName string Жок Озон каталогундагы бренд.
ozonId integer · int64 Жок Озондогу марканын идентификатору.
oneCId string Жок 1C бөлүгүндөгү тышкы маркалык идентификатор.
{
  "brandId": 8124,
  "name": "Base",
  "logoSize": 0,
  "logoWidth": 0,
  "logoHeight": 0,
  "deleted": false
}
Каталар7

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

400error_brand_to_found
{name} бренди табылган жок

brandId учурдагы эсепке кирбейт. документ error кодун API кайтарып бергендей сактап калат.

400error_empty_brand_logo
Бренддин сүрөтү жок

Логотипсиз бренд үчүн логотипти жок кылуу өтүнүчүн коюлган.

400error_cant_remove_brand_logo
Бренддин сүрөтүн өчүрүү мүмкүн эмес

Сактоо файлды жок кыла алган жок же бренддин рекордун жаңырта алган жок.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Кызматты колдонууну улантуу үчүн тарифти төлөп, интеграция логикасында error_subscription_expired колдонуңуз.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

POST

Кошуунун эки түрү

/api/brand/{brandId}/merge/{removeBrandId}
Жазуу мүмкүнчүлүгү бар белги

Продукциянын моделдерин BrandIdден BrandIdга көчүрүп, андан кийин BrandIdди биротоло жок кылат.

i

Бул жокко чыгарылбайт. BrandId сакталат; removeBrandId - алып салуу үчүн дубликат.

Жол параметрлери

ТалааТүрүМилдеттүүСүрөттөмө
brandId integer Ооба Негизги бренддин идентификатору.
removeBrandId integer Ооба Таш үчүн бренддин идентификаторунун көчүрмөсү.
curl --request POST 'https://api.selsup.ru/api/brand/8124/merge/9012' \
  --header 'Authorization: YOUR_API_TOKEN'

Ийгиликтүү жооп

200

Бул жооптун денеси жок.

Каталар5

Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑

401auth_required
Ырасмий күбөлөндүрүү талап кылынат

Authorization жок, бош же жараксыз белгиси бар.

400error_access_denied
Кирүүгө тыюу салынган

Токен бар, бирок анын ролу бул операцияны аткара албайт.

400error_brand_not_found
Бренд табылган жок: {name}

Бирдиктүү топтоого өтүнгөн бренддердин бири учурдагы эсепке кирбейт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Кызматты колдонууну улантуу үчүн тарифти төлөп, интеграция логикасында error_subscription_expired колдонуңуз.

500error_unknown
Белгисиз ката кетти. Эгерде көйгөй кайталанса, колдоо кызматына жазыңыз

Ички бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.

Authorization

Сынак өтүнүчтөрү үчүн белги

Токен бул браузердин локалдык сактагычында калат жана API.selsup.ru сайтына Authorization өтүнүч башкычасында гана жөнөтүлөт.

Байкап көрүү

Чыныгы өтүнүч параметрлери

API түздөн-түз жооп

SelSup жоопту көрүү үчүн өтүнүч жөнөтүү.