API di Nogitsu
Un'API JSON gratuita e in sola lettura su tutto ciò che è pubblico su Nogitsu: il catalogo anime e manga, personaggi, persone e società, notizie, trailer, il calendario delle uscite, recensioni, community e liste pubbliche dei membri.
- Indirizzo di base
- https://api.nogitsu.com
La tua prima richiesta
Ogni operazione è una semplice richiesta GET. Non c'è nessuna chiave da creare e niente da firmare. Questa richiesta restituisce le tre opere più popolari:
curl "https://api.nogitsu.com/v1/works?limit=3"La risposta è in JSON. Gli elenchi mettono i risultati in items e l'indirizzo della pagina successiva in 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"
}Cosa sapere prima
- Nessuna chiave, token o registrazione.
- Sola lettura: solo ciò che è pubblico su nogitsu.com.
- Chiamala dal tuo server; i browser su altri siti sono bloccati.
- 120 richieste al minuto per ogni indirizzo.
- Gratuita per uso non commerciale, citando Nogitsu.
Guide
- Accesso e richiesteNessuna chiave, sola lettura, lato server; formati di id, date e valori mancanti.
- Pagine e cursoriCome le operazioni di elenco dividono i risultati in pagine e come leggere la successiva.
- ErroriL'unica forma degli errori, i codici di stato e cosa fare per ciascuno.
- Limiti di frequenza e cacheQuante richieste puoi inviare, gli header che te lo indicano e cosa mettere in cache.
- LingueOttenere descrizioni ed etichette in una delle dodici lingue del sito.
- ImmaginiCopertine, banner e ritratti: dimensioni, copie AVIF più piccole e diritti.
- Licenza e attribuzioneCosa puoi fare con i dati, come citare Nogitsu e cosa è escluso.
Operazioni per argomento
- Opere6 operazioniIl catalogo di anime, donghua, animazione, manga, manhwa, manhua e webtoon: elenchi con filtri, singole opere e il vocabolario dei generi.
- Dettagli dell'opera10 operazioniTutto ciò che c'è nella pagina di un'opera oltre al riepilogo: episodi e capitoli, personaggi, staff, opere correlate, trailer, immagini, dove guardarla o leggerla e statistiche dei membri.
- Ricerca4 operazioniRicerca testuale su opere e su personaggi, persone e società, e la ricerca filtrata dietro la pagina Esplora.
- Personaggi3 operazioniL'elenco dei personaggi e le pagine dei personaggi con le opere in cui compaiono.
- Persone4 operazioniDoppiatori, autori, artisti e staff, con i loro crediti e ruoli da doppiatore.
- Società3 operazioniStudi, editori e altre società, con le opere in cui sono accreditati.
- Notizie3 operazioniNotizie scritte a partire dagli eventi del catalogo: inizio e fine delle uscite, date, ritorni dopo una pausa, annunci di seguiti e nuovi trailer.
- Trailer2 operazioniL'Angolo trailer: trailer nuovi, in arrivo, di questa stagione e popolari, e singoli trailer.
- Calendario2 operazioniEpisodi con orari di uscita esatti, per i prossimi giorni o per un intervallo di date.
- Recensioni6 operazioniLe recensioni delle opere scritte dai membri, il riepilogo delle recensioni di un'opera e i migliori recensori del mese.
- Community8 operazioniLe community del forum in ogni lingua, la community di un'opera, le tendenze e quante persone sono online.
- Post e commenti11 operazioniPost del forum, alberi di commenti, testi spoiler nascosti e i thread di commenti sotto opere, personaggi, persone, società e recensioni.
- Liste6 operazioniLe liste pubbliche create dai membri e le opere che contengono.
- Membri13 operazioniI profili pubblici dei membri e le parti che ciascun membro ha scelto di mostrare.