sitwatch 1.0.2

SitWatch platformu için resmi Python API istemcisi

SitWatch API İstemcisi

SitWatch platformu için resmi Python API istemcisi. Bu modül ile SitWatch API'sine kolayca erişebilir ve tüm özellikleri kullanabilirsiniz.

📋 İçindekiler

• Özellikler
• Kurulum
• Hızlı Başlangıç
• Detaylı Kullanım
  • Kimlik Doğrulama
  • Video İşlemleri
  • Kullanıcı İşlemleri
  • Topluluk İşlemleri
• Örnekler
• Hata Yönetimi
• Lisans

✨ Özellikler

• ✅ Tam API Desteği
• 🔒 Güvenli Kimlik Doğrulama
• 🎥 Video İşlemleri
• 👥 Kullanıcı İşlemleri
• 💬 Topluluk Özellikleri
• 🔍 Gelişmiş Arama
• 📊 İstatistikler
• 🚀 Async/Await Desteği
• 📝 Kapsamlı Dokümantasyon

📦 Kurulum

pip install sitwatch

🚀 Hızlı Başlangıç

import asyncio
from sitwatch import SitWatch

async def main():
    # İstemciyi oluştur
    client = SitWatch()
    
    # Giriş yap
    await client.login('kullanici_adi', 'sifre')
    
    # Trend videoları al
    trending = await client.get_trending_videos()
    
    # Sonuçları göster
    for video in trending:
        print(f"{video['title']} - {video['views']} izlenme")

# Çalıştır
asyncio.run(main())

📚 Detaylı Kullanım

🔐 Kimlik Doğrulama

# İstemciyi özel yapılandırma ile oluştur
client = SitWatch({
    'base_url': 'https://api.sitwatch.net/api',
    'token': 'mevcut_token',  # İsteğe bağlı
    'on_token_change': lambda token: print(f'Token değişti: {token}')  # İsteğe bağlı
})

# Giriş yap
response = await client.login('kullanici_adi', 'sifre')

# Token kontrolü
if client.has_valid_token():
    print('Giriş başarılı!')

# Çıkış yap
await client.logout()

🎥 Video İşlemleri

# Video bilgisi al
video = await client.get_video_info(123)

# Video ara
results = await client.search_videos({
    'query': 'python',
    'sort_by': 'views',
    'page': 1,
    'per_page': 10,
    'filter_approved': True
})

# Trend videoları al
trending = await client.get_trending_videos()

# En son videoları al
latest = await client.get_latest_videos()

# Top 50 videoları al
top50 = await client.get_top50_videos()

# Video raporla
await client.report_video(123, 'Uygunsuz içerik')

👥 Kullanıcı İşlemleri

# Kullanıcı profili al
profile = await client.get_user_profile('kullanici_adi')

# Kullanıcı videolarını al
videos = await client.get_user_videos(user_id)

# En çok abonesi olanları al
top_users = await client.get_top_subscribers()

# Önerilen kullanıcıları al
recommended = await client.get_recommended_users()

# Aktif kullanıcıları al
active = await client.get_active_users()

💬 Topluluk İşlemleri

# Topluluk gönderilerini al
posts = await client.get_community_posts({
    'page': 1,
    'per_page': 10
})

# Video yorumlarını al
comments = await client.get_video_comments(video_id)

# İzleme geçmişini al
history = await client.get_watch_history()

# Bildirimleri al
notifications = await client.get_notifications()

🎯 Örnekler

Video Arama ve Filtreleme

# Gelişmiş arama örneği
results = await client.search_videos({
    'query': 'python dersleri',
    'type': 'video',
    'sort_by': 'views',
    'page': 1,
    'per_page': 20,
    'filter_approved': True,
    'min_views': 1000,
    'max_duration': 3600,  # 1 saat
    'upload_date_after': '2024-01-01'
})

# Sonuçları işle
for video in results['results']:
    print(f"""
    Başlık: {video['title']}
    İzlenme: {video['views']}
    Süre: {video['duration']} saniye
    Yükleyen: {video['uploader']['username']}
    """)

Token Yönetimi

def on_token_change(token):
    if token:
        # Token'ı kaydet
        save_token(token)
    else:
        # Token'ı sil
        delete_token()

client = SitWatch({
    'on_token_change': on_token_change,
    'token': load_saved_token()  # Kaydedilmiş token'ı yükle
})

❌ Hata Yönetimi

try:
    await client.login('kullanici_adi', 'yanlis_sifre')
except Exception as e:
    print(f"Hata: {e['message']}")
    print(f"Durum Kodu: {e['status']}")
    if 'data' in e:
        print(f"Detay: {e['data']}")

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

🤝 İletişim

• Geliştirici: Physic
• GitHub: github.com/iphysicc

🙏 Teşekkürler

Bu projeyi desteklediğiniz için teşekkürler!