SereneReader API ile otomasyon kurma

Okumayı neden otomatikleştirmelisiniz?

RSS, birçok kaynaktan içeriği tek bir yere zaten toplar. SereneReader API'si bu içeriği betiklere, cron işlerine ve diğer araçlara çekmenize olanak tanır.

Kimlik doğrulama tek bir API anahtarıyla yapılır: bir tane oluşturun, her HTTP isteğiyle gönderin ve JSON yanıtı alın. API salt okunurdur ve webhook desteği yoktur; bu nedenle betikler belirli bir programa göre yoklama yapar.

Başlarken

API erişimi Pro ($5/ay, web üzerinden) ve Team planlarına dahildir.

API anahtarı oluşturma

SereneReader'da Ayarlar'ı açın ve API sekmesini seçin. Bir anahtar oluşturun, daha sonra tanıyacağınız bir ad verin ve güvenli bir yere kopyalayın; anahtar yalnızca bir kez gösterilir. Pro hesaplar en fazla 5, Team hesaplar en fazla 10 anahtar oluşturabilir.

Kimlik doğrulama

Her istekte Authorization başlığında anahtarınızı Bearer token olarak göndermeniz gerekir. İstemci kimliği, yenileme token'ı veya kapsam gibi kavramlar yoktur. Ayarlar'daki API sekmesinde temel URL, uç noktalar ve örnek istekler yer almaktadır.

Hız sınırları

API, tüm anahtarlarınızda ortak olmak üzere hesap başına dakikada 30 istek yapılmasına izin verir; bu, belirli aralıklarla çalışan betikler için yeterlidir. Her yanıt bir X-RateLimit-Remaining başlığı içerir. Sınırı aşarsanız API, Retry-After başlığıyla birlikte 429 döndürür; tekrar denemeden önce belirtilen saniyeler kadar bekleyin.

Neler yapabilirsiniz?

API, makale ve aboneliklerinize okuma erişimi sağlar:

• GET /api/v1/articles akışlarınızdaki makaleleri en yeniden en eskiye döndürür. Akış, klasör veya yayın tarihine göre filtreleyebilir ve sonuçlar arasında sayfalama yapabilirsiniz (varsayılan olarak istek başına 50, en fazla 200). Her makale başlığı, URL'si, akış adı, yazarı, yayın tarihi, bir özet ve okundu ya da yıldızlandı bilgisini içerir.
• GET /api/v1/feeds aboneliklerinizi okunmamış sayıları ve klasörleriyle listeler.
• GET /api/v1/usage kullandığınız anahtarın son bir saat, 8 saat ve 24 saat içinde kaç istek yaptığını gösterir.

Ayarlar'daki API sekmesinde parametrelerin ve yanıt alanlarının tam listesi yer almaktadır.

Kullanım senaryoları

Günlük özet e-postası

Her sabah saat 7'de çalışan, önceki günün makalelerini çeken ve size bir özet e-postası gönderen bir betik yazın. Tarihe göre filtreleyin, başlıkları ve URL'leri almak için JSON'ı jq üzerinden geçirin ve sonucu kullandığınız e-posta ya da bildirim aracıyla gönderin.

Sessiz akış kontrolü

Akışlar bozulabilir: alan adları sona erer, yollar değişir, sunucular kapanır. API, getirme hatalarını veya bir akışın en son ne zaman yayın yaptığını bildirmez; ancak haftalık bir betik yine de sessizleşen akışları tespit edebilir. Akışlarınızı listeleyin, feedId ve since parametreleriyle her biri için son makaleleri isteyin ve son birkaç haftada hiçbir şey yayınlamamış akışları işaretleyin. Çok fazla akışınız varsa hız sınırının altında kalmak için isteklerin hızını ayarlayın.

Sessiz bir akış her zaman bozuk değildir, ancak bu liste hangi blogları kontrol etmeniz gerektiğini gösterir.

Diğer araçlara dışa aktarma

Makaleleri yerel bir veritabanına, bir Notion sayfasına, bir Obsidian vault'una veya bir elektronik tabloya çekin. API yapılandırılmış JSON döndürdüğünden dönüşüm genellikle birkaç satır jq veya kısa bir Python betiğiyle yapılabilir.

Yapay zeka ajanlarıyla birleştirme

API, HTTP istekleri yapabilen yapay zeka araçlarıyla çalışır. OpenClaw gibi bir asistan kullanıyorsanız onu SereneReader'a yönlendirerek akışlarınızı işlemesini sağlayabilirsiniz. Bu konuda ayrı bir yazı yazdık: RSS akışlarınızı yapay zeka ajanlarına nasıl bağlarsınız.

Daha fazla fikir

Birkaç satırla inşa edebileceğiniz başka şeyler: bir klasördeki günün makalelerini size e-postayla gönderen bir cron işi, /api/v1/feeds üzerindeki okunmamış sayılarını toplayan bir kabuk takma adı ya da bir akıştaki yeni makaleleri Slack kanalına ileten bir yoklama betiği.

Bunların hiçbiri için bir framework'e ihtiyaç duymazsınız. curl ve jq çoğu durumu karşılar; bir HTTP istemcisine sahip herhangi bir dil geri kalanı için yeterlidir.

Ayarlar'da, API sekmesinde anahtarınızı oluşturun.