Tüm sistemler çalışıyor Giriş Yap →
bilgi-arşivi/ API & Entegrasyon/ API Hatalarını Yönetme, Kayıt Tutma ve Canlıya Geçiş Kontrolü
API & Entegrasyon

API Hatalarını Yönetme, Kayıt Tutma ve Canlıya Geçiş Kontrolü

Güvenilir bir API entegrasyonu yalnız başarılı yanıtları değil; doğrulama hatalarını, geçersiz kimlikleri, yetersiz bakiyeyi ve geçici bağlantı sorunlarını da kontrollü biçimde yönetir. Her isteğin sonucunu açık bir yerel duruma dönüştürmeniz gerekir.

Yanıt işleme prensibi

HTTP isteği tamamlanmış olsa bile işlem başarılı olmayabilir. JSON yanıtında beklenen order, status, refill veya balance alanıyla birlikte error alanını da kontrol edin.

Başarılı işlem

Beklenen sonuç alanı vardır ve yerel kayıt API kimliğiyle güncellenir.

İş kuralı hatası

Servis bulunamadı, miktar sınırı, geçersiz order veya yetersiz bakiye gibi yanıtlar düzeltilmeden tekrar gönderilmez.

Bağlantı veya ayrıştırma hatası

Zaman aşımı, geçersiz JSON veya ağ hatası kontrollü tekrar ve inceleme kuyruğuna alınır.

Mükerrer siparişi önleme

Sipariş isteğinde ağ zaman aşımı oluştuğunda API’nin siparişi oluşturup oluşturmadığı her zaman hemen anlaşılamayabilir. Aynı isteği körlemesine tekrar göndermek mükerrer sipariş oluşturabilir. Her yerel sipariş için tek bir gönderim durumu, zaman damgası ve alınan order ID kaydı tutun; belirsiz sonuçları manuel incelemeye ayırın.

Güvenli loglama

  • API anahtarını tamamen maskeleyin.
  • İşlem türü, yerel referans, order veya refill ID, zaman ve sonuç durumunu kaydedin.
  • Kişisel ya da gereksiz bağlantı verilerini loglarda çoğaltmayın.
  • Toplu işlemlerde her sıra sonucunu ilgili yerel kayıtla eşleyin.

Canlıya geçiş kontrol listesi

1
Bağlantıyı doğrulayın. services ve balance sorgularının beklenen JSON’u döndürdüğünü kontrol edin.
2
Doğrulama kurallarını test edin. Min, max, servis tipi ve link kontrollerini hatalı örneklerle sınayın.
3
Durum eşlemelerini tamamlayın. Sipariş ve refill durumlarını kullanıcıya açık karşılıklarla gösterin.
4
Hata ve tekrar politikasını belirleyin. İş kuralı hatalarıyla geçici ağ hatalarını ayırın.
5
Hassas verileri denetleyin. Kod, log ve istemci çıktılarında gerçek API anahtarı bulunmadığını doğrulayın.
Küçük hacimle başlayın. Canlıya geçişte önce sınırlı sayıda siparişle uçtan uca kayıt ve durum akışını doğrulayın.

Güncel endpoint ve parametreler için RoketBayim API dokümantasyonunu esas alın.