Wildberries API токені: қайдан алу және қалай жасау

Кез келген сервисті дүкенге қосқанда бірінші сұрақ бірдей естіледі: «токенді қайдан алу керек». Кабинеттегі бөлім бір жылда орнын ауыстырып, атауын өзгертті, токен түрі төртеу болды, ал іздеудегі нұсқаулықтардың көбі әлі күнге «Настройки → Доступ к API» дегенге апарады, ондай бөлім енді жоқ. Төменде WB-нің 2026 жылғы 18 мамырдағы өзекті нұсқаулығы бойынша жол, WB білім базасының 5 тамыздағы түр таңдау ережелері және нұсқаулықтар үндемейтін бір лимит тұзағы.

Қысқаша: токенді тек кабинет иесі «API бойынша интеграциялар» бөлімінде жасайды (Профиль → Интеграции по API). Ол 180 күн жарамды, бір рет қана көрсетіледі, бір дүкенге белсенді токен саны 20-ға дейін. Өз бағдарламаңызға немесе қораптағы 1С-ке жеке токен, Шешімдер каталогындағы бұлттық сервиске сервистік токен, қалған бұлтқа базалық токен керек. Токенді dev.wildberries.ru/jwt сайтында, бөгде сайттарсыз тексеруге болады.

Wildberries API токені дегеніміз не

WB API токені нүктемен бөлінген үш блоктан тұратын жол, ол «eyJ» таңбаларынан басталады. Ол арқылы сыртқы бағдарлама кабинеттің логині мен паролін білмей-ақ дүкеніңіздің деректерін оқиды және рұқсат етілсе, оларды өзгертеді. Техникалық тұрғыдан бұл RFC 7519 стандарты бойынша JWT: ішінде токен түрі, сатушының идентификаторы, жарамдылық мерзімі және қолжетімділік санаттарының биттік маскасы жатыр. Токен кабинетке кіруге, ақша шығаруға немесе деректемелерді ауыстыруға мүмкіндік бермейді. Ол тек сіз жасау кезінде белгілеген API бөлімдерін ашады.

2023–2024 жылдардағы нұсқаулықтардан келген ескі атаулар, «статистика кілті», «контент кілті», «жаңа API кілті», бүгін бір нәрсені білдіреді: бір токеннің ішіндегі санаттар. Бөлек кілттер енді жоқ, құсбелгілер жиынтығы бар бір токен ғана бар.

WB кабинетінен API токенді қайдан табуға болады

WB Партнёры кабинетінде: оң жақ жоғарыдағы заңды тұлғаның атауы, содан кейін «Профиль» және «API бойынша интеграциялар» бөлімі. Бөлімді тек профиль иесі көреді. Қандай құқығы болса да, менеджер «тек аккаунт иесіне қолжетімді» деген бітеуішті көреді және онымен ештеңе істей алмайды.

Мұнда іздейтін, бірақ таба алмайтын үш нәрсе:

• Дайын токенді қайта қарау мүмкін емес. WB оны жасау кезінде бір рет көрсетеді. Одан кейін тізімде карточка қалады: атауы, жарамдылық мерзімі, қолжетімділік деңгейі, санаттар. Жолды жоғалтсаңыз, жаңасын шығарасыз.
• Ескі жол жұмыс істемейді. Іздеу нәтижесіндегі мақалалардың көбінде тұрған «Настройки → Доступ к API» өткен шақта қалды: WB-нің 2026 жылғы 18 мамырда жаңартылған нұсқаулығы бойынша бөлім профильде тұрады және «API бойынша интеграциялар» деп аталады.
• Токен қызметкерге емес, иесіне байланған. Дүкен иесі ауысқанда барлық токен жұмысын тоқтатады, жаңа иесіне оларды қайта шығару керек.

Токеннің қай түрін таңдау керек

Түрі төртеу, әрі таңдауды сервис емес, бағдарлама тұрған орын белгілейді. WB білім базасының 2026 жылғы 5 тамыздағы «Бұлттық сервис пе әлде жергілікті шешім бе: қандай токен таңдау керек» мақаласында дәл солай тұжырымдалған.

