NESTFILIMDEVELOPERS
NESTFILIM / PARTNER API

Kataloğunla
bağlantı kur.

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 · Anime
Gerçek yayın biçimiMP4 veya HLS
Anahtar 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.

ParametreDeğerAçıklama
typemovie · series · animeVarsayılan movie
page / limit1 / 24Sayfa başına 1–48 kayıt
year2026Gerçek yapım yılına göre filtre
qFilm adıBaşlıkta arama
categoryaksiyon · komedi · kovboyDoğrulanmış tür bilgisi
formatmp4 · hlsİçeriğin doğrulanan başlangıç yayını
GET /api/v1/catalog?type=movie&year=2026&page=1&limit=24
Örnek yanıt · şema örneğidir
{
  "success": true,
  "data": {
    "items": [{
      "id": "LISTEDEN_GELEN_24_KARAKTER_ID",
      "type": "movie", "title": "Film adı", "year": "2026",
      "format": "mp4", "verified": true,
      "isNew": true, "newLabel": "Bugün eklendi",
      "poster": "https://www.nestfilim.com/api/poster?..."
    }],
    "pagination": { "page": 1, "limit": 24, "total": 1, "pages": 1 }
  }
}
GET/content?type=series&id=…

Bölümler ayrı ayrı hazır olur.

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.

{ "season": 1, "episodes": [
  { "episode": 1, "available": true, "status": "ready" },
  { "episode": 2, "available": false, "status": "coming_soon", "statusLabel": "Yakında gelecek" }
] }
GET/playback?type=movie&id=…

Oynatmadan önce, güncel bağlantı.

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.

DurumAnlamİşlem
200Başarılıdata alanını oku
400Parametre hatasıtype, id ve filtreleri kontrol et
401 / 403Anahtar veya izin hatasıPanelden anahtarın durumunu kontrol et
404İçerik yayında değilKataloğu güncelle
409Bölüm henüz hazır değil“Yakında gelecek” göster
429Dakikalık kota dolduRetry-After süresini bekle
503Yayın veya servis erişilemiyorArtan 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.