Accès et requêtes
Sans clé, en lecture seule, côté serveur ; formats des identifiants, des dates et des valeurs manquantes.
Ni clé ni inscription
L’API publique ne demande ni clé d’API, ni jeton, ni compte. Chaque opération de cette documentation est une requête GET anonyme : envoyez-la et lisez le JSON.
curl "https://api.nogitsu.com/v1/works?limit=3"Uniquement des données publiques
L’API publie ce que tout le monde peut déjà voir sur nogitsu.com. Les comptes, les bibliothèques, les sections privées des profils, la modération et toutes les opérations d’écriture ne font pas partie de l’API publique et ne sont pas documentés ici.
Appelez-la depuis votre serveur
Les pages web d’autres sites ne peuvent pas appeler l’API depuis le navigateur : les requêtes cross-origin ne sont autorisées que depuis nogitsu.com. Envoyez les requêtes depuis votre serveur, un script ou une étape de build, et conservez une copie des réponses.
Nommez votre application
Envoyez un en-tête User-Agent qui nomme votre application, par exemple my-app/1.0. Notre protection réseau bloque certains agents par défaut de bibliothèques, comme celui qu’envoie urllib de Python, avec une page 403 qui n’est pas du JSON.
curl -A "my-app/1.0 (+https://example.com)" "https://api.nogitsu.com/v1/genres"Identifiants, dates et valeurs manquantes
Les réponses sont en JSON UTF-8. Les identifiants sont des UUID. Les dates s’écrivent AAAA-MM-JJ et les instants sous forme d’horodatages ISO 8601 en UTC. Une valeur inconnue vaut null ; elle n’est jamais remplacée par 0 ni par un texte vide.
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"startDate": "2018-03-04",
"season": null,
"seasonYear": null
}