Limity API, interwały i opóźnienia w przypadku dużych katalogów

Dlaczego aktualizacje cen przez API mogą trwać dłużej?

Ten artykuł dotyczy sytuacji, gdy B2BLIX obliczył nowe ceny, ale zmiany pojawiają się na Pigu, 220.lv, Kaup24.ee lub HobbyHall.fi później, niż oczekiwano.

Szybkość publikowania przez API zależy między innymi od liczby przetwarzanych produktów. Mniejszy katalog można zwykle przetwarzać częściej niż katalog zawierający dziesiątki lub setki tysięcy produktów.

Krótka odpowiedź

B2BLIX automatycznie dostosowuje interwał eksportu API do łącznej liczby produktów na koncie. W miarę rozrastania się katalogu system może stosować dłuższy interwał, aby eksport mógł zostać bezpiecznie przetworzony w ramach limitów API marketplace'u.

Liczba produktów jest uwzględniana dla wszystkich połączonych marketplace'ów Pigu Group, a nie osobno dla każdego marketplace'u.

Jeśli katalog stanie się zbyt duży dla obsługiwanego procesu publikowania przez API, B2BLIX może przełączyć wyjście z powrotem na XML. Wyniki obliczeń XML mogą być nadal prawidłowe, nawet gdy publikowanie na żywo przez API jest opóźnione lub niedostępne dla całego katalogu.

Obliczona lub przygotowana cena nie musi być jeszcze widoczna na marketplace'ie. Cena staje się aktywna dopiero po wyeksportowaniu, zaakceptowaniu i zastosowaniu jej przez marketplace. Przed uznaniem, że obliczona cena została pomyślnie opublikowana, sprawdź raport synchronizacji.

Jak limity żądań API wpływają na eksport

Pigu stosuje limity żądań dla swojego API. Na przykład w dokumentacji API opisano limit 500 żądań na 10 sekund dla procesu aktualizacji ofert.

B2BLIX przestrzega limitów API marketplace'ów. Oznacza to, że usługa nie może wysłać jednocześnie nieograniczonej liczby aktualizacji produktów, nawet gdy wiele cen jest gotowych do publikacji.

Limity te pomagają chronić usługę marketplace'u przed nadmiernym ruchem. Nie oznaczają, że każde konto może zawsze publikować 500 zmian produktów co 10 sekund. Rzeczywisty czas przetwarzania może również zależeć od rozmiaru katalogu, liczby marketplace'ów, czasu odpowiedzi API marketplace'u oraz liczby aktualizacji oczekujących w kolejce publikowania.

Limity API marketplace'u mogą się zmieniać. Aktualną dokumentację API Pigu należy traktować jako wiążące źródło najnowszych informacji o limicie żądań.

Jak rozmiar katalogu zmienia interwał eksportu

B2BLIX wykorzystuje przedziały liczby produktów do określenia odpowiedniego interwału eksportu API. Dokładne wewnętrzne progi nie są publikowane, ponieważ mogą być dostosowywane wraz ze zmianami usługi i integracji z marketplace'ami.

W praktyce proces wygląda następująco:

Mniejszy katalog może korzystać z krótszego interwału eksportu API.
Gdy łączna liczba produktów wzrasta, B2BLIX automatycznie wybiera dłuższy interwał.
Łączna liczba obejmuje produkty ze wszystkich połączonych marketplace'ów Pigu Group.
Bardzo duże katalogi mogą wymagać więcej czasu na ukończenie każdej kolejki publikowania.
Jeśli katalog przekroczy obsługiwaną liczbę produktów dla API, wyjście może zostać zmienione na XML.

Dłuższy interwał nie musi oznaczać błędu. Może być oczekiwanym rezultatem przetwarzania większej liczby produktów przy jednoczesnym przestrzeganiu limitów API.

Co sprawdzić na swoim koncie

1. Potwierdź bieżącą metodę eksportu

Sprawdź, czy na Twoim koncie skonfigurowano publikowanie cen przez API, czy generowanie wyjścia XML. Sprawdź również skonfigurowaną częstotliwość synchronizacji i ustawienia aktualizacji.

Aby sprawdzić to na swoim koncie, otwórz Ustawienia synchronizacji.
Aby poznać znaczenie pól na tej stronie, przeczytaj Ustawienia synchronizacji: konfiguracja importu produktów i eksportu cen.

Przed zmianą metody lub częstotliwości eksportu sprawdź, ile produktów zawiera obecnie źródło oraz czy to samo źródło obejmuje produkty dla kilku marketplace'ów.

