Profile Screen Endpoints
User Profile Endponitleri
Get User Past Stream API Dökümantasyonu
Kullanıcının geçmiş canlı yayınlarını profilinde göstermek için sonlanmış canlı yayınları getirir. Hızlı çıkalım diye pagination eklemedim v2 de pagination ekleyebiliriz.
Endpoint'ler
1. Mevcut Kullanıcının Geçmiş Streamler'ini Getir
İstek atan kullanıcının geçmiş canlı yayınlarını getir
Endpoint: GET /live-stream/my-past-streams
Apidog ID: 24696493
Açıklama: İstek atan kullanıcının sonlandırılmış (ENDED durumundaki) tüm canlı yayınlarını en yeni en üstte olacak şekilde listeler. Soft delete edilmiş yayınlar dahil edilmez.
Authentication: Optional JWT Bearer Token
Response: LiveStreamResponseDto[] - Geçmiş canlı yayınların listesi
Sıralama: En yeni yayın en üstte (startedAt ve createdAt alanlarına göre azalan sırada)
2. Belirli Bir Kullanıcının Geçmiş Streamler'ini Getir
Belirli bir kullanıcının geçmiş canlı yayınlarını getir
Endpoint: GET /live-stream/user/:userId/past-streams
Apidog ID: 24696494
Açıklama: Belirli bir kullanıcının sonlandırılmış (ENDED durumundaki) tüm canlı yayınlarını en yeni en üstte olacak şekilde listeler. Profil sayfalarında kullanılır. Soft delete edilmiş yayınlar dahil edilmez.
Authentication: JWT Bearer Token gerekli
Path Parameters:
userId(string, required): Kullanıcı kimliği (MongoDB ObjectId formatında)
Response: LiveStreamResponseDto[] - Geçmiş canlı yayınların listesi
Sıralama: En yeni yayın en üstte (startedAt ve createdAt alanlarına göre azalan sırada)
Hata Durumları:
400: Geçersiz userId formatı401: JWT gönderildiyse ve geçersiz / süresi dolmuşsa500: Sunucu hatası
Get User Active Stream API Dökümantasyonu
Bu API endpoint'i, kullanıcının profilinde göstermek için aktif canlı yayınını getirir. Bir kullanıcının aynı anda sadece 1 aktif canlı yayını olması beklenir. Eğer birden fazla aktif yayın bulunursa, backend loglarında uyarı kaydedilir ve en son başlayan yayın döndürülür.
Endpoint'ler
1. Mevcut Kullanıcının Aktif Stream'ini Getir
İstek atan kullanıcının aktif canlı yayınını getir
Endpoint: GET /live-stream/my-active-stream
Apidog ID: 24696491
Açıklama: İstek atan kullanıcının aktif canlı yayınını getirir.
Authentication: Optional JWT Bearer Token
2. Belirli Bir Kullanıcının Aktif Stream'ini Getir
Belirli bir kullanıcının aktif canlı yayınını getir
Endpoint: GET /live-stream/user/:userId/active-stream
Apidog ID: 24696492
Açıklama: Belirli bir kullanıcının aktif canlı yayınını getirir. Profil sayfalarında kullanılır.
Authentication: JWT Bearer Token gerekli
Path Parameters:
userId(string, required): Kullanıcı kimliği (MongoDB ObjectId formatında)
Kullanım Senaryoları
Senaryo 1: Kullanıcı Kendi Profilini Görüntülüyor
Kullanıcı kendi profil sayfasındayken aktif yayınını görmek için:
- Endpoint:
GET /live-stream/my-active-stream - Kullanıcının şu anda devam eden canlı yayını varsa döner, yoksa 404 hatası alır.
Kullanıcı kendi profil sayfasındayken geçmiş yayınlarını görmek için:
- Endpoint:
GET /live-stream/my-past-streams - Kullanıcının sonlandırılmış tüm canlı yayınlarını listeler. Liste boş olabilir.
Senaryo 2: Başka Bir Kullanıcının Profilini Görüntülüyor
Kullanıcı başka birinin profil sayfasındayken o kullanıcının aktif yayınını görmek için:
- Endpoint:
GET /live-stream/user/:userId/active-stream - Profil sahibinin şu anda devam eden canlı yayını varsa döner, yoksa 404 hatası alır.
Kullanıcı başka birinin profil sayfasındayken o kullanıcının geçmiş yayınlarını görmek için:
- Endpoint:
GET /live-stream/user/:userId/past-streams - Profil sahibinin sonlandırılmış tüm canlı yayınlarını listeler. Liste boş olabilir.