Erişim ve istekler
Anahtarsız, salt okunur, sunucu tarafında; kimlik, tarih ve eksik değer biçimleri.
Anahtar yok, kayıt yok
Herkese açık API için API anahtarı, belirteç ya da hesap gerekmez. Bu belgelerdeki her işlem kimliksiz bir GET isteğidir: gönder ve JSON'u oku.
curl "https://api.nogitsu.com/v1/works?limit=3"Yalnızca herkese açık veri
API, nogitsu.com'da herkesin zaten görebildiğini yayımlar. Hesaplar, kütüphaneler, profilin gizli bölümleri, moderasyon ve tüm yazma işlemleri herkese açık API'nin parçası değildir ve burada belgelenmez.
Kendi sunucundan çağır
Başka sitelerdeki web sayfaları API'yi tarayıcıdan çağıramaz: başka kökenden gelen isteklere yalnızca nogitsu.com için izin verilir. İstekleri sunucundan, bir betikten ya da derleme adımından gönder ve yanıtların bir kopyasını sakla.
Uygulamanı tanıt
Uygulamanı adlandıran bir User-Agent başlığı gönder, örneğin my-app/1.0. Ağ korumamız bazı kitaplıkların varsayılan tanıtımını, örneğin Python urllib'in gönderdiğini, JSON olmayan bir 403 sayfasıyla engeller.
curl -A "my-app/1.0 (+https://example.com)" "https://api.nogitsu.com/v1/genres"Kimlikler, tarihler ve eksik değerler
Yanıtlar UTF-8 JSON'dır. Kimlikler UUID'dir. Tarihler YYYY-AA-GG, anlar UTC'de ISO 8601 zaman damgası olarak yazılır. Bilinmeyen değer null'dır; hiçbir zaman 0 ya da boş metinle değiştirilmez.
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"startDate": "2018-03-04",
"season": null,
"seasonYear": null
}