Асноўны працоўны паток · Кіраўнікі
Каталог прадукту і карты
Пошук прадукту, поўнае здабыццё карт, стварэнне мадэляў, слоўнікі брэндаў і катэгорый, і параметры рынку.
Карта SelSup з'яўляецца іерархічнай мадэль, колераў варыянтаў, і канчатковых прадуктаў або памераў.
PIM, ERP і каталог інтэграцыі01
Знайдзіце прадукт і загрузіць поўную карту
Пошук прадукту вяртае лёгкае прадстаўленне спісу. Захоўваць прадуктId, skuId, viewId, і modelId асобна, таму што яны ідэнтыфікуюць розныя суб'екты.
Загрузіце мадэль па modelId для поўнай карты. Калі патрабуюцца значэнні дынамічных параметраў, уключыце адпаведны варыянт запыту задокументавана для канчатковага пункта мадэлі.
- 1
Пошук па старонках
Выкарыстоўвайце стабільны sortering ID і пазбягайце разлічваць на кожную старонку.
- 2
Чытайце пазначыльнік мадэлі
Атрымаць modelId або view.model.id з вынікаў пошуку, у залежнасці ад адказнай прадстаўлення.
- 3
Загрузіце поўную мадэль
Мадэль змяшчае варыянты і памеры, неабходныя для рэдагавання карты.
Сродкі API канечныя пункты
GET/api/product/findПрадукты пошукуGET/api/model/{modelId}Загрузіце поўную мадэль
02
Стварыць мінімальную картку
Мадэль па-ранейшаму мае патрэбу ў адным варыянце і адным канчатковым прадукце нават калі бізнес не выкарыстоўвае колеры або памеры.
Знайдзіце або стварыце брэнд і катэгорыю спачатку.
Выкарыстоўвайце мадэль артыкул у якасці стабільнага знешняга ключа. SelSup можа генераваць адсутнічаючыя штрык-коды, але экспліктыўная картаванне штрых-кодаў больш бяспечна для двухбаковай сінхронізацыі.
Падзеленыя мадэлі ўтрымліваюць палёты службы. Адпраўце толькі палёў, пералічаных у бягучым корпусе запыту канчатковага пункта.
{
"article": "MODEL-001",
"title": "Basic T-shirt",
"brandId": 8124,
"categoryId": 27640,
"organizationId": 1,
"views": [
{
"color": "Black",
"sizes": [
{
"name": "Basic T-shirt, M",
"size": "M"
}
]
}
]
}
03
Абноўленне без страты дадзеных
Выкарыстоўвайце PATCH для частковага змены канчатковага прадукту, калі канчатковы пункт падтрымлівае зліванне.
Перад PUT загрузіце апошнюю мадэль, змяніце патрабаваныя палі ў вашай копіі і адпраўце ўзгодненыя структуры. Не выкарыстоўвайце стары адказ, калі карта можа змянілася ў карыстальніку карыстальскага карыстальнага карыстача.
Калі няма версіі суб'екта або ETag, мінімізаваць акно чытання-запісу і выканаць праверку чытання пасля захавання.
Сродкі API канечныя пункты
PATCH/api/product/{productId}Частковае абнаўленне прадуктуPUT/api/model/{modelId}Замяніць дадзеныя мадэлі
04
Параметры і дапушчальныя значэнні
Значэнні параметраў могуць быць на ўзроўні катэгорыі, мадэлі, варыянту або прадукту.
Для multiValueAllowed, адпраўце некалькі значэнняў з тым жа параметры. Выберыце форму значэння з valueType, і вырашыць дапушчаны варыянт першым, калі displayType з'яўляецца SUGGEST.
Катэгорыі і параметры рынку змяняюцца.
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609
GET https://options.selsup.ru/option/fetchOption?paramId=60019&query=cotton&limit=10