Web paneliyle başlayan ürünü gelecekteki mobil istemcilere açarken sözleşme, güvenlik ve sürüm kararlarını planlamak.
API sözleşmesini ekranlardan bağımsız düşünün
Web ekranındaki tablo kolonları API kaynağının yapısını birebir belirlememelidir. Müşteri, sipariş veya görev gibi iş kavramları açık adlandırılmalı; istemcinin gereksiz iç ayrıntıya bağımlı olması önlenmelidir.
İstek ve cevap örnekleri, zorunlu alanlar, hata biçimi ve sayfalama davranışı dokümante edilmelidir. Sözleşme testleri sunucu değişikliklerinin istemcileri sessizce bozmasını önlemeye yardımcı olur.
- Tutarlı kaynak adları
- Öngörülebilir hata modeli
- Sayfalama ve filtreleme
- Örnek istek ve cevaplar
Datauraf notu Doğru teknoloji kararı, ancak kullanıcı davranışı ve iş hedefi aynı masada değerlendirildiğinde kalıcı sonuç üretir.
Kimlik doğrulama ve yetkiyi sunucuda merkezileştirin
Mobil veya web arayüzünde butonu gizlemek yetkilendirme değildir. Her istek kullanıcı rolü, şirket kapsamı ve kayıt ilişkisi üzerinden sunucuda kontrol edilmelidir.
Erişim anahtarlarının ömrü, yenileme davranışı ve iptali planlanmalıdır. Mobil uygulama içine kalıcı sır gömülmemeli; hassas oturum bilgisi işletim sisteminin güvenli alanlarında saklanmalıdır.
Mobil bağlantı koşullarına uygun cevaplar üretin
Mobil kullanıcı kesintili veya yavaş bağlantıda çalışabilir. Gereğinden büyük veri paketleri yerine ekranın ihtiyacına uygun alanlar, sayfalama ve önbellek kuralları kullanılmalıdır.
Tekrar gönderilen işlemler çift sipariş veya kayıt oluşturmamalıdır. İstek kimliği ve idempotent davranış özellikle ödeme, saha formu ve durum güncelleme akışlarında önemlidir.
- Kısmi veri ve sayfalama
- Güvenli tekrar deneme
- Dosya yükleme sınırları
- Çevrimdışı durum mesajları
Gözlemlenebilirlik ve sürüm politikasını baştan kurun
İstemcide görülen hata sunucu kayıtlarıyla ilişkilendirilebilmelidir. İstek kimliği, yapılandırılmış günlük ve temel performans ölçümleri sorun çözme süresini kısaltır; kişisel veriler gereksiz yere kaydedilmemelidir.
Kırıcı değişiklikler için sürüm ve geçiş politikası belirlenmelidir. Eski mobil sürümler mağazada bir süre kullanılmaya devam edebileceği için sunucu değişiklikleri kontrollü uygulanmalı, zorunlu güncelleme yalnız gerçek ihtiyaçta kullanılmalıdır.