Błędy
Typowe błędy Listano Control MCP i wskazówki dotyczące naprawy.
Narzędzia Listano Control MCP mogą zwracać błędy związane z uwierzytelnianiem, uprawnieniami, walidacją, sprawdzaniem gotowości lub awariami pobierania z backendu.
Najbezpieczniejszy wzorzec naprawy to:
- sprawdź błąd
- wywołaj
whoami, jeśli uprawnienia są niejasne - wywołaj
get-offering, jeśli bieżący stan wersji roboczej jest niejasny - napraw tylko konkretne nieprawidłowe lub brakujące dane
- wywołaj
check-offering-publish-readinessponownie przed publikowaniem
Błędy uprawnień
Błąd uprawnień oznacza, że uwierzytelniona integracja nie posiada wymaganego zakresu.
| Operacja | Wymagany zakres |
|---|---|
| listowanie/odczyt/sprawdzenie | catalog:read |
| tworzenie/aktualizowanie/tłumaczenie/odrzucanie | catalog:write |
| publikowanie/wycofywanie | catalog:publish |
Naprawa:
- wywołaj
whoami - potwierdź przyznane zakresy
- poproś o przyznanie brakującego zakresu
Błędy nie znaleziono
Oferta może nie zostać znaleziona gdy:
offeringIdjest błędny- oferta należy do innej firmy
- integracja jest uwierzytelniona dla innej firmy
Naprawa:
- wywołaj
list-offeringsz tytułem, SKU lub innym znany identyfikatorem - potwierdź wybraną ofertę przed jej mutowaniem
Błędy walidacji
Błędy walidacji zazwyczaj oznaczają, że kształt danych wejściowych lub wartość pola jest nieprawidłowa.
Typowe przyczyny:
| Przyczyna | Rozwiązanie |
|---|---|
category_id bez category_label | Podaj oba pola. |
| Nieprawidłowy kod języka | Użyj get-supported-languages. |
| Język główny dołączony do tłumaczeń | Usuń język główny z ładunku tłumaczeń. |
| Nieprawidłowy kod jednostki | Użyj prawidłowego 3-znakowego kodu jednostki. |
Atrybut ma unit, ale wartość niebędąca liczbą | Użyj wartości numerycznej. |
Atrybut ma valueLabel, ale wartość niebędąca ciągiem znaków | Użyj wartości tekstowej. |
Próba zmiany kind lub language | Odrzuć wersję roboczą i utwórz nową ofertę. |
Błędy gotowości do publikacji
check-offering-publish-readiness zwraca:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Gdy publishable wynosi false, nie wywołuj publish-offering.
Typowe problemy z gotowością:
- brakujący tytuł, opis lub jednostka miary w języku głównym
- brakujące tłumaczenia dla obsługiwanych języków innych niż główny
- brakujące przetłumaczone etykiety kategorii
- brakujące tłumaczenia atrybutów
- nieprawidłowa kombinacja wartości/jednostki atrybutu
- brakujące przetłumaczone opisy atrybutów lub etykiety wartości
Naprawa:
- napraw zwrócone błędy
- wywołaj
check-offering-publish-readinessponownie - publikuj tylko gdy
publishablewynositrue
Błędy cyklu życia wersji roboczej
Jeśli kind lub language jest błędne, nie próbuj ich naprawić.
Te pola są niezmienne. Prawidłowym rozwiązaniem jest odrzucenie wersji roboczej za pomocą discard-offering-draft i utworzenie nowej oferty.
Jeśli oferta ma już opublikowaną aktualną wersję, odrzucenie wersji roboczej nie usuwa aktywnej wersji.
Błędy publikowania
publish-offering może się nie powieść, jeśli wersja robocza jest niekompletna lub nieprawidłowa.
Naprawa:
- wywołaj
check-offering-publish-readiness - napraw zwrócone błędy
- próbuj publikować tylko po pomyślnym przejściu gotowości
Awarie pobierania z backendu
Narzędzie może zwrócić błąd pobierania, gdy żądanie do backendu zakończy się niepowodzeniem przed zwróceniem prawidłowej odpowiedzi.
Naprawa:
- ponów tę samą operację tylko do odczytu, jeśli to właściwe
- unikaj powtarzania wywołań mutacji, chyba że bieżący stan został sprawdzony za pomocą
get-offering - zgłoś komunikat błędu, jeśli awaria się utrzymuje