🔧 Geliştirici Merkezi

NOSStream API ile güçlü uygulamalar geliştirin.

API anahtarı almak için giriş yapın.

📖 Genel Bakış

NOSStream REST API, platformdaki videoları aramanıza, kullanıcı verilerine erişmenize ve içerikleri kendi uygulamalarınıza entegre etmenize olanak tanır.

🌐

Base URL

https://nakreos.com/api/v1.php

🔒

Auth

API Key (Header veya Query)

📦

Format

JSON

⚡

Rate Limit

100 istek/saat

🔑 Kimlik Doğrulama

API anahtarınızı header veya query string ile gönderin:

# Header ile (önerilen)
curl -H "X-API-Key: YOUR_API_KEY" "https://nakreos.com/api/v1.php?action=search&q=test"

# Query string ile
curl "https://nakreos.com/api/v1.php?action=search&q=test&api_key=YOUR_API_KEY"

🔗 API Endpoint'leri

GET /api/v1.php?action=search

Video Arama

Tüm aktif platformlarda video, short veya görsel arar.

Parametre	Tip	Zorunlu	Açıklama
`q`	string	Evet	Arama sorgusu
`platform`	string	Hayır	all, youtube, dailymotion, vimeo vb.
`type`	string	Hayır	all, normal, short, image
`limit`	int	Hayır	Maks. 50, varsayılan 10

Örnek Yanıt:

{"success":true,"data":{"query":"test","count":10,"results":[{"platform":"youtube","id":"xxx","title":"...","thumbnail":"...","channel":"...","duration":120,"views":1000,"type":"normal"}]}}

GET /api/v1.php?action=trending

Trend Videolar

En popüler videoları getirir.

Parametre	Tip	Zorunlu	Açıklama
`platform`	string	Hayır	youtube (varsayılan)
`limit`	int	Hayır	Maks. 50

Örnek Yanıt:

{"success":true,"data":{"count":10,"results":[...]}}

GET /api/v1.php?action=user

Kullanıcı Bilgisi

Mevcut kullanıcının bilgilerini döner.

Örnek Yanıt:

{"success":true,"data":{"user":{"id":1,"username":"user","membership":"pro"}}}

GET /api/v1.php?action=saved

Kaydedilen Videolar

Kullanıcının kaydettiği videoları listeler.

Parametre	Tip	Zorunlu	Açıklama
`limit`	int	Hayır	Maks. 100
`offset`	int	Hayır	Sayfalama için

Örnek Yanıt:

{"success":true,"data":{"saved":[...]}}

GET /api/v1.php?action=categories

Kategoriler

Aktif kategorileri listeler.

Örnek Yanıt:

{"success":true,"data":{"categories":[...]}}

GET /api/v1.php?action=platforms

Platformlar

Aktif platformları listeler.

Örnek Yanıt:

{"success":true,"data":{"platforms":[...]}}

📺 Video Gömme

Videoları kendi sitenize iframe ile gömebilirsiniz.

Embed Parametreleri:

Parametre	Değerler	Açıklama
`platform`	youtube, dailymotion, vimeo, twitch, local	Video platformu
`id`	string	Video ID
`autoplay`	0 veya 1	Otomatik oynat (varsayılan: 1)
`controls`	0 veya 1	Kontroller (varsayılan: 1)
`theme`	dark, light	Tema (varsayılan: dark)

📦 Kod Örnekleri

// JavaScript (fetch)
const API_KEY = 'your_api_key_here';
const BASE = 'https://nakreos.com/api/v1.php';

async function searchVideos(query, platform = 'all') {
  const res = await fetch(`${BASE}?action=search&q=${encodeURIComponent(query)}&platform=${platform}`, {
    headers: { 'X-API-Key': API_KEY }
  });
  const data = await res.json();
  return data.data.results;
}

// Kullanım
searchVideos('php tutorial', 'youtube').then(videos => {
  videos.forEach(v => console.log(v.title, v.platform));
});