• Жеке. Өз бағдарламаларыңызға және өз инфрақұрылымыңыздағы қораптағы жүйелерге: компания серверіндегі 1С, ERP, жалға алынған VPS-тегі скрипт. Кеңейтілген санаттарды, оның ішінде пайдаланушыларды басқаруды ашады. Жасау кезінде «токенді үшінші тұлғаларға беруге болмайтынын түсінемін» деген ескертумен келісу керек. Бұлттық сервистерде оны пайдалануға болмайды.
• Сервистік. WB Шешімдер каталогындағы бұлттық сервиске. Санаттар сервистің талаптарына қарай автоматты толтырылады, токен тек сонымен жұмыс істейді. Сервис OAuth 2.0-ді қолдаса, токен мүлде керек емес: қолжетімділік бір басумен беріледі және қалған интеграциялардан бөлек кері қайтарылады.
• Базалық. Каталогтан тыс бұлттық сервистерге және интеграцияны нақты деректерде тексеруге. Санаттар мен қолжетімділік деңгейін өзіңіз таңдайсыз.
• Сынақ. Тек жасанды деректері бар WB API сынақ ортасымен жұмыс істейді, нақты дүкенді көрмейді.

Енді тұзақ. Сервистік құпиясы жоқ базалық токеннің сұраныс лимиттері жеке токенмен салыстырғанда жүздеген және мыңдаған есе төмен. Біз WB API құжаттамасындағы 70 әдістің Request limit кестелерін қарап шықтық, солардың жетеуі мынадай:

Жарнама науқандарының тізімін жеке токен секундына 5 рет сұрайды, базалық сағатына бір рет. Науқандар статистикасы: минутына 3 сұраныс, сағатына бір сұранысқа қарсы. Жарнама шотының балансы: секундына бір рет, сағатына екі ретке қарсы. WB ең жұмсақ болғаны «Маркетплейс» санаты: онда базалық токен жекенің жартысын алады, минутына 150 сұраныс, 300-ге қарсы. Қалған санаттардың бәрінде айырма 15 еседен (ұсынылған мөлшерлемелер) 36 000 есеге дейін (медианауқандар тізімі). Мұндай лимитте ешбір кабинет цифрларды сағатына бір реттен жиі жаңарта алмайды.

Қалыпты лимиттерді базалық токен тек сервистік құпиямен бірге алады: сервис WB API платформасында тіркеліп, әр сұранысқа құпияны қосады. Сондықтан токенді бұлттық сервиске салар алдында одан бір нәрсені сұраған жөн: ол Шешімдер каталогында ма әлде WB-де тіркелген бе. Екеуі де болмаса, ондағы деректер сағатына бір рет қана жаңарып отырады.

Wildberries API токенін қадам бойынша қалай жасау керек

Жолды білсеңіз, жасау екі минут алады. WB нұсқаулығы бойынша тәртіп мынадай:

1. Кабинетке иесінің атынан кіріңіз: «Профиль» → «API бойынша интеграциялар» → «+ Токен жасау».
2. Қойындыны таңдаңыз. «Каталогтағы сервис үшін» сервистік токен жасайды: сервисті іздеуден тауып, оны таңдайсыз. «Қолмен интеграциялау үшін» жеке, базалық және сынақ токенін ашады.
3. Токенді ол шығарылған жүйенің атымен атаңыз: «Сервердегі 1С», «аналитика сервисі». Жарты жылдан кейін атауы бойынша нақты нені жаңарту керегін түсінесіз.
4. Деректер санаттары мен қолжетімділік деңгейін белгілеңіз: «оқу және жазу» немесе «тек оқу». Сынақ токенінде бұл қадам жоқ, сынақ ортасы толығымен ашық.
5. Қаласаңыз, түсініктеме қосыңыз. Ол профильдің барлық пайдаланушысына көрінеді және жасалғаннан кейін өзгермейді. Жеке токен үшін тәуекелдер туралы құсбелгіні қойыңыз.
6. «Жасау» түймесін, содан кейін «Көшіріп алып жабу» түймесін басыңыз. Токен алмасу буферінде тұр, екінші рет WB оны көрсетпейді. Оны бірден сервис баптауларына салып, көшірмесін парольдер менеджерінде сақтаңыз.

