Wildberries API токені деген не: бұл бағдарламаларға арналған пароль. Кабинет иесі оны «Профиль» → «API бойынша интеграциялар» бөлімінде жасайды, көшіріп алады да, дүкен деректерін ашқысы келетін сервиске қояды: 1С, аналитика сервисі, репрайсер. Бағдарлама тек белгіленген бөлімдерді ғана көреді, токен арқылы кабинетке кіру немесе ақша шығару мүмкін емес. Токен 180 күн өмір сүреді, содан кейін оны қайта шығарады.
«Wildberries-те дүкенді бастау және өсіру» тақырыбындағы 26 мақаланың 12-сі. Тақырыптың барлық мақалалары
Кез келген сервисті дүкенге қосқанда бірінші сұрақ бірдей естіледі: «токенді қайдан алу керек». Кабинеттегі бөлім бір жылда орнын ауыстырып, атауын өзгертті, токен түрі төртеу болды, ал іздеудегі нұсқаулықтардың көбі әлі күнге «Настройки → Доступ к API» дегенге апарады, ондай бөлім енді жоқ. Төменде WB-нің 2026 жылғы 18 мамырдағы өзекті нұсқаулығы бойынша жол, WB білім базасының 5 тамыздағы түр таңдау ережелері және нұсқаулықтар үндемейтін бір лимит тұзағы.
Қысқаша: токенді тек кабинет иесі «API бойынша интеграциялар» бөлімінде жасайды (Профиль → Интеграции по API). Ол 180 күн жарамды, бір рет қана көрсетіледі, бір дүкенге белсенді токен саны 20-ға дейін. Өз бағдарламаңызға немесе қораптағы 1С-ке жеке токен, Шешімдер каталогындағы бұлттық сервиске сервистік токен, қалған бұлтқа базалық токен керек. Токенді dev.wildberries.ru/jwt сайтында, бөгде сайттарсыз тексеруге болады.
Wildberries API токені дегені не
Токен дүкен деректерін адам емес, бағдарлама оқитын кезде керек. Бухгалтерия салық үшін сатылымдарды алады, аналитика сервисі сағат сайын тапсырыстар мен қалдықтарды оқиды, репрайсер түнде бағаларды өзгертеді. Осындай әр бағдарламаға кабинеттің логині мен паролін беруге болмайды, сондықтан WB оған шектеулі құқығы бар токен береді.
| Токен бағдарламаға нені береді | Токен нені бермейді |
|---|---|
| Белгіленген бөлімдерді оқу: тапсырыстар, есептер, қалдықтар, карточкалар, жарнама | Логин және пароль арқылы кабинетке кіру |
| «Оқу және жазу» деңгейі таңдалса, деректерді өзгерту: бағалар, қалдықтар, карточкалар | Ақша шығару немесе деректемелерді өзгерту |
| Мерзім аяқталғанға дейін сіздің қатысуыңызсыз жұмыс істеу | 180 күннен артық жұмыс істеу: одан кейін жаңа токен керек |
Дереккөз: WB-нің 2026 жылғы 18 және 28 мамырдағы токендер туралы нұсқаулықтары
WB API токені нүктемен бөлінген үш блоктан тұратын жол, ол «eyJ» таңбаларынан басталады. Техникалық тұрғыдан бұл RFC 7519 стандарты бойынша JWT: ішінде токен түрі, сатушының идентификаторы, жарамдылық мерзімі және қолжетімділік санаттарының биттік маскасы жатыр. Сондықтан токеннің өзінен оның түрі мен қай күнге дейін жарамды екенін білуге болады, бұны қалай істеу керегі төменде талданады.
2023–2024 жылдардағы нұсқаулықтардан келген ескі атаулар, «статистика кілті», «контент кілті», «жаңа API кілті», бүгін бір нәрсені білдіреді: бір токеннің ішіндегі санаттар. Бөлек кілттер енді жоқ, құсбелгілер жиынтығы бар бір токен ғана бар.
WB кабинетінен API токенді қайдан табуға болады
WB Партнёры кабинетінде: оң жақ жоғарыдағы заңды тұлғаның атауы, содан кейін «Профиль» және «API бойынша интеграциялар» бөлімі. Бөлімді тек профиль иесі көреді. Қандай құқығы болса да, менеджер «тек аккаунт иесіне қолжетімді» деген бітеуішті көреді және онымен ештеңе істей алмайды.
Мұнда іздейтін, бірақ таба алмайтын үш нәрсе:
- Дайын токенді қайта қарау мүмкін емес. WB оны жасау кезінде бір рет көрсетеді. Одан кейін тізімде карточка қалады: атауы, жарамдылық мерзімі, қолжетімділік деңгейі, санаттар. Жолды жоғалтсаңыз, жаңасын шығарасыз.
- Ескі жол жұмыс істемейді. Іздеу нәтижесіндегі мақалалардың көбінде тұрған «Настройки → Доступ к API» өткен шақта қалды: WB-нің 2026 жылғы 18 мамырда жаңартылған нұсқаулығы бойынша бөлім профильде тұрады және «API бойынша интеграциялар» деп аталады.
- Токен қызметкерге емес, иесіне байланған. Дүкен иесі ауысқанда барлық токен жұмысын тоқтатады, жаңа иесіне оларды қайта шығару керек.
Тақырып бойынша келесі: Wildberries аналитикасы тегін: кабинет 2026 жылы не береді
Токеннің қай түрін таңдау керек
Түрі төртеу, әрі таңдауды сервис емес, бағдарлама тұрған орын белгілейді. WB білім базасының 2026 жылғы 5 тамыздағы «Бұлттық сервис пе әлде жергілікті шешім бе: қандай токен таңдау керек» мақаласында дәл солай тұжырымдалған.
- Жеке. Өз бағдарламаларыңызға және өз инфрақұрылымыңыздағы қораптағы жүйелерге: компания серверіндегі 1С, ERP, жалға алынған VPS-тегі скрипт. Кеңейтілген санаттарды, оның ішінде пайдаланушыларды басқаруды ашады. Жасау кезінде «токенді үшінші тұлғаларға беруге болмайтынын түсінемін» деген ескертумен келісу керек. Бұлттық сервистерде оны пайдалануға болмайды.
- Сервистік. WB Шешімдер каталогындағы бұлттық сервиске. Санаттар сервистің талаптарына қарай автоматты толтырылады, токен тек сонымен жұмыс істейді. Сервис OAuth 2.0-ді қолдаса, токен мүлде керек емес: қолжетімділік бір басумен беріледі және қалған интеграциялардан бөлек кері қайтарылады.
- Базалық. Каталогтан тыс бұлттық сервистерге және интеграцияны нақты деректерде тексеруге. Санаттар мен қолжетімділік деңгейін өзіңіз таңдайсыз.
- Сынақ. Тек жасанды деректері бар WB API сынақ ортасымен жұмыс істейді, нақты дүкенді көрмейді.
Енді тұзақ. Сервистік құпиясы жоқ базалық токеннің сұраныс лимиттері жеке токенмен салыстырғанда жүздеген және мыңдаған есе төмен. Біз WB API құжаттамасындағы 70 әдістің Request limit кестелерін қарап шықтық, солардың жетеуі мынадай:
| WB API әдісі | Базалық токен, сағатына сұраныс | Жеке токен, сағатына сұраныс |
|---|---|---|
| Медианауқандар тізімі | 1 | 36 000 |
| Жарнама науқандары | 1 | 18 000 |
| Бағасы бар тауарлар | 4 | 6 000 |
| Жарнама шотының балансы | 2 | 3 600 |
| Қайтару өтінімдері | 1 | 1 200 |
| Науқандар статистикасы | 1 | 180 |
| Күндік тапсырыстар | 2 | 60 |
Дереккөз: dev.wildberries.ru, 70 әдістің Request limit кестелері, 2026 жылғы 5 қыркүйектегі кесінді. Сервистік құпиясы жоқ базалық токен.
Жарнама науқандарының тізімін жеке токен секундына 5 рет сұрайды, базалық сағатына бір рет. Науқандар статистикасы: минутына 3 сұраныс, сағатына бір сұранысқа қарсы. Жарнама шотының балансы: секундына бір рет, сағатына екі ретке қарсы. WB ең жұмсақ болғаны «Маркетплейс» санаты: онда базалық токен жекенің жартысын алады, минутына 150 сұраныс, 300-ге қарсы. Қалған санаттардың бәрінде айырма 15 еседен (ұсынылған мөлшерлемелер) 36 000 есеге дейін (медианауқандар тізімі). Мұндай лимитте ешбір кабинет цифрларды сағатына бір реттен жиі жаңарта алмайды.
Қалыпты лимиттерді базалық токен тек сервистік құпиямен бірге алады: сервис WB API платформасында тіркеліп, әр сұранысқа құпияны қосады. Сондықтан токенді бұлттық сервиске салар алдында одан бір нәрсені сұраған жөн: ол Шешімдер каталогында ма әлде WB-де тіркелген бе. Екеуі де болмаса, ондағы деректер сағатына бір рет қана жаңарып отырады.
Wildberries API токенін қадам бойынша қалай жасау керек
Жолды білсеңіз, жасау екі минут алады. WB нұсқаулығы бойынша тәртіп мынадай:
- Кабинетке иесінің атынан кіріңіз: «Профиль» → «API бойынша интеграциялар» → «+ Токен жасау».
- Қойындыны таңдаңыз. «Каталогтағы сервис үшін» сервистік токен жасайды: сервисті іздеуден тауып, оны таңдайсыз. «Қолмен интеграциялау үшін» жеке, базалық және сынақ токенін ашады.
- Токенді ол шығарылған жүйенің атымен атаңыз: «Сервердегі 1С», «аналитика сервисі». Жарты жылдан кейін атауы бойынша нақты нені жаңарту керегін түсінесіз.
- Деректер санаттары мен қолжетімділік деңгейін белгілеңіз: «оқу және жазу» немесе «тек оқу». Сынақ токенінде бұл қадам жоқ, сынақ ортасы толығымен ашық.
- Қаласаңыз, түсініктеме қосыңыз. Ол профильдің барлық пайдаланушысына көрінеді және жасалғаннан кейін өзгермейді. Жеке токен үшін тәуекелдер туралы құсбелгіні қойыңыз.
- «Жасау» түймесін, содан кейін «Көшіріп алып жабу» түймесін басыңыз. Токен алмасу буферінде тұр, екінші рет WB оны көрсетпейді. Оны бірден сервис баптауларына салып, көшірмесін парольдер менеджерінде сақтаңыз.
Қандай қолжетімділік санаттарын белгілеу керек
Тек нақты бағдарлама пайдаланатындарын ғана, әрі әр сервиске бір токеннен. Бұл WB ұсынысы: токен ағып кетсе, ол бөгде адамға тек белгіленген бөлімдерді ашады. Санат саны он үш:
- Контент: тауар карточкалары, сипаттамалар, фото мен видео, жапсырмалар.
- Аналитика: сату шұңғымасы, қалдықтар мен ақылы сақтау есептері, өңірлер бойынша сатылымдар, қайтарулар. Бұл әдістердің қайсысы «Jem» жазылымынсыз жұмыс істейтінін WB аналитикасы тегін туралы мақалада талдадық.
- Бағалар мен жеңілдіктер: баға қою, акциялар күнтізбесі.
- Маркетплейс: сатушы қоймалары, FBS, DBS және DBW тапсырыстары.
- Статистика: негізгі есептер, оның ішінде тапсырыстар, сатылымдар және апталық өткізу есептері.
- Жылжыту: науқандар, мөлшерлемелер, бюджеттер, жарнама статистикасы.
- Сұрақтар мен пікірлер, Сатып алушылармен чат: сатып алушыларға жауаптар.
- Жеткізілімдер: FBW қабылдау слоттары мен коэффициенттері, кабинетте қабылданған оферта талап етіледі.
- Сатып алушылардың қайтарулары, Құжаттар, Қаржы (баланс және қаржылық есептер), Пайдаланушылар (тек жеке токенде).
| Санат | Нені ашады | Аналитика | Автоматтандыру |
|---|---|---|---|
| Контент | карточкалар, сипаттамалар, фото | оқу | оқу және жазу (сипаттамалар) |
| Аналитика | шұңғыма, қалдықтар, сақтау, өңірлер | оқу | оқу |
| Бағалар мен жеңілдіктер | бағалар, акциялар күнтізбесі | оқу | оқу және жазу (автобағалар) |
| Маркетплейс | сатушы қоймалары, FBS/DBS тапсырыстары | қажет емес | міндетке қарай |
| Статистика | тапсырыстар, сатылымдар, апталық есеп | оқу | оқу |
| Жылжыту | науқандар, мөлшерлемелер, бюджеттер | оқу | оқу және жазу (автобидер) |
| Сұрақтар мен пікірлер | сатып алушыларға жауаптар | қажет емес | оқу және жазу (AI жауаптар) |
| Сатып алушы чаты | диалогтар | қажет емес | міндетке қарай |
| Жеткізілімдер | FBW слоттары мен коэффициенттері | қажет емес | міндетке қарай |
| Қайтарулар | қайтару өтінімдері | оқу | оқу |
| Құжаттар | жабу құжаттары | қажет емес | міндетке қарай |
| Қаржы | баланс, қаржылық есептер | оқу | оқу |
| Пайдаланушылар | тек жеке токенде | қажет емес | қажет емес |
Дереккөз: WB-нің 18.05.2026 жылғы «API бойынша интеграциялар» нұсқаулығы; WB ұсынысы: әр сервиске бір токен, тек қажетті санаттар
Аналитика сервисіне әдетте «тек оқу» режиміндегі Статистика, Аналитика, Контент, Бағалар, Жылжыту және Қаржы жеткілікті. Мөлшерлемелерді, бағаларды немесе пікірлерге жауаптарды автоматтандыру тек «оқу және жазу» кезінде жұмыс істейді. Жасалып қойған токенге санат қосу мүмкін емес, жаңасын шығаруға тура келеді: сервисте қолжетімділігі жоқ бөлім жай ғана бос қалады.
Токен қанша уақыт жарамды және оны қалай жаңарту керек
Жасалған сәттен бастап 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 күнге жетпей жұмысын тоқтатса, не істеу керек? Оны декодерде тексеріңіз. «Кері қайтарылған» мәртебесі оны кабинетте біреу жойғанын білдіреді, «Белсенді емес» иесінің ауысқанын немесе бұғаттауды көрсетеді. Екі жағдайда да иесінің атынан жаңа токен шығарыңыз.
