Bir istek haritasıyla başlayın
Yürüyüş uygulamasındaki çevrimdışı harita tartışması özelliğini bütçelerken ilk adım, maliyetin dönen veri miktarına değil veri alma isteklerine bağlı olduğunu anlamaktır. Bir başarılı arama, üç kayıt, 100 kayıt veya boş liste döndürse de bir krediye mal olur. Daha küçük sayfa seçmek okumayı kolaylaştırabilir ama isteğin kredi fiyatını düşürmez.
Gerçekten hizmete ulaşan eylemleri çizin. İlk arama, istenen sonraki sayfa, açık yenileme ve tekil kayıt sorgusu ayrı ayrı veri alma işlemi olabilir. Yüklenmiş metni kaydırmak yeni istek değildir. Arka ucunuz bir tıklamayı birkaç çağrıya ayırıyorsa bir düğmeye basmak mutlaka bir kredi demek değildir.
Varsayımsal bir günü hesaplayın
Bu, gözlemlenmiş trafik veya kullanım tahmini değil, bir planlama örneğidir: uygulamanın 120 ilk sayfa isteği, 30 ek sayfa isteği ve 10 yenilemeyi başarıyla tamamladığını varsayın. Bu, belirtilen fiyattan $0.16 karşılığı 160 başarılı istek ve 160 kredidir. İlk sayfalardan 20’si boş olsa da bu istekler başarılı olduğu için toplam 160 kredi kalır.
Şimdi kimse okumasa bile arayüzün her ilk aramada otomatik üç sayfa aldığını düşünün. İlk örnekteki 150 başlangıç ve bilinçli sonraki sayfa isteği yerine, yenilemeleri saymadan 360 istek oluşur. Karşılaştırma gerçek kullanıcı kanıtı değil, verilen varsayımlarla aritmetiktir. Uygulamadan sonra varsayımların yerini kendi ölçülmüş istek günlüğünüz alsın.
Fiyatla satın alımı ayırın
Standart fiyat, 1,000 başarılı veri alma isteği için $1’dır. En düşük ücretli yükleme $50’dir ve 50,000 ücretli kredi sağlar. Abonelik yoktur; ücretli kredilerin süresi dolmaz. Dolayısıyla varsayımsal $0.16’lık gün bir bakiyenin tüketimini anlatır, $0.16 yükleme yapılabildiği anlamına gelmez.
İsteğe bağlı 100 deneme kredisi ağ genelindeki kötüye kullanım uygunluğuna bağlıdır ve ücretli dönüşümden ayrıdır. Her kaydın bunları aldığını varsaymayın veya özelliği ücretsiz API olarak sunmayın. Giriş yaptıktan sonra fatura oluşturun; tam ödeme tutarını, alıcıyı, tokenı ve ağı faturadan alın. Hesap ve ödeme adımları Anahtar ve krediler bölümündedir.
Hataları ve belirsizliği ayrı tutun
HTTP 400, 401, 402 ve 429, veri alma kredisi ayrılmadan önce reddedilir. Sırasıyla geçersiz giriş, eksik veya geçersiz anahtar, yetersiz kredi ve hız sınırını belirtirler. Başarısız üst hizmet isteği ayrılmış krediyi serbest bırakır; mutabakat yine de beklemede kalabilir. Her hata yolunu önceki bir ücretin anında iadesi olarak açıklamayın.
Uygulama, isteği gönderdikten sonra yanıtı kaybederse sunucunun başarılı bir veri alımını tamamlayıp tamamlamadığını bilemeyebilir. Yeniden deneme başka bir istektir, garantili ücretsiz devam değildir. Belirsiz sonucu kaydedin, sorguyu koruyun ve otomatik yeniden deneme fırtınasından kaçının. Hesap görünümü mutabakat için başarılı, bekleyen ve iade edilmiş istek sayılarını gösterir.
Özelliğe bir üst sınır koyun
Her sorgu 1–100 sayfaya ve istek başına en fazla 100 kayda izin verir. Bunlar hizmet sınırlarıdır; her sayfanın alınması önerisi değildir. Uygulama, etkileşimli okuma oturumu için daha düşük sayfa bütçesi belirleyip sonraki veri alımından önce sorabilir. Tekrar tekrar boş sayfa aramak yerine pagination.has_more ve son pencere sınırına uyun.
Potansiyel 10,000 kayıtlık pencereyi garanti edilen sonuç miktarı saymayın. Yanıt boş olabilir, kayıtların alanları eksik olabilir ve arşiv tam kapsam vaat etmez. /v1/status ücretsizdir fakat hesap bakiyesini döndürmez veya arama sağlığını denetlemez. Yerel sayaçlar da mutabakat gerektirir; kayıp isteğin ücretsiz olduğunu kanıtlayamazlar.
Okuyucunun gerçekten ihtiyaç duyduğu kararları gözden geçirin
Önerilen yürüyüş panelinde kısa ilk sayfa ve bilinçli Daha fazla göster eylemi tartışma kaynaklarını karşılaştırmaya yetebilir. Önceden saklanan uygulama içeriğini sessizce yeniden istemeden kaydedin veya açın. Okuyucu bir kaydı yeniden kontrol etmeyi açıkça isterse bunun yeni bir sorgu olduğunu açıklayın ve erişilemeyen sonucu ele alın.
Sınırların veya sunumun değişmesi gerekip gerekmediğine kendi trafik kanıtınızla karar verin. Planlama örneğini kullanıcı başına vaat edilen maliyete, kullanıcı tutma oranına veya performans ölçümüne çevirmeyin. Sınırlı sayfalama ve yerel okuma listesi tasarımı için /tr/#field-notes bölümüne dönün.
