AltyaziDB API v1.0

AltyaziDB API, Türkiye'nin en temiz altyazı veritabanına erişmeniz için tasarlanmış yüksek performanslı bir REST servisidir.

Kimlik Doğrulama: Tüm istekler X-API-Key: ANAHTARINIZ başlığı (Header) ile ve HTTPS üzerinden yapılmalıdır.

Sayfalama (Pagination): Tüm listeleme (Search ve Latest) uç noktaları ?page=1 ve ?limit=20 parametrelerini destekler.

Kullanıcı ve Kota Sorgulama

Geliştiricilerin kalan API hız sınırlarını (Rate Limit) canlı olarak kontrol etmesini sağlar.

GET https://altyazidb.com/api/v1/me

Altyazı Arama

IMDb ID kullanarak belirli bir yapıma ait altyazıları listeler.

Sezon Paketi Arama (Önemli): Eğer bir dizinin tekil bölümlerini değil, doğrudan toplu Sezon Paketi arşivini filtrelemek isterseniz, episode parametresine PAKET yazarak istek atabilirsiniz.

1. İstek Parametreleri (Request)

GET https://altyazidb.com/api/v1/search

Parametre	Durum	Açıklama
`imdb_id`	Zorunlu	Yapımın IMDb ID'si (Örn: `tt37529347`)
`lang`	Opsiyonel	Dil filtresi (`tr` veya `en`)
`season`	Opsiyonel	Sadece belirtilen sezonu getirir (Örn: `1`).
`episode`	Opsiyonel	Bölüm numarası. Sezon paketlerini listelemek için PAKET yazın.
`page`	Opsiyonel	Sayfa numarası. Varsayılan: `1`

2. Yanıt Alanları (Response Model)

Başarılı bir arama sonucunda dönen JSON objesindeki veri modeli aşağıdaki gibidir:

Alan (Key)	Veri Türü	Açıklama
`id`	String	Altyazının sistemdeki benzersiz ID numarası.
`language`	String	Altyazının dili (Örn: `tr`).
`season`	Integer/Null	Eğer dizi ise sezon numarası, film ise `null` döner.
`episode`	String/Null	Bölüm numarası (Örn: "4" veya "PAKET").
`fps`	String	Altyazının kare hızı (Örn: `23.976`).
`releases`	Array	Altyazının uyumlu olduğu sürüm (Release) isimlerini içeren liste.
`translator`	String	Çevirmen adı.
`uploader`	String	Sisteme yükleyen kişinin adı.
`downloads`	Integer	Toplam indirilme sayısı.
`download_url`	String	Bu altyazı arşivini indirmek için kullanmanız gereken API doğrudan indirme linki.
`translator_note`	String/Null	Çevirmene ait not. Girilmemişse `null` döner.
`hearing_impaired`	Integer	İşitme engelli (CC) durumu (1 veya 0).
`forced`	Integer	Forced durumu (1 veya 0).

Son Eklenenler

Sisteme eklenen en güncel altyazıları tarihe göre tersten listeler. Dönen veri modeli Arama uç noktası ile aynıdır.

GET https://altyazidb.com/api/v1/latest

Parametre	Durum	Açıklama
`page`	Opsiyonel	Sayfa numarası. Varsayılan: `1`
`limit`	Opsiyonel	Sayfada kaç sonuç döneceği. Varsayılan: `20` (Maks: 100)

Direkt İndirme

API üzerinden dönen download_url yapısını kullanarak dosyayı indirmenizi sağlar.

GET https://altyazidb.com/api/v1/download

Parametre	Durum	Açıklama
`sub_id`	Zorunlu	İndirilecek altyazının veritabanı ID'si.

Not: Bu uç nokta JSON döndürmez; başarılı olması durumunda doğrudan dosyayı (stream) indirmenizi tetikler.

Altyazı Yükleme (Upload)

Sisteme doğrudan altyazı dosyası (zip, rar, srt) yüklemenizi sağlar.

