Yükleniyor simgesini çizmeden durumları yazın
Bu, geliştiricinin yürüyüş uygulaması için önerilen bir akıştır; gözlemlenmiş API davranışının kaydı değildir. Yürüyüşçü offline maps yazar, geçmiş tartışmaları ister ve bekler. Uygulama henüz kullanılmamış formu, sonucu belirsiz isteği, dönen kayıtları, başarılı boş yanıtı ve hatayı birbirinden ayırmalıdır. Tek bir boş panel bu farklı durumları anlatamaz.
Neyin aranacağını açıklayan nötr bir başlangıç ekranıyla başlayın. Yalnızca yazmak istek göndermek zorunda değildir. Açık gönderim eyleminde soruyu istekle birlikte saklayın ve bir yükleniyor etiketi gösterin. Girdiyi okunur bırakın ve art arda dokunmaların aynı eylemi birkaç kez göndermesini önleyin. Dönen simge, arşivde ilerlemenin kanıtı değil, bekleme hakkında geri bildirimdir.
Geç gelen yanıtı kendi sorusuna bağlı tutun
offline maps isteği beklerken yürüyüşçünün girdiyi downloaded regions olarak değiştirdiğini düşünün. Bu, alınmış bir arama örneği değil, açıklayıcı bir etkileşimdir. Uygulama beklemeyi, başka istek başlatmayı veya kişinin görünümden ayrılmasını seçmelidir. Hangi seçeneği uygularsanız uygulayın, eski yanıt sessizce yeni ifadenin cevabı olmamalıdır.
Her isteği kendi uygulama durumunuzda gönderildiği girdiye bağlayın. Yanıt geldiğinde hâlâ mevcut görünüme ait olup olmadığını kontrol edin. Geç yanıtı ekrandan çıkarmak, sunucunun çalışmasını iptal etmekle aynı şey değildir: gönderilmiş bir istek başarıyla tamamlanıp ücretlendirilebilir. Kendi uygulamanızda bu ayrımı test edin.
Başarılı boş yanıtı bir sonuç olarak değerlendirin
Kayıt döndüğünde elinizdeki alanları gösterin ve geçmiş kaynak etiketini koruyun. Boş data dizisinde, bu isteğin kayıt döndürmediğini açıklayan ayrı bir mesaj kullanın. Kişinin bilinçli değişiklik yapabilmesi için ifadeyi veya filtreleri koruyarak düzenlemeyi önerin. Boş yanıtı uydurma popüler gönderilerle doldurmayın.
Başarılı boş veri alımı, kayıt içeren başarılı yanıtlar gibi bir krediye mal olur. Bu, sorgu değişikliklerini bilinçli yapmanın nedenidir; boş yanıtları hata gibi saklamanın değil. Hiçbir yerde ilgili tartışma bulunmadığını söylemeyin; arşiv eksiktir ve yanıt belirli sorguya ve sınırlı pencereye aittir.
Teknik sorunu operatöre verin
400 yanıtı, istek girdisinin kontrol edilmesini gerektirir. Uygulama yanlış tarih veya desteklenmeyen parametre verdiyse arka uç sözleşmesi hatası için yürüyüşçüyü suçlamayın. 401 eksik veya geçersiz hizmet anahtarını gösterir; uygulamayı yeniden yüklemek veya yürüyüşçüden giriş istemek bu kimlik bilgisini mutlaka düzeltmez.
402 hizmet hesabında yetersiz kredi demektir. Yürüyüşçüye fatura göstermek yerine bu kararı operatöre yönlendirin. 429, Retry-After’a uymayı ve tekrarlanan istekleri azaltmayı gerektirir. Uygulama bir hesabı okuyucular arasında paylaşabildiği için tek kişiye sınırı kendisinin oluşturduğunu otomatik olarak söylemeyin.
Bilinen hatayı bilinmeyen sonuçtan ayırın
Üst hizmetten veri alma başarısız olduğunda ağ geçidi 502 döndürür. Ayrılmış kredi serbest bırakılır veya mutabakat bekliyor olarak bildirilir. Sorguyu ve daha önce görünen sayfayı koruyup sınırlı bir yeniden deneme seçeneği sunun. Tekrarlanan otomatik denemeler, okuyucunun ne olduğunu anlamasına yardım etmeden daha fazla istek oluşturabilir.
Uygulamanız hiç yanıt alamazsa sunucunun başarısız mı olduğunu, işlemi tamamladığını mı bilemeyebilir. Mutabakat için bu belirsizliği kaydedin; kesin iade veya başarı mesajı göstermeyin. Herkese açık /v1/status, sabit kapsam/HTTP yanıtı kontrolüdür; bu soruyu çözemez veya arşiv aramasının sağlıklı olduğunu onaylayamaz.
Yalnızca ekran görüntülerini değil, geçişleri inceleyin
Uygulamanın sahibiyle önerilen sırayı izleyin: gönderme, beklerken düzenleme, boş yanıt alma, hata sonrası deneme, başka sayfa yükleme ve ekrandan ayrılma. Her geçişte korunan girdiyi, görünen içeriği ve sonraki eylemi adlandırın. Güzel bir taslak ekran bu geçişlerin çalıştığını kanıtlamaz.
Operatör tanılamasını, ham hizmet yanıtlarını ve kimlik bilgilerini kullanıcı mesajlarından uzak tutun. Yürüyüşçüye, kullanılamayan tartışma özelliğine bağımlı olmadan hazırlığı sürdürecek kadar bağlam verin. Bu akışı şekillendiren istek bütçesi ve Daha fazla göster kararları için /tr/#field-notes bölümüne dönün.
