Hatalar
Yaygın Listano Control MCP hataları ve kurtarma rehberliği.
Listano Control MCP araçları; kimlik doğrulama, izinler, doğrulama, hazırlık kontrolleri veya arka uç istek hatalarından kaynaklanan hatalar döndürebilir.
En güvenli kurtarma düzeni şöyledir:
- hatayı inceleyin
- izinler belirsizse
whoamiçağırın - geçerli taslak durumu belirsizse
get-offeringçağırın - yalnızca geçersiz veya eksik verileri düzeltin
- yayımlamadan önce
check-offering-publish-readinesstekrar çağırın
İzin hataları
İzin hatası, kimliği doğrulanmış entegrasyonun gerekli kapsama sahip olmadığı anlamına gelir.
| İşlem | Gerekli kapsam |
|---|---|
| listeleme/okuma/kontrol | catalog:read |
| oluşturma/güncelleme/çevirme/iptal etme | catalog:write |
| yayımlama/sonlandırma | catalog:publish |
Kurtarma:
whoamiçağırın- verilen kapsamları doğrulayın
- eksik kapsamın verilmesini isteyin
Bulunamadı hataları
Aşağıdaki durumlarda bir teklif bulunamayabilir:
offeringIdhatalı- teklif başka bir şirkete ait
- entegrasyon farklı bir şirket için kimlik doğrulaması yapmış
Kurtarma:
- başlık, SKU veya bilinen başka bir tanımlayıcı kullanarak
list-offeringsçağırın - değişiklik yapmadan önce seçilen teklifi doğrulayın
Doğrulama hataları
Doğrulama hataları genellikle giriş şeklinin veya alan değerinin geçersiz olduğu anlamına gelir.
Yaygın nedenler:
| Neden | Düzeltme |
|---|---|
category_label olmadan category_id | Her iki alanı da sağlayın. |
| Geçersiz dil kodu | get-supported-languages kullanın. |
| Çevirilere dahil edilen ana dil | Ana dili çeviri verisinden kaldırın. |
| Geçersiz birim kodu | Geçerli 3 karakterli birim kodu kullanın. |
Nitelikte unit var ama sayısal olmayan değer | Sayısal değer kullanın. |
Nitelikte valueLabel var ama dize olmayan değer | Dize değeri kullanın. |
kind veya language değiştirme girişimi | Taslağı iptal edin ve yeni teklif oluşturun. |
Yayın hazırlığı hataları
check-offering-publish-readiness şunu döndürür:
{
offeringId: string
publishable: boolean
errors: unknown[]
}publishable değeri false olduğunda publish-offering çağırmayın.
Yaygın hazırlık sorunları:
- eksik ana dil başlığı, açıklaması veya ölçü birimi
- desteklenen ana dil dışındaki diller için eksik çeviriler
- eksik çevrilmiş kategori etiketleri
- eksik nitelik çevirileri
- geçersiz nitelik değeri/birim kombinasyonu
- eksik çevrilmiş nitelik açıklamaları veya değer etiketleri
Kurtarma:
- döndürülen hataları düzeltin
check-offering-publish-readinesstekrar çağırın- yalnızca
publishabledeğeritrueolduğunda yayımlayın
Taslak yaşam döngüsü hataları
kind veya language hatalıysa yamalamaya çalışmayın.
Bu alanlar değiştirilemez. Doğru kurtarma yolu, discard-offering-draft ile taslağı iptal etmek ve yeni bir teklif oluşturmaktır.
Bir teklifin zaten yayımlanmış güncel sürümü varsa, taslağı iptal etmek canlı sürümü kaldırmaz.
Yayımlama hataları
Taslak eksik veya geçersizse publish-offering başarısız olabilir.
Kurtarma:
check-offering-publish-readinessçağırın- döndürülen hataları düzeltin
- yalnızca hazırlık başarılı olduktan sonra yayımlamayı deneyin
Arka uç istek hataları
Arka uç isteği geçerli bir yanıt döndürmeden başarısız olursa araç istek hatası döndürebilir.
Kurtarma:
- uygunsa aynı salt okunur işlemi yeniden deneyin
- mevcut durum
get-offeringile kontrol edilmedikçe değişiklik çağrılarını tekrarlamaktan kaçının - hata devam ederse hata mesajını bildirin