ZonAPI Public Developer Platform & REST Architecture
ZonAPI is NovZon's public developer and data infrastructure platform. It exposes structured, rate-limited REST endpoints conforming to the OpenAPI 3.0.3 standard, enabling external applications, AI research agents, and developers to interface with the NovZon ecosystem.
- OpenAPI 3.0.3 machine-readable schema available at /api/v1/openapi.json.
- Aggregated platform discovery metrics at /api/v1/discovery/.
- Paginated novel taxonomy, metadata, and chapter indices at /api/v1/novels/.
- Full-text search queries across published serialized fiction at /api/v1/search/.
- Interactive developer playground with live cURL, JavaScript Fetch, and Python requests generation.
Hikâyelerin verisi, geliştiricilerin elinde.
Türkçe eser adları, açıklamalar, anime ve novel katalogları, tür taksonomisi ve yayın bilgilerini tek bir standart REST API üzerinden uygulamalarına taşı.
Edebiyat ve Anime Verisi Tek Standartta
NovZon'un genişletilmiş katalog mimarisi, farklı kaynak formatlarını geliştirici dostu tek tip REST nesnelerine dönüştürür.
Noveller & Web Romanlar
Yüzlerce çevrilmiş light novel ve web roman. Slug veya kalıcı ID (nvz_nov_*) ile sorgulama, durum filtreleri ve bölüm dizinleri.
Anime Kataloğu
AniZon ekosistemine bağlı animeler, Türkçe bölüm başlıkları, sezon bilgileri, yayın durumları ve tür sınıflandırması.
Evrenler & Seriler
Birbirine bağlı yan hikâyeler, ana romanlar ve ortak evren kurguları. Eserler arası bağları ve seri sıra numaralarını haritalandır.
Kategoriler & Türler
İsekai, Aksiyon, Bilim Kurgu ve Fantastik gibi edebiyat taksonomisi. Her türdeki aktif eser sayıları ve açıklamaları.
Yazarlar & Yaratıcılar
Orijinal eser yazarları, yazar profilleri ve eser indeksleri. Yazar bazında tüm bağlı romanları tek çağrıyla keşfet.
Birleşik Polimorfik Arama
Tek sorgu dizesiyle romanları, animeleri ve yazarları aynı anda tarayan merkezi arama motoru. Tür bazlı filtreleme desteklenir.
30 Saniyede İlk İsteğini Gönder
ZonAPI genel beta sürümünde tamamen anahtarsızdır (keyless). Herhangi bir kayıt, API token veya karmaşık yetkilendirme gerekmez.
# 1. Roman kataloğunu ilk sayfayla getir
curl -s "https://api.novzon.net/v1/novels/?page=1&page_size=2"
# 2. Belirli bir eserin detaylarını slug ile sorgula
curl -s "https://api.novzon.net/v1/novels/solo-leveling/"
# 3. Bölüm metadata listesini al (metin gövdesi içermez)
curl -s "https://api.novzon.net/v1/novels/solo-leveling/chapters/"
const BASE_URL = 'https://api.novzon.net/v1';
async function fetchNovels() {
try {
const res = await fetch(`${BASE_URL}/novels/?page_size=5`, {
headers: { 'Accept': 'application/json' }
});
if (!res.ok) {
throw new Error(`HTTP ${res.status}: ${res.statusText}`);
}
const { data, meta, links } = await res.json();
console.log(`Toplam Eser: ${meta.total_items}`);
data.forEach(novel => console.log(`- ${novel.title} (${novel.author.name})`));
} catch (err) {
console.error('API Hatası:', err);
}
}
fetchNovels();
import httpx
BASE_URL = "https://api.novzon.net/v1"
with httpx.Client(base_url=BASE_URL, timeout=10.0) as client:
response = client.get("/novels/", params={"page_size": 5})
response.raise_for_status()
payload = response.json()
novels = payload.get("data", [])
meta = payload.get("meta", {})
print(f"Toplam: {meta.get('total_items')} eser")
for novel in novels:
print(f"[{novel['slug']}] {novel['title']} - {novel['chapter_count']} bölüm")
API Gezgini (Live Console)
Doğrudan tarayıcından canlı okuma istekleri gönder. Güvenli parametrelerle gerçek API yanıtını, durum kodunu ve gecikme süresini anında incele.
// Parametrelerini seç ve "İsteği Gönder" butonuna tıkla...
Kapsamlı Referans ve Parametreler
Tüm kaynaklar salt-okunur (read-only) `GET` isteklerini kabul eder. Dual Identifier desteği sayesinde hem canonical slug hem de `nvz_*` public ID desteklenir.
nvz_nov_*).
nvz_news_* / UUID).
Endüstri Standartlarında API Mimarisi
ZonAPI, ağ verimliliği ve hata teşhisini kolaylaştırmak için modern RFC standartlarını ve HTTP/1.1 önbellek kurallarını uygular.
ETag başlığı ile döner. Tekrarlayan isteklerde If-None-Match başlığını göndererek içeriğin değişmediği durumlarda boş gövdeli HTTP 304 yanıtı alabilir, bant genişliğinizi sıfıra indirebilirsiniz.
application/problem+json formatındadır. Standart type, title, status, detail, instance ve request_id alanlarıyla öngörülebilir ve parse edilebilir hata yönetimi sağlar.
req_01j9a8b...) atar ve bunu X-Request-ID başlığıyla döner. Hata raporlarında veya destek taleplerinde bu izleme kodunu kullanarak doğrudan log korelasyonu sağlayabilirsiniz.
OpenAPI 3.0.3 Entegrasyonu
Postman, Insomnia, Swagger Codegen veya dilediğin SDK oluşturucu ile anında entegre ol. Güncel ve makine tarafından doğrulanmış spesifikasyon dosyaları.
OpenAPI JSON
Standart JSON formatında tüm endpoint tanımları, parametre şemaları ve tip modelleri.
OpenAPI YAML
Okunabilir YAML formatı. CI sözleşme denetçileri ve lokal dokümantasyon araçları için ideal.
Swagger UI
Görsel Swagger arayüzü ile tarayıcı üzerinden uç noktaları doğrudan test et.
Bir sonraki projeni ZonAPI ile oluştur.
Türkçe light novel ve anime verilerini botlarına, mobil uygulamalarına ve topluluk platformlarına dakikalar içinde entegre et. Mevcut genel beta sürümünde hesap veya anahtar gerekmez.