Kaynaklar

Sık Sorulan Sorular

Başlangıç, kimlik doğrulama, sipariş ve hata başlıklarında en sık sorulan soruların kısa yanıtları.

Başlangıç

Nereden başlamalıyım?

İlk Entegrasyon rehberini takip edin.

Test ortamı var mı?

Ayrı bir test ortamı bu dokümanda tanımlı değil; hesap yöneticinizle görüşün.

Kaç restoran bağlayabilirim?

Bu, hesabınıza atanmış paket kapsamına bağlıdır. GET /web-api/v1/user/packages ile mevcut bakiyenizi görebilirsiniz.

Panel mi API mı kullanmalıyım?

Kod yazmadan yönetmek istiyorsanız Panel, tam kontrol ve otomasyon istiyorsanız REST API uygundur. Karşılaştırma için Hızlı Başlangıç sayfasındaki Yaklaşımlar tablosuna bakın.

İlk isteği nasıl atarım?

Hızlı Başlangıç sayfasındaki Kurulum ve İlk istek bölümlerini izleyin.

Kimlik doğrulama

Anahtarı nereden alırım?

Paneldeki Yönetim Anahtarları ekranından.

Hangi başlık biçimleri kabul ediliyor?

X-Api-Key, Authorization: Bearer <api-key> ve Authorization: <api-key> — üçü de kabul edilir.

Anahtarı sızdırdım, ne yapmalıyım?

Panelden hemen silip yenisini oluşturun; eski anahtarı hiçbir istemcide bırakmayın.

Anahtarı kaybettim, geri alabilir miyim?

Hayır. Anahtar oluşturulduğunda yalnızca bir kez gösterilir; kaybederseniz panelden yenisini oluşturmanız gerekir.

Anahtarı istemcide kullanabilir miyim?

Hayır. API anahtarını yalnızca sunucu tarafında saklayın; ayrıntılar için Kimlik Doğrulama sayfasındaki Güvenlik bölümüne bakın.

Anahtarı nasıl yenilerim?

Ayrı bir rotasyon ucu yoktur. Panelden mevcut anahtarı silin, yenisini oluşturun ve entegrasyonlarınızı yeni anahtarla güncelleyin.

Sipariş

Sipariş neden düşmüyor?

Restoranın platform entegrasyonu pasif olabilir. POST /web-api/v1/restaurants/integrations/update-status ile durumu kontrol edin.

Webhook gelmedi, ne yapmalıyım?

POST /web-api/v1/orders/retry-webhook ile teslimatı yeniden tetikleyin.

Durum adları neden platformdan platforma farklı?

Durum adları bağlı platform kaynaklıdır; posentegra bir enum tanımlamaz.

Siparişi nasıl iptal ederim?

Önce GET /web-api/v1/orders/reasons/{orderId} ile platformun kabul ettiği iptal nedenlerini alın, ardından POST /web-api/v1/orders/cancel/{orderId} ile iptali gönderin.

Ödeme kırılımını nereden görürüm?

GET /web-api/v1/orders/grouped-payments ile siparişlerin ödeme tipine göre gruplanmış toplamlarını alabilirsiniz.

Hata

401 mi 403 mü?

Ayrımı ve çözümü için Hata Kodları sayfasına bakın.

İstek zaman aşımına uğradı, ne yapmalıyım?

İsteği yeniden deneyin; GET /web-api/v1/orders/reports/pending ile işlenmemiş kayıtları takip edin.

429 aldım, ne yapmalıyım?

İstek sıklığınızı azaltıp artan aralıklarla yeniden deneyin; ayrıntılar için Hız Limitleri sayfasına bakın.

İşlenmemiş kayıtları nasıl kapatırım?

POST /web-api/v1/orders/reports/mark ile siparişi raporlandı olarak işaretleyin; listeden düşer.