Нарықтардың техникалық кедергілері: API қателері, FTP шектеулері және «Жойылған» күйі

Диагностика және ақауларды жою нұсқаулығы (Troubleshooting Guide)

Бұл материал есеп жүйесін маркетплейстермен (Prom.ua, Rozetka) синхрондау кезінде және FTP-серверлерімен жұмыс барысында жиі кездесетін техникалық мәселелерді жылдам шешуге арналған.

1-блок. Prom.ua API мәселелері: 401 қателері, Import forbidden және қатарлас жүктеулер

Prom.ua маркетплейсімен жұмыс істегенде пайдаланушылар API-ге қолжетімділіктің бұғатталуымен жиі кездеседі. Соның салдарынан тапсырыстар жүктелмейді, ал тауарлар сайтта жаңартылмайды.

1-симптом. «401 Not Authenticated» немесе «Import forbidden» қатесі

Белгілері. Тапсырыстарды жүктеу немесе тауарларды шығару кезінде бағдарлама 401 Not Authenticated хабарламасын көрсетеді. API-кілттің жарамдылығын тексеріңіз немесе Import forbidden. 

Себептері:

1. API-кілт жоқ немесе мерзімі өткен. Prom.ua кабинетіндегі қолжетімділік токенінің мерзімі аяқталған немесе кілт синхрондау объектісінің баптауларында мүлде көрсетілмеген.

2. Құқықтар жеткіліксіз (Import forbidden). Prom.ua сатушысының жеке кабинетінде белсенді токен үшін тек «Оқу» құқығы орнатылған, бұл бағдарламаға маркетплейске өзгерістер енгізуге және деректерді жазуға тыйым салады.

Шешімі:

1. Prom.ua жеке кабинетінде «Баптаулар» → «API-токендерді басқару» бөліміне өтіңіз.

2. Кілттің жарамдылық мерзімін тексеріңіз. Егер мерзімі аяқталса, жаңа API-кілт жасаңыз.

3. Қолжетімділік құқықтарын тексеріңіз: «Өнімдер мен топтар» бөлімінде мәнді міндетті түрде «Оқу» күйінен «Оқу және жазу» күйіне өзгертіңіз.

4. Жаңа токенді көшіріп, оны Торгсофт синхрондау объектісінің баптауларына қойыңыз және жүктеуді қайталаңыз.

2-симптом. «Too Many Requests» немесе «Bot protection» қателері

Белгілері. Синхрондау Too Many Requests немесе Bot protection қателерімен үзіледі. 

Себебі. Prom.ua маркетплейсі қатарлас жүктеулерге тыйым салатын жаңа шектеулер енгізді. Егер автоматты синхрондау жүріп жатқан кезде қолмен синхрондауды қатар іске қоссаңыз немесе бірнеше автоматты тапсырма бір уақытқа бапталған болса (синхрондау уақытының көшірмелері), маркетплейс қорғанысы іске қосылып, қосылым бұғатталады. 

Шешімі:

1. Синхрондау журналын талдап, тапсырмалар кестесін тексеріңіз.

2. Автоматты синхрондау таймері жұмыс істеп тұрғанда жүктеуді қолмен іске қоспаңыз.

3. Қатарлас автоматты жүктеулердің бірқатарында тауарларды синхрондауды өшіріңіз немесе оларды әртүрлі уақытқа бөліңіз.

2-блок. Фотосуреттерді FTP-ге жүктеу: форматтар, префикстер және орынның жетіспеуі

Медиаконтент маркетплейстерге көбінесе FTP-серверлер арқылы беріледі. Бұл кезеңдегі мәселелер тауарлардың суретсіз жүктелуіне әкеледі.

1-симптом. Фотосуреттер FTP-ге сәтті жүктелді, бірақ сайтта көрсетілмейді

Себебі. FTP-сервер дұрыс бапталмаған немесе HTTP-префикс жоқ. FTP-сервердің өзі тек файлдарды сақтайды. Маркетплейс оларды жүктей алуы үшін FTP-сервер Web-сервер ретінде жұмыс істеуі, интернет арқылы қолжетімді болуы, ал фотосуреттерге сілтемелер тікелей болуы керек. 

Шешімі:

