Kontrol listesi

Canlı anahtar, bu listenin tamamlanması sonrasında verilir. Liste bir formalite değildir: eksik bırakılan her madde, ilerleyen dönemde destek talebi olarak geri dönmektedir.

Liste

Kimlik doğrulama

• [ ] Token saklanıyor ve yeniden kullanılıyor; her çağrıda yenisi alınmıyor
• [ ] Token, süresi dolmadan yenileniyor; 401 yanıtı beklenmiyor
• [ ] TOKEN_EXPIRED ve INVALID_CREDENTIALS ayrı ayrı ele alınıyor
• [ ] Gizli anahtar sunucuda tutuluyor; mobil uygulamada veya tarayıcı tarafında değil

Mağazalar

• [ ] Mağaza oluşturulabiliyor ve aynı PUT isteğiyle güncellenebiliyor
• [ ] availableFleets listesi restorana anlaşılır biçimde sunuluyor
• [ ] Kurye şirketi bağlanabiliyor ve değiştirilebiliyor
• [ ] 409 ALREADY_HIZLIYO_PARTNER durumunda ham hata yerine açıklayıcı bir mesaj gösteriliyor

Siparişler

• [ ] X-Idempotency-Key gönderiliyor ve her sipariş için sabit tutuluyor
• [ ] readyAt alanı ürünün mutfaktan çıkacağı saati gösteriyor
• [ ] Teslimat koordinatları gerçek adresten üretiliyor, ilçe merkezinden değil
• [ ] En az üç hata kodu ayrı ele alınıyor; önerimiz: FLEET_UNAVAILABLE, FLEET_SUSPENDED, COORDINATE_MISMATCH
• [ ] Başarısız sipariş isteği arka arkaya yeniden denenmiyor

Bildirimler

• [ ] Bildirim adresi HTTPS üzerinden çalışıyor ve gecikmeden 2xx döndürüyor
• [ ] İmza ham gövde üzerinden doğrulanıyor
• [ ] Değiştirilmiş gövde reddediliyor — bu senaryo denendi
• [ ] Tanımlı olmayan bildirim türleri hata üretmeden geçiliyor
• [ ] Aynı eventId iki kez işlenmiyor
• [ ] Geç ulaşan eski bir durum, siparişi önceki duruma döndürmüyor

İptal

• [ ] Paket teslim alınmadan önce iptal çalışıyor
• [ ] PickedUp durumunda iptal düğmesi kaldırılıyor
• [ ] CANCEL_TOO_LATE yanıtı düzgün karşılanıyor

Günlük işleyiş

• [ ] Restoran talebinde teslimat, kendi sipariş numaranızla bulunabiliyor
• [ ] Sipariş geçmişi destek ekibinizin erişebildiği bir konumda tutuluyor
• [ ] Restoranlara birinci düzey desteği verecek ekip belirlenmiş — bu sorumluluk POS firmasına aittir

Canlı erişim başvurusunda iletilecek bilgiler

1. Test istemci kimliğiniz
2. Canlı bildirim adresiniz
3. Öngörülen hacim: restoran sayısı, saatlik sipariş adedi, yoğun saat aralıkları
4. Bir teknik ve bir ticari iletişim kişisi

Test ortamındaki işlem kayıtlarınız incelenir, listeyle karşılaştırılır ve hzl_live_ anahtarı tanımlanır.

Canlı ortamdaki ilk hafta

• Tüm restoranlarla değil, sınırlı sayıda restoranla başlayın
• Hataları kod bazında izleyin. Artış gösteren COORDINATE_MISMATCH genellikle sizin tarafınızdaki adres eşleştirmesinde sorun olduğuna işaret eder
• Test anahtarını saklayın; sonraki her değişikliği önce test ortamında doğrulayın

İzleme tarafımızca da yapılmaktadır

Her POS firması için hata desenleri izlenmektedir. Bir hata kodunda artış tespit edildiğinde, konu restoran şikâyetine dönüşmeden tarafınıza bildirilir.