Zugriff und Anfragen
Kein Schlüssel, nur lesend, serverseitig; Formate von IDs, Datumsangaben und fehlenden Werten.
Kein Schlüssel, keine Registrierung
Die öffentliche API braucht keinen API-Schlüssel, kein Token und kein Konto. Jede Operation in dieser Dokumentation ist eine anonyme GET-Anfrage: Sende sie und lies das JSON.
curl "https://api.nogitsu.com/v1/works?limit=3"Nur öffentliche Daten
Die API veröffentlicht, was jeder bereits auf nogitsu.com sehen kann. Konten, Bibliotheken, private Profilbereiche, Moderation und alle schreibenden Operationen gehören nicht zur öffentlichen API und sind hier nicht dokumentiert.
Ruf sie von deinem Server auf
Webseiten auf anderen Websites können die API nicht aus dem Browser aufrufen: Cross-Origin-Anfragen sind nur von nogitsu.com aus erlaubt. Sende Anfragen von deinem Server, einem Skript oder einem Build-Schritt und bewahre eine Kopie der Antworten auf.
Nenne deine Anwendung
Sende einen User-Agent-Header, der deine Anwendung nennt, etwa my-app/1.0. Unser Netzwerkschutz blockiert einige Standardkennungen von Bibliotheken, etwa die von Pythons urllib, mit einer 403-Seite, die kein JSON ist.
curl -A "my-app/1.0 (+https://example.com)" "https://api.nogitsu.com/v1/genres"IDs, Datumsangaben und fehlende Werte
Antworten sind UTF-8-JSON. IDs sind UUIDs. Datumsangaben werden als JJJJ-MM-TT geschrieben, Zeitpunkte als ISO-8601-Zeitstempel in UTC. Ein unbekannter Wert ist null; er wird nie durch 0 oder einen leeren Text ersetzt.
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"startDate": "2018-03-04",
"season": null,
"seasonYear": null
}