1. FTP-серверіңіздің Web-сервер ретінде бапталғанына көз жеткізіңіз.

2. Синхрондау объектісінің баптауларында міндетті түрде Фотосуреттерге сілтеме префиксін көрсетіңіз, мысалы, http://сіздің-домен.com/images/. Бағдарлама осы префикске файл атауын қосып, маркетплейс үшін тікелей сілтеме жасайды.

2-симптом. «Transfer aborted. Input/output error» қатесі немесе қосылымның үзілуі

Белгілері. Синхрондау журналында Тауар фотосуретін жіберу қатесі... Transfer aborted. Input/output error немесе Read timed out сияқты қателер пайда болады. 

Себебі. Ең жиі себеп — хостингте немесе FTP-серверде фотосуреттерді жүктеуге арналған бос орынның таусылуы. Сондай-ақ жүктеу FTP-сервердің өз тарапынан файл санына қойылған шектеулерге (inode) немесе қосылым тайм-ауттарына байланысты үзілуі мүмкін. 

Шешімі:

1. FTP-хостинг әкімшісіне хабарласыңыз немесе басқару панелінде дискідегі бос орынның бар-жоғын тексеріңіз.

2. Ескірген фотосуреттерді жойыңыз немесе хостинг тарифтік жоспарын үлкенірегіне ауыстырыңыз.

3-симптом. WebP форматы қолдау таппағандықтан суреттерді жүктеу қатесі

Белгілері. Сілтеме арқылы фото қосу немесе жүктеу кезінде Суретті жүктеу мүмкін болмады қатесі немесе Cannot create file пайда болады. 

Себебі. Сурет заманауи .webp форматында болуы мүмкін, тіпті сілтеменің соңында .jpeg немесе .jpg деп жазылса да, файл шын мәнінде WebP форматында қысылған болуы ықтимал. Қазіргі уақытта бағдарлама жүйелік компоненттердің шектеулеріне байланысты .webp форматымен жұмыс істеуді қолдамайды. 

Шешімі. Стандартты сурет форматтарын пайдаланыңыз, мысалы .jpg, .jpeg, .png немесе .bmp. Егер фотосуретті интернеттен жүктесеңіз, алдымен WebP файлын JPEG немесе PNG форматына түрлендіріңіз.

3-блок. Rozetka-дағы мәселелер: қысқартылған прайс-параққа байланысты «Жойылған» мәртебесі

Rozetka маркетплейсі бағалар мен тауарлардың қолжетімділігі туралы ақпаратты есеп жүйесі қалыптастыратын XML прайс-парағы негізінде жаңартады.

Симптом. Rozetka-дағы мыңдаған тауар кенеттен «Жойылған» мәртебесін алды

Белгілері. Rozetka.ua маркетплейсіндегі ассортименттің дерлік барлығына «Жойылған» мәртебесі қойылған. 

Себебі. Автоматты жүктеу кезіндегі ақаулар. FTP-серверге мезгіл-мезгіл шағын көлемді қысқартылған немесе толық емес прайс-парақ жүктеледі, онда тауарлардың көпшілігі жоқ болады. Егер Rozetka мұндай файлды оқыса, ол тауарлар енді қолжетімді емес деп есептеп, оларды жаппай жойылған деп белгілейді. Көбінесе қысқартылған файл қатарлас процестердің қақтығысынан қалыптасады, мысалы, қолмен жүктеу автоматты жүктеумен қабаттасқанда немесе файлды қайта жазу кезінде FTP-де ақау болғанда. 

Шешімі:

1. Жылдам қалпына келтіру. Бағдарламада Rozetka-мен қолмен синхрондауды орындаңыз. Бұл барлық тауарлары бар қалыпты көлемдегі толық прайс-парақты қалыптастырып, оны FTP-ге жүктейді.

2. Келесі жаңарту сеансы кезінде Rozetka прайс-парақты бір сағаттық аралықпен оқиды, маркетплейс толық файлды өңдейді, және барлық тауарлар қалыпты күйіне оралады.

3. Алдын алу. Кесте бойынша тапсырмалар баптауларын тексеріңіз. Жүйе XML-файлды қалыптастыруды дұрыс аяқтап үлгеруі үшін Rozetka-мен бірнеше синхрондауды бір уақытта іске қоспаңыз.