2. Sprawdź najnowszy raport synchronizacji

Raport synchronizacji pomaga odróżnić obliczanie od publikowania. Sprawdź, czy ostatnie uruchomienie zostało zakończone, ile produktów przetworzono oraz czy podczas eksportu zgłoszono ostrzeżenia lub błędy.

Aby sprawdzić to na swoim koncie, otwórz Raporty synchronizacji.
Aby poznać znaczenie statusów raportu i podsumowań elementów, przeczytaj Raporty synchronizacji: przegląd wyników importu, obliczeń BuyBox i eksportu.

3. Sprawdź jeden produkt, którego dotyczy problem

Jeśli opóźnienia dotyczą tylko niektórych cen, sprawdź konkretny EAN w narzędziu Sprawdzanie produktu. Pomoże to potwierdzić obliczoną cenę i najnowszy znany status eksportu tego produktu.

Aby sprawdzić to na swoim koncie, otwórz Sprawdzanie produktu.
Aby poznać przedstawione tam informacje o danych produktu, obliczeniach i eksporcie, przeczytaj Sprawdzanie produktu: przegląd danych produktu, obliczeń cen i eksportów.

Typowe przyczyny wolniejszego publikowania przez API

Łączny katalog się powiększył. Produkty ze wszystkich połączonych marketplace'ów wpływają na wielkość katalogu wykorzystywaną do wyboru interwału eksportu.
Podczas tej samej synchronizacji zmieniła się duża liczba cen. Większa liczba zmian tworzy większą kolejkę publikowania.
API marketplace'u przetwarza aktualizacje wolniej. B2BLIX musi oczekiwać na odpowiedzi API marketplace'u i przestrzegać jego limitów żądań.
Eksport API jest nadal w toku. Obliczenia mogły zakończyć się, zanim każda przygotowana aktualizacja została opublikowana.
Wyjście zostało przełączone na XML. W przypadku katalogu przekraczającego obsługiwaną liczbę produktów dla API można użyć XML zamiast bezpośredniej publikacji przez API.
Sprawdzono tylko aktywną cenę na marketplace'ie. Sprawdź Raporty synchronizacji i Sprawdzanie produktu, aby ustalić, czy opóźnienie wystąpiło podczas obliczeń, eksportu czy zastosowania zmiany przez marketplace.

Przykład

Sprzedawca importuje produkty dla 220.lv, Pigu.lt i Kaup24.ee. Połączony katalog jest znacznie większy niż liczba produktów na dowolnym pojedynczym marketplace'ie.

B2BLIX kończy obliczenia BuyBox i przygotowuje zaktualizowane ceny. Ponieważ połączony katalog jest duży, eksport API wykorzystuje dłuższy interwał przetwarzania, a aktualizacje są publikowane w kolejce. Dlatego niektóre aktywne ceny na marketplace'ach mogą nadal wyświetlać poprzednią wartość, podczas gdy kolejne produkty są wciąż przetwarzane.

Sprzedawca powinien najpierw sprawdzić najnowszy Raport synchronizacji. W przypadku pojedynczego opóźnionego produktu może następnie użyć narzędzia Sprawdzanie produktu, aby porównać jego obliczoną cenę ze statusem eksportu.

Co zrobić dalej

Otwórz Ustawienia synchronizacji i potwierdź, czy wybrane wyjście to API, czy XML.
Sprawdź łączną liczbę produktów ze wszystkich marketplace'ów uwzględnionych w źródle.
Otwórz najnowszy Raport synchronizacji i przejrzyj wyniki przetwarzania oraz eksportu.
Użyj narzędzia Sprawdzanie produktu dla jednego lub większej liczby EAN-ów, których dotyczy problem.
Nie zmieniaj wielokrotnie ustawień synchronizacji, gdy duży eksport może być nadal przetwarzany.
Jeśli wyjście XML jest prawidłowe, ale publikowanie przez API w przypadku bardzo dużego katalogu nadal stale się opóźnia, skontaktuj się z B2BLIX, aby omówić, czy odpowiednia może być dedykowana konfiguracja do obsługi dużych wolumenów.

Zgłaszając utrzymujące się opóźnienie, podaj przybliżoną łączną liczbę produktów, marketplace'y, których dotyczy problem, czas odpowiedniej synchronizacji oraz kilka przykładowych EAN-ów. Nie podawaj haseł do kont ani danych uwierzytelniających API.