Қандай қолжетімділік санаттарын белгілеу керек

Тек нақты бағдарлама пайдаланатындарын ғана, әрі әр сервиске бір токеннен. Бұл WB ұсынысы: токен ағып кетсе, ол бөгде адамға тек белгіленген бөлімдерді ашады. Санат саны он үш:

• Контент: тауар карточкалары, сипаттамалар, фото мен видео, жапсырмалар.
• Аналитика: сату шұңғымасы, қалдықтар мен ақылы сақтау есептері, өңірлер бойынша сатылымдар, қайтарулар. Бұл әдістердің қайсысы «Jem» жазылымынсыз жұмыс істейтінін WB аналитикасы тегін туралы мақалада талдадық.
• Бағалар мен жеңілдіктер: баға қою, акциялар күнтізбесі.
• Маркетплейс: сатушы қоймалары, FBS, DBS және DBW тапсырыстары.
• Статистика: негізгі есептер, оның ішінде тапсырыстар, сатылымдар және апталық өткізу есептері.
• Жылжыту: науқандар, мөлшерлемелер, бюджеттер, жарнама статистикасы.
• Сұрақтар мен пікірлер, Сатып алушылармен чат: сатып алушыларға жауаптар.
• Жеткізілімдер: FBW қабылдау слоттары мен коэффициенттері, кабинетте қабылданған оферта талап етіледі.
• Сатып алушылардың қайтарулары, Құжаттар, Қаржы (баланс және қаржылық есептер), Пайдаланушылар (тек жеке токенде).

Аналитика сервисіне әдетте «тек оқу» режиміндегі Статистика, Аналитика, Контент, Бағалар, Жылжыту және Қаржы жеткілікті. Мөлшерлемелерді, бағаларды немесе пікірлерге жауаптарды автоматтандыру тек «оқу және жазу» кезінде жұмыс істейді. Жасалып қойған токенге санат қосу мүмкін емес, жаңасын шығаруға тура келеді: сервисте қолжетімділігі жоқ бөлім жай ғана бос қалады.

Токен қанша уақыт жарамды және оны қалай жаңарту керек

Жасалған сәттен бастап 180 күн, әрі оны ұзартуға болмайды. Мерзім бітерден үш күн бұрын WB кабинеттегі қоңырауға хабарлама жібереді, бұл қор уақыт емес, соңғы ескерту. WB-нің өзі екі апта бұрын еске салғыш қоюды және токенді мерзімнен 7–14 күн бұрын ауыстыруды ұсынады.

Жаңарту «API бойынша интеграциялар» бөліміндегі «Көшірме жасау» түймесі арқылы жүреді: WB сол баптаулары бар жаңа токен жасайды, ескісі қолмен жойылғанша жұмысын жалғастырады. Токенді барлық жүйеде ауыстырыңыз, бірнеше күн деректердің келіп жатқанын тексеріңіз, содан кейін ғана ескісін жойыңыз.

Біздің деректер бойынша сатушылар мұны елемейді. Дүкендер Парус Селлерге қосқан 16 токеннің 2026 жылғы қыркүйекке қарай 14-інің мерзімі өтіп кеткен, тірісі екеу ғана. Интеграция үнсіз өледі: графиктер жаңаруын тоқтатады, автоматтандырулар тұрып қалады, ал себебі тек токеннің ішінен көрінеді. Жақсы сервис мерзімді өзі санап, алдын ала ескертеді.

Токенді қалай тексеріп, қалай ашып оқуға болады

Ресми декодер dev.wildberries.ru/jwt сайтында тұр: токенді саласыз да, түрін, мерзімін, санаттарын, қолжетімділік режимі мен мәртебесін көресіз. Бөгде JWT-декодерлер бұған жарамайды: олар енгізілген деректі сақтап қалуы мүмкін, ал токен дегеніміз дүкеннің паролі.

WB-нің токенді ашып оқу туралы мақаласы бойынша ішінен не көрінеді: «acc» өрісі түрін белгілейді (1 базалық, 2 сынақ, 3 жеке, 4 сервистік), «exp» аяқталу күнін, «s» санаттар маскасын, «sid» сатушының идентификаторын. Мәртебе «Белсенді», «Мерзімі өткен», «Кері қайтарылған» және «Белсенді емес» болады: соңғысы иесінің ауысқанын немесе аккаунттың бұғатталғанын білдіреді.

