Fel
Vanliga Listano Control MCP-fel och återställningsvägledning.
Listano Control MCP-verktyg kan returnera fel från autentisering, behörigheter, validering, beredskapskontroller eller backend-hämtningsfel.
Det säkraste återställningsmönstret är:
- granska felet
- anropa
whoamiom behörigheter är oklara - anropa
get-offeringom det aktuella utkasttillståndet är oklart - åtgärda bara de specifika ogiltiga eller saknade data
- anropa
check-offering-publish-readinessigen innan publicering
Behörighetsfel
Ett behörighetsfel innebär att den autentiserade integrationen inte har det nödvändiga scopet.
| Operation | Krävt scope |
|---|---|
| lista/läsa/kontrollera | catalog:read |
| skapa/uppdatera/översätta/kassera | catalog:write |
| publicera/avveckla | catalog:publish |
Återställning:
- anropa
whoami - bekräfta beviljade scopes
- begär att det saknade scopet beviljas
Fel: hittades inte
Ett erbjudande kanske inte hittas när:
offeringIdär felaktigt- erbjudandet tillhör ett annat företag
- integrationen är autentiserad för ett annat företag
Återställning:
- anropa
list-offeringsmed en titel, SKU eller annan känd identifierare - bekräfta det valda erbjudandet innan det muteras
Valideringsfel
Valideringsfel innebär vanligtvis att indatans form eller fältvärde är ogiltigt.
Vanliga orsaker:
| Orsak | Åtgärd |
|---|---|
category_id utan category_label | Ange båda fälten. |
| Ogiltig språkkod | Använd get-supported-languages. |
| Huvudspråket inkluderat i översättningar | Ta bort huvudspråket från översättningspayloaden. |
| Ogiltig enhetskod | Använd en giltig 3-teckens enhetskod. |
Attribut har unit men icke-numeriskt värde | Använd ett numeriskt värde. |
Attribut har valueLabel men icke-strängvärde | Använd ett strängvärde. |
Försök att ändra kind eller language | Kassera utkastet och skapa ett nytt erbjudande. |
Publiceringsberedskapsfel
check-offering-publish-readiness returnerar:
{
offeringId: string
publishable: boolean
errors: unknown[]
}När publishable är false, anropa inte publish-offering.
Vanliga beredskapsproblem:
- saknad titel, beskrivning eller måttenhet på huvudspråket
- saknade översättningar för stödda icke-huvudspråk
- saknade översatta kategorietiketter
- saknade attributöversättningar
- ogiltig kombination av attributvärde och enhet
- saknade översatta attributbeskrivningar eller värdetiketter
Återställning:
- åtgärda de returnerade felen
- anropa
check-offering-publish-readinessigen - publicera bara när
publishableärtrue
Livscykelfel för utkast
Om kind eller language är fel, försök inte att patcha det.
Dessa fält är oföränderliga. Den korrekta återställningen är att kassera utkastet med discard-offering-draft och skapa ett nytt erbjudande.
Om ett erbjudande redan har en publicerad aktuell version tar kassering av utkastet inte bort den aktiva versionen.
Publiceringsfel
publish-offering kan misslyckas om utkastet är ofullständigt eller ogiltigt.
Återställning:
- anropa
check-offering-publish-readiness - åtgärda de returnerade felen
- försök publicera bara efter att beredskapen godkänts
Backend-hämtningsfel
Ett verktyg kan returnera ett hämtningsfel när backend-begäran misslyckas innan ett giltigt svar returneras.
Återställning:
- försök igen med samma skrivskyddade operation om lämpligt
- undvik att upprepa mutationsanrop om inte det aktuella tillståndet har kontrollerats med
get-offering - rapportera felmeddelandet om felet kvarstår