Hibák
Gyakori Listano Control MCP hibák és helyreállítási útmutatás.
A Listano Control MCP eszközök hibákat adhatnak vissza hitelesítési, engedély-, érvényesítési, felkészültségellenőrzési vagy háttér-kérési problémák esetén.
A legbiztonságosabb helyreállítási minta:
- vizsgálja meg a hibát
- hívja meg a
whoamieszközt, ha az engedélyek nem egyértelműek - hívja meg a
get-offeringeszközt, ha az aktuális vázlat állapota nem egyértelmű - csak a konkrét érvénytelen vagy hiányzó adatot javítsa
- a közzététel előtt hívja meg ismét a
check-offering-publish-readinesseszközt
Engedélyhibák
Engedélyhiba azt jelenti, hogy a hitelesített integráció nem rendelkezik a szükséges hatókörrel.
| Művelet | Szükséges hatókör |
|---|---|
| listázás/olvasás/ellenőrzés | catalog:read |
| létrehozás/frissítés/fordítás/elvetés | catalog:write |
| közzététel/megszüntetés | catalog:publish |
Helyreállítás:
- hívja meg a
whoamieszközt - erősítse meg a megadott hatóköröket
- kérje a hiányzó hatókör megadását
Nem találtuk hibák
Egy ajánlat nem található, ha:
- az
offeringIdhibás - az ajánlat egy másik vállalathoz tartozik
- az integráció egy másik vállalat számára van hitelesítve
Helyreállítás:
- hívja meg a
list-offeringseszközt cím, SKU vagy más ismert azonosítóval - erősítse meg a kiválasztott ajánlatot módosítás előtt
Érvényesítési hibák
Az érvényesítési hibák általában azt jelzik, hogy a bemenet alakja vagy mező értéke érvénytelen.
Gyakori okok:
| Ok | Megoldás |
|---|---|
category_id category_label nélkül | Adja meg mindkét mezőt. |
| Érvénytelen nyelvkód | Használja a get-supported-languages eszközt. |
| A főnyelv szerepel a fordításokban | Távolítsa el a főnyelvet a fordítási adatokból. |
| Érvénytelen mértékegységkód | Használjon érvényes 3 karakteres mértékegységkódot. |
Az attribútumnak van unit értéke, de nem szám az értéke | Használjon numerikus értéket. |
Az attribútumnak van valueLabel értéke, de nem string az értéke | Használjon string értéket. |
Kísérlet a kind vagy language módosítására | Vesse el a vázlatot és hozzon létre új ajánlatot. |
Közzétételre való felkészültség hibái
A check-offering-publish-readiness eszköz a következőt adja vissza:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Ha a publishable értéke false, ne hívja meg a publish-offering eszközt.
Gyakori felkészültségi problémák:
- hiányzó főnyelvi cím, leírás vagy mértékegység
- hiányzó fordítások a támogatott nem főnyelvekhez
- hiányzó lefordított kategóriacímkék
- hiányzó attribútumfordítások
- érvénytelen attribútumérték/mértékegység kombináció
- hiányzó lefordított attribútumleírások vagy értékcímkék
Helyreállítás:
- javítsa a visszaadott hibákat
- hívja meg ismét a
check-offering-publish-readinesseszközt - csak akkor tegyen közzé, ha a
publishableértéketrue
Vázlat életciklus hibái
Ha a kind vagy a language hibás, ne próbálja meg javítani.
Ezek a mezők megváltoztathatatlanok. A helyes helyreállítás a vázlat elvetése a discard-offering-draft eszközzel és egy új ajánlat létrehozása.
Ha egy ajánlatnak már van közzétett jelenlegi verziója, a vázlat elvetése nem távolítja el az élő verziót.
Közzétételi hibák
A publish-offering eszköz meghiúsulhat, ha a vázlat hiányos vagy érvénytelen.
Helyreállítás:
- hívja meg a
check-offering-publish-readinesseszközt - javítsa a visszaadott hibákat
- csak a felkészültség ellenőrzése után próbáljon közzétenni
Háttér-kérési hibák
Egy eszköz visszaadhat lekérési hibát, ha a háttéroldali kérés érvényes válasz visszaadása előtt meghiúsul.
Helyreállítás:
- próbálja újra a csak olvasható műveletet, ha indokolt
- kerülje a módosítási hívások ismétlését, hacsak az aktuális állapot nem lett ellenőrizve a
get-offeringeszközzel - ha a hiba továbbra is fennáll, jelezze a hibaüzenetet