Akıllı Otonom Bot Özelliği: Eğer yükleme isteğinizdeki imdb_id AltyaziDB sisteminde mevcut değilse, işlem iptal edilmez! API'miz arka planda TMDB'ye bağlanarak içeriği saniyeler içinde otomatik olarak taslak halinde oluşturur.

Sezon Paketi Yükleme (Önemli): Tekil bir bölüm yerine tüm sezonu içeren bir .zip arşivi yüklüyorsanız, isteğinizdeki episode parametresine PAKET yazmanız yeterlidir. Sistem bunu otomatik olarak paket etiketine dönüştürür.

Kopya Önleyici (Anti-Duplicate): API'miz yüklenen dosyaların MD5 hash'ini analiz eder. Birebir aynı dosya tekrar yüklenmek istenirse sistem 409 Conflict hatası vererek işlemi reddeder.

1. İstek Parametreleri (POST)

POST https://altyazidb.com/api/v1/upload

Parametre	Durum	Açıklama
`file`	Zorunlu	Yüklenecek altyazı dosyası (.zip, .rar, .srt). Max: 5MB
`imdb_id`	Zorunlu	Hangi yapıma eklenecekse onun IMDb ID'si.
`lang`	Zorunlu	Dil kodu (Örn: `tr`).
`season`	Opsiyonel	Diziler için sezon numarası (Örn: `1`).
`episode`	Opsiyonel	Diziler için bölüm numarası. Sezon paketi yüklüyorsanız PAKET yazın.
`fps`	Opsiyonel	Altyazının kare hızı (Örn: `23.976`).
`release`	Opsiyonel	Uyumlu olduğu sürüm bilgisi (Örn: `WEB-DL`).
`translator`	Opsiyonel	Çevirmen adı.
`translator_note`	Opsiyonel	Çevirmene ait özel not veya çeviri bilgisi (Örn: "Senkron kayması düzeltildi").
`hearing_impaired`	Opsiyonel	İşitme engelli (CC) altyazısı ise `1` gönderin.
`forced`	Opsiyonel	Forced altyazı ise `1` gönderin.

Örnek İstek (cURL)

curl -X POST "https://altyazidb.com/api/v1/upload" \
-H "X-API-Key: ANAHTARINIZ" \
-F "file=@/bilgisayar/yolu/altyazi.zip" \
-F "imdb_id=tt37529347" \
-F "lang=tr" \
-F "season=1" \
-F "episode=PAKET" \
-F "fps=23.976" \
-F "translator=NETRip" \
-F "release=WEB-DL"

Başarılı Yanıt (JSON)

{
  "success": true,
  "message": "Altyazı başarıyla yüklendi.",
  "sub_id": 6615,
  "post_id": 128
}

Etkileşimler (Favori & Rapor)

Altyazılar ile etkileşime girmek için kullanılan uç noktalardır.

Favoriye Ekle / Çıkar

POST https://altyazidb.com/api/v1/favorite

Gönderilmesi gereken parametre: sub_id (Zorunlu). Altyazı favorilerdeyse çıkarır, yoksa ekler.

Hatalı Altyazı Raporlama

POST https://altyazidb.com/api/v1/report

Gönderilmesi gereken parametreler: sub_id ve reason (Örn: "Çeviri tamamen google translate").

Hata Kodları

Kod	Anlamı	Açıklama
`400`	Bad Request	Eksik veya hatalı parametre gönderdiniz.
`401`	Unauthorized	API anahtarınız eksik veya geçersiz.
`403`	Forbidden	Yetkisiz işlem veya HTTP (güvensiz) bağlantı.
`404`	Not Found	Aradığınız ID'ye ait içerik mevcut değil.
`409`	Conflict	Bu dosya zaten veritabanında mevcut (MD5 Çakışması).
`413`	Payload Too Large	Dosya boyutu 5 MB sınırını aştı.
`429`	Too Many Requests	Hız sınırına takıldınız (Rate Limit).