Kullanıcıyı, işi ve ödeme hesabını ayırın
Ürün kullanıcısı, dahili iş ve arşiv okumalarını ödeyen alan adı hesabı üç ayrı kimliktir. Sunucunuz ilk ikisinin ilişkisini ve yetkisini kontrol eder. Tarayıcı yalnızca izin verilen sonucu almalıdır. Ortak anahtarın tarayıcıya verilmesi, onu alan kişinin ekrandaki sınırların dışında ücretli istek başlatmasına yol açabilir.
Ortam değişkenleri veya sunucu tarafındaki bir sır yöneticisi, anahtarı kaynak kodundan ayırmak için kullanılabilir. Ortam değişkeni adının derleme sırasında istemci paketine gömülmediğini kontrol edin. Yapılandırma dökümleri, hata raporları ve istek günlükleri de sır sızdırabilir. Yetkilendirme başlıklarını bu kayıtlardan çıkarın; sorun gidermek için yol, filtre, durum kodu ve yerel işlem kimliği yeterli olabilir. Sır yöneticisi kullanımı hizmetin zorunlu bir özelliği değil, sizin altyapınıza ait bir güvenlik tercihidir.
İzin verilen arşiv isteğini oluşturun
İlk iş için arşiv sunucusunu ve izin verilen arama yolunu sabitleyin. q=onboarding, subreddit=SaaS ve limit=3 değerlerini doğrulanmış girdilerden oluşturun; anahtarı yalnızca dışarı giden istek aşamasında ekleyin. Ziyaretçinin verdiği keyfî bir URL’ye bu başlığı göndermeyin. İşin yetki kontrolü bu aşamadan önce tamamlanmalıdır.
Authorization: Bearer YOUR_API_KEY ile X-API-Key: YOUR_API_KEY geçerli iki başlıktır. Birini kullanmak diğerini desteklenmiyor yapmaz. Her ikisinde de bu alan adının arşiv anahtarı kullanılır; Reddit OAuth belirteci kullanılmaz. Örneklerde yalnızca yer tutucu gösterin ve gerçek değeri sunucu çalıştırma ortamında ekleyin. Tarayıcıya gönderilen JavaScript, sayfa kaynak kodu ve kullanıcıya görünen hata ekranları sır saklamak için uygun yerler değildir. Hesap panelinin Secure HttpOnly çerezi ise ayrı tutulur.
Tekrardan önce denemeyi kaydedin
İşe dahili bir kimlik ve küçük bir deneme bütçesi verin. Yetkilendirme başlıkları olmadan yolu, filtreleri, deneme numarasını ve sonucu kaydedin. Örnek kural, sayfa değişiklikleri ve tekrarlar dahil toplam üç denemeye izin verir. Bu sizin ürün kuralınızdır; arşiv kullanıcı kotası veya dahili iş günlüğü sağlamaz.
Belirsiz bir akışı inceleyin: ilk boş başarılı yanıt bir kredi harcar; ikinci yanıt kaybolur ve yine de ücretlenmiş olabilir; başarılı tekrar ayrıca kredi harcar. Kaybolan yanıtı ücretsiz hata olarak kaydetmeyin. Üst sistem hatası rezervi geri verir, fakat yerel ayrıştırma ya da saklama hatası ücretlenmiş başarıyı iptal etmez.
Yorumlamadan önce yanıtı saklayın
Ekran için dönüştürmeden önce yanıtı saklayın. Kayıtlar düzdür; alanlar eksik olabilir ve parent_id veya link_id alınmamış malzemeye işaret edebilir. Yerel gruplama tam konuşmayı kanıtlamaz. Tarihler UTC ile YYYY-MM-DD biçimindedir, to günü dahildir. q, eşleşen alan içinde AND kullanarak title ve text üzerinde arar; min_score filtreler, _doc ise sıralama puanı veya kronoloji değildir.
Anahtarı geçiş süresi varsaymadan değiştirin
Yeni işleri kabul etmeyi duraklatarak anahtar değişimini hazırlayın. Oturum açma ve parola doğrulamasından sonra yenileme eski anahtarı hemen geçersiz kılar. İstek gönderen süreçleri güncelleyip sonra devam ettirin; ortak geçerlilik süresine güvenmeyin. Yeni değeri teslim ederken de erişimi sınırlayın ve tanılama çıktılarının dışında tutun.
Yerel sınır yalnızca sizin sunucunuzdan geçen istekleri denetler. Sızmış anahtarın doğrudan kullanımını engellemez. İnceleme sırasında deneme günlüğünüzü hesap bağlamıyla karşılaştırın; hacim artışını tek başına sızıntı kanıtı saymayın. Anahtar değişimi harcanan kredileri iade etmez. Parolayı da koruyun: sıfırlama ve anahtarın e-postayla gönderilmesi sağlanmaz.
Küçük bir işle bütün yolu sınayın
Son olarak küçük bir işi çalıştırıp gerçek sonucu değerlendirin. 400 için parametreleri, 401 için anahtarı, 402 için bakiyeyi, 429 için sıklığı kontrol edin. İstek başına en fazla 100 kayıt ve sorgu başına 100 sayfa sınırı vardır; tam kapsama garantisi yoktur. /v1/status arşiv sağlığını ölçmez, statik kapsam bilgisi verir. Saklanan bir örnek ve gerekçeli durma kararı da işi tamamlayabilir.
