Ana içeriğe atla
Plato API’leri mümkün olan yerlerde JSON hata iletilerini döndürür.

​
Hata Şekli

REST uç noktaları genellikle şu şekillerden birini döndürür: 
{
  "message": "No apiKey provided."
}
``````json
{
  "error": "Unauthorized API key."
}
SDK çağrıları, yazılan tRPC hatalarına neden olur. Entegrasyonunuzda bunları yakalayın ve mesajı, durumu ve prosedür adını günlüğe kaydedin.

​
Ortak Durum Kodları

DurumAnlam
400İstek geçersiz, gerekli alanlar eksik veya doğrulama başarısız.
401API anahtarı eksik, süresi dolmuş, geçersiz veya işlem için izin verilmiyor.
403API anahtarı geçerli ancak rolü gerekli izne sahip değil.
404İstenen kayıt API anahtar çalışma alanında mevcut değil.
429Rota hız sınırlıdır. Yavaşlayın ve daha sonra tekrar deneyin.
500Plato isteği tamamlayamadı. Daha sonra tekrar deneyin veya tekrarlanırsa destek ekibiyle iletişime geçin.

​
Sayfalandırma Sınırları

Farklı API’ler farklı sayfalandırma stillerini ortaya çıkarır. CMS listesi uç noktaları şunları kullanır: 
limit: 1 to 100
offset: 0 or higher
Menü uç noktaları şunları kullanır: 
page: 1 or higher
limit: 1 to 100
Connect360 SDK listesi uç noktaları imleçleri kullanır: 
{
  limit: 50,
  cursor: "next_cursor"
}

​
Sipariş Besleme Sınırları

Restoran siparişi feed’i, istek başına en fazla 50 siparişi döndürür. Hem date hem de endDate sağlandığında tarih aralıkları 5 güne kadar olabilir.

​
Kılavuzu Yeniden Deneyin

Yalnızca arıza geçici olduğunda yeniden deneyin. Yeniden dene:
  • Ağ zaman aşımları.
  • Bekledikten sonra 429.
  • Kısa bir gecikmeden sonra 500 veya 503.
Düzeltilinceye kadar yeniden denemeyin:
  • Geçersiz API anahtarı.
  • İzin eksik.
  • Bilinmeyen alan.
  • Gerekli alan eksik.
  • Geçersiz ilişki kimliği.

​
iktidarsızlık

getOrCreateConversation gibi bazı SDK işlemleri mevcut kayıtları yeniden kullanmak üzere tasarlanmıştır. CMS oluşturma, form gönderme ve mesaj gönderme gibi yazma işlemleri, her çağrıldıklarında yeni kayıtlar oluşturabilir. Yinelenen gönderimler mümkün olduğunda kendi entegrasyonunuzu bağımsız hale getirin.