Doğrulanmış filmler, diziler ve animeler. Kalıcı içerik kimlikleri, güncel bölüm durumları ve oynatma adresleri, tek bir API altında.
BASE URLhttps://www.nestfilim.com/api/v1
3 içerik türüFilm · Dizi · AnimeGerçek yayın biçimiMP4 veya HLSAnahtar bazlı erişimBasic veya Bearer
01 / BAĞLAN
Bir firma, bir API anahtarı.
Yönetim panelinden her entegrasyon için ayrı anahtar oluştur. Kullanıcı adı anahtar kimliği, parola ise gizli kısımdır. Anahtarın tamamı kimlik.gizliKısım biçimindedir. Anahtar yalnızca oluşturulduğu anda gösterilir.
Anahtarı sunucu ortam değişkeninde tut. URL sorgusuna veya halka açık JavaScript dosyasına yazma. Tarayıcılar arası doğrudan erişim yerine kendi backend’in üzerinden kullan.
GET/catalog
Yeni eklenenler, ilk sırada.
Yalnızca geçerli medya doğrulaması olan içerikler döner. Yeniden kontrol edilen eski bir film, yeni eklenmiş sayılmaz. Her türün son üç yeni içeriğinde en fazla yedi gün boyunca isNew alanı bulunur.
Parametre
Değer
Açıklama
type
movie · series · anime
Varsayılan movie
page / limit
1 / 24
Sayfa başına 1–48 kayıt
year
2026
Gerçek yapım yılına göre filtre
q
Film adı
Başlıkta arama
category
aksiyon · komedi · kovboy
Doğrulanmış tür bilgisi
format
mp4 · hls
İçeriğin doğrulanan başlangıç yayını
GET /api/v1/catalog?type=movie&year=2026&page=1&limit=24
Bir dizinin doğrulanmış bölümleri hemen oynatılabilir. Bilinen diğer sezonlar ve eksik bölümler listede kalır: available: false, status: "coming_soon". Bu bölümleri “Yakında gelecek” olarak göster ve oynatma düğmesini kapat.
Film için type ve id; bölüm için ayrıca season ve episode gönder. Dönen source adresini oynatıcına aktar. MP4, HTML video öğesinde; HLS, destekleyen bir oynatıcıda açılır.
GET /api/v1/playback?type=series&id=…&season=1&episode=1
Kaynak kalitesi korunur.
1080p bir video 4K olarak etiketlenmez. Çözünürlük seçenekleri gerçek akış manifestinden alınır. Yayın bağlantıları süreli olabilir; kalıcı bir MP4 arşivi gibi saklama. Erişim durumu sağlayıcıya, ağa ve doğrulama zamanına bağlıdır.
02 / GELİŞTİR
Hafif bir JavaScript istemcisi.
Ek paket gerektirmez. Modern Node.js sunucunda istemci modülünü indir, anahtarı ortam değişkeninden ver.
import { NestFilmClient } from './nestfilm-client.mjs';
const film = new NestFilmClient({
baseUrl: 'https://www.nestfilim.com/api/v1',
token: process.env.NESTFILM_API_KEY
});
const page = await film.catalog({ type: 'movie', year: 2026 });
const item = page.items[0];
if (item) {
const details = await film.content(item.id, item.type);
const media = await film.playback(item.id, item.type);
console.log(media.format, media.source);
}
Öngörülebilir yanıtlar.
Durum
Anlam
İşlem
200
Başarılı
data alanını oku
400
Parametre hatası
type, id ve filtreleri kontrol et
401 / 403
Anahtar veya izin hatası
Panelden anahtarın durumunu kontrol et
404
İçerik yayında değil
Kataloğu güncelle
409
Bölüm henüz hazır değil
“Yakında gelecek” göster
429
Dakikalık kota doldu
Retry-After süresini bekle
503
Yayın veya servis erişilemiyor
Artan beklemeyle tekrar dene
X-RateLimit-Remaining kalan istek sayısını, X-RateLimit-Reset sıfırlanma zamanını Unix saniyesiyle verir. Varsayılan kota anahtar başına dakikada 120 istektir.
CANLI API DENEMESİ
İlk isteğini gönder.
Anahtar yalnızca bu sayfanın belleğinde tutulur. Sayfa yenilendiğinde temizlenir.
Yanıt burada görünecek.
Logolu video bağlantısı
Partner API oynatma yanıtındaki source ve branded_source, NF logosu görüntüye işlenmiş MP4 sürümünü verir. sourceFormat özgün kaynak biçimini belirtir. İlk istek dosyayı hazırlar, sonraki istekler önbelleği kullanır. Hazır dosyalarda ileri ve geri sarma desteklenir; ses korunur. Bağlantıdaki erişim imzasını değiştirme.