Nogitsu API
Une API JSON gratuite, en lecture seule, pour tout ce qui est public sur Nogitsu : le catalogue d’anime et de manga, les personnages, les personnes et les sociétés, les actualités, les bandes-annonces, le calendrier de diffusion, les critiques, les communautés et les listes publiques des membres.
- Adresse de base
- https://api.nogitsu.com
Votre première requête
Chaque opération est une simple requête GET. Il n’y a aucune clé à créer ni rien à signer. Cette requête renvoie les trois œuvres les plus populaires :
curl "https://api.nogitsu.com/v1/works?limit=3"La réponse est en JSON. Les listes placent les résultats dans items et l’adresse de la page suivante dans nextCursor :
{
"items": [
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"slug": "solo-leveling",
"medium": "manhwa",
"primaryTitle": "Solo Leveling",
"aggregateScore": 850,
"popularityRank": 1
},
{
"id": "01a0cb02-0a14-7877-911d-5b4dde76df72",
"slug": "attack-on-titan",
"medium": "anime",
"primaryTitle": "Attack on Titan",
"aggregateScore": 847,
"popularityRank": 1
},
{
"id": "01a0cb0a-37c1-7946-be38-bfc9f1a5af0e",
"slug": "berserk",
"medium": "manga",
"primaryTitle": "Berserk",
"aggregateScore": 908,
"popularityRank": 1
}
],
"nextCursor": "eyJ2YWx1ZSI6MSwiaWQiOiIwMWEwY2IwYS0zN2MxLTc5NDYtYmUzOC1iZmM5ZjFhNWFmMGUifQ"
}À savoir d’abord
- Pas de clé, de jeton ni d’inscription.
- Lecture seule : uniquement ce qui est public sur nogitsu.com.
- Appelez-la depuis votre serveur ; les navigateurs sur d’autres sites sont bloqués.
- 120 requêtes par minute pour chaque adresse.
- Gratuite pour un usage non commercial, en créditant Nogitsu.
Guides
- Accès et requêtesSans clé, en lecture seule, côté serveur ; formats des identifiants, des dates et des valeurs manquantes.
- Pages et curseursComment les opérations de liste découpent les résultats en pages et comment lire la suivante.
- ErreursLa forme unique des erreurs, les codes de statut et que faire pour chacun.
- Limites de débit et mise en cacheCombien de requêtes vous pouvez envoyer, les en-têtes qui vous l’indiquent et ce qu’il faut mettre en cache.
- LanguesObtenir les descriptions et les libellés dans l’une des douze langues du site.
- ImagesCouvertures, bannières et portraits : tailles, copies AVIF plus petites et droits.
- Licence et créditCe que vous pouvez faire des données, comment créditer Nogitsu et ce qui est exclu.
Opérations par thème
- Œuvres6 opérationsLe catalogue d’anime, de donghua, d’animation, de manga, de manhwa, de manhua et de webtoons : listes avec filtres, œuvres individuelles et vocabulaire des genres.
- Détails d’une œuvre10 opérationsTout ce qui figure sur une page d’œuvre au-delà du résumé : épisodes et chapitres, personnages, staff, œuvres liées, bandes-annonces, images, où regarder ou lire, et statistiques des membres.
- Recherche4 opérationsRecherche textuelle dans les œuvres et dans les personnages, personnes et sociétés, et recherche filtrée derrière la page Explorer.
- Personnages3 opérationsL’annuaire des personnages et les pages de personnages avec les œuvres où ils apparaissent.
- Personnes4 opérationsDoubleurs, auteurs, artistes et staff, avec leurs crédits et leurs rôles de doublage.
- Sociétés3 opérationsStudios, éditeurs et autres sociétés, avec les œuvres où ils sont crédités.
- Actualités3 opérationsDes actualités rédigées à partir des événements du catalogue : débuts et fins de parution, dates, retours après une pause, annonces de suites et nouvelles bandes-annonces.
- Bandes-annonces2 opérationsLe coin des bandes-annonces : bandes-annonces nouvelles, à venir, de la saison et populaires, ainsi que les bandes-annonces individuelles.
- Calendrier2 opérationsLes épisodes avec une heure de diffusion exacte, pour les prochains jours ou pour une période donnée.
- Critiques6 opérationsLes critiques des membres sur les œuvres, la synthèse des critiques d’une œuvre et les meilleurs critiques du mois.
- Communautés8 opérationsLes communautés du forum dans chaque langue, la communauté d’une œuvre, les tendances et le nombre de personnes en ligne.
- Publications et commentaires11 opérationsLes publications du forum, les arbres de commentaires, les textes de spoiler masqués et les fils de commentaires sous les œuvres, personnages, personnes, sociétés et critiques.
- Listes6 opérationsLes listes publiques créées par les membres, et les œuvres qu’elles contiennent.
- Membres13 opérationsLes profils publics des membres et les parties que chaque membre a choisi de montrer.