API қатемен жауап берсе, кодты оқыңыз. 401 токеннің мерзімі өткенін, дұрыс емес екенін немесе онда керекті санаттың жоқ екенін білдіреді. 403 қолжетімділіктің бұғатталғанын немесе токеннің жойылған пайдаланушыға тиесілі екенін айтады. Байланысты жылдам тексеру: санат доменіндегі «/ping» сұранысы, мысалы statistics-api.wildberries.ru/ping.

Токенмен жұмыс істеу кезіндегі қауіпсіздік ережелері

• Бір сервиске бір токен. Біреуінің ағып кетуі қалған интеграцияларды ашпайды.
• Токенді мессенджермен және поштамен жібермейді. Оны сервис баптауларына өз қолымен салады, WB ережелері солай талап етеді.
• Сервис ештеңе өзгертпеуі тиіс жердің бәрінде «тек оқу».
• Сәл ғана күдік болса, токенді «API бойынша интеграциялар» бөлімінде жойып, жаңасын шығарады. Профильде бөгде әрекеттер болса, WB қолдау қызметіне «Жеке кабинет қауіпсіздігі» санаты бойынша жазады.
• Сервистен токенді қалай сақтайтынын сұрайды. Қалыпты жауап: шифрлайды, сақтағаннан кейін ешкімге көрсетпейді, WB кабинетінде кері қайтарылады.

Парус Селлердегі қосылу осылай құрылған: шебер токенді серверге жіберер алдында талдап, түрін, мерзімін, дүкенді және санаттарды көрсетеді, ал бір санат жетіспесе, қайсысы екенін атайды. Кілт шифрланған күйде сақталады, шифрлау кілті базадан бөлек жатады, токенді тұтас ешкім көрмейді, қолдау қызметі де. Токенді WB кабинетінде кері қайтарсаңыз, платформа мұны бір минут ішінде байқап, автоматтандыруларды тоқтатады. Толығырақ «Қауіпсіздік» бетінде.

PARUS60 промокодымен Парус Селлердің алғашқы екі айы тегін, картасыз: дүкенді токен арқылы қосыңыз және алғашқы деректерді 5–10 минуттан кейін көріңіз.

Жиі қойылатын сұрақтар

«Доступ к API» бөлімі жоқ болса, WB-де токенді қайдан табуға болады? Бөлім орнын ауыстырды: оң жақ жоғарыдағы заңды тұлғаның атауы → «Профиль» → «API бойынша интеграциялар». Ол тек кабинет иесінде ашылады.

Wildberries статистика API кілті деген не? Ескі атауы. Қазір бұл кәдімгі токеннің ішіндегі «Статистика» санаты, бөлек кілт жоқ. Оған тапсырыстар мен сатылымдар туралы есептер және апталық өткізу есептері кіреді.

Жасалып қойған токенді қарауға бола ма? Жоқ. WB жолды жасау кезінде бір рет көрсетеді, тізімде атауы, мерзімі және санаттары бар карточка ғана қалады. Жолды жоғалтсаңыз, «Көшірме жасау» түймесін басып, сол баптаулары бар жаңа токен аласыз.

Қанша токен жасауға болады? Бір дүкенге 20 белсенді токенге дейін. WB әр сервиске немесе әр міндетке бөлек токен ұсынады.

1С үшін қандай токен керек? 1С қай жерде тұрғанына байланысты. Өз серверіңіздегі немесе компьютеріңіздегі қораптағы нұсқа: жеке токен. 1С:Фреш және Шешімдер каталогындағы басқа бұлттық нұсқалар: сервистік.

Токен 180 күнге жетпей жұмысын тоқтатса, не істеу керек? Оны декодерде тексеріңіз. «Кері қайтарылған» мәртебесі оны кабинетте біреу жойғанын білдіреді, «Белсенді емес» иесінің ауысқанын немесе бұғаттауды көрсетеді. Екі жағдайда да иесінің атынан жаңа токен шығарыңыз.