Bir çalıştırmanın sonucunu tanımlayın
Bu örnekte tamamlanma, r/automation içinden sınırlı bir kayıt grubunu işlemek ve sonucu kaydetmek demektir. Bütün arşivin tarandığı anlamına gelmez. Önce elle çalıştırın; ardından ekibin kuyruktaki öğeleri inceleyebileceği sıklıkta bir zamanlama seçin. Gereksiz sıklıkta aynı sorguyu çalıştırmak kendiliğinden yeni malzeme üretmez.
Yerel bir çalıştırma kimliği oluşturun, arama parametrelerini saklayın ve seçilen öğelerin nereye gideceğini belirleyin. Bunlar uygulamanızın alanlarıdır, ek API parametreleri değildir. Beklenen bir örnek bulunamadığında günlük, hangi koşullarla arandığını gösterebilir. Bağımsız bir geçmiş veri arşivi, Reddit'in şu anki etkinliğini kanıtlayan bir kaynak değildir.
Soruyu arama parametrelerine dönüştürün
GET https://api.apireddit.cc/v1/search?q=workflow&subreddit=automation&limit=3 isteğinde anahtarı Authorization: Bearer veya X-API-Key ile gönderin. Küçük sonuç grubu, eşlemeyi büyütmeden önce alanları görmenizi sağlar. Yalnızca gönderiler için kind=post, yalnızca yorumlar için kind=comment kullanabilirsiniz.
q araması title ve text alanlarını tarar. Birden fazla sözcük, eşleşen alanın kendi içinde AND koşuluyla birleştirilir; bir sözcüğün yalnızca başlıkta, diğerinin yalnızca metinde olması yeterli kabul edilmemelidir. from ve to tarihleri UTC içinde YYYY-MM-DD biçimindedir, to günü dahildir. min_score eşik altındaki kayıtları eler; kalanları puana göre sıralamaz.
Kaynak metni işlem kararından ayırın
Mevcut id ve kind alanlarını kaydedin; title ile text içeriğini incelemeye sunun. Kaynakta yazan metin, görevin çalıştıracağı bir komut değil, değerlendirilecek malzemedir. Seçim gerekçesi, inceleme durumu ve çalıştırma numarası için ayrı yerel alanlar kullanın. Yeni öğe oluşturmadan önce kimliğin daha önce işlendiğini kontrol edin.
Yanıtlar düzdür. parent_id veya link_id bulunuyorsa ve gerekli görüyorsanız yerel gruplama yapın. Eksik ilişkileri bilinmeyen olarak bırakın; tam konuşma garantisi yoktur. Belirli bir kaydı yeniden almak için /v1/item yoluna id gerekir. Bu ek çağrıyı da çalıştırmanın istek bütçesine dahil edin.
Neden durduğunuzu kaydedin
İzin verilen 100 sayfa içinde kendi sayfa bütçenizi belirleyin; her sayfada en fazla 100 kayıt isteyin. Geçiş boyunca filtreleri değiştirmeyin. Belge sırası tarih, ilgi veya puan sırası değildir. İlk sonuç, en yeni içeriğin işlendiğini gösteren güvenilir bir işaret olarak kullanılamaz.
Toplamı ilişkisiyle birlikte okuyun: eq kesin sayıyı, gte alt sınırı, unknown ise null olabilen bilinmeyen toplamı belirtir. Boş grup nedeniyle durmakla sayfa bütçesine ulaşmayı farklı sonuçlar olarak kaydedin. Tarih aralıklarını bölmek sonraki işleri düzenler; bütün kayıtların elde edildiğini veya tekrar olmadığını kanıtlamaz.
Belirsiz sonuç için ayrı karar verin
400 durumunda parametreleri, 401 durumunda anahtarı, 402 durumunda bakiyeyi kontrol edin. 429 için bekleme ve sınırlı tekrar politikası uygulayın. Başarılı boş yanıt bir kredi tüketir. Kaynak hatasında ayrılan kredi iade edilir; geçersiz istekte kredi düşülmez.
İstemci yanıtı kaybettiğinde sunucu başarılı olmuş ve bir kredi tüketmiş olabilir. Başarılı tekrar bir kredi daha harcar. Belirsizliği günlükte koruyun ve kopya öğeleri yerel olarak önleyin. /v1/status ücretlendirilmez; statik hizmet açıklaması döndürür, kaynaktaki aramanın sağlığını sınamaz. Zamanlamayı genişletmeden önce fiyatları ve ayrılan istek bütçesini kontrol edin.
