Nogitsu API
Una API JSON gratuita y de solo lectura sobre todo lo que es público en Nogitsu: el catálogo de anime y manga, personajes, personas y empresas, noticias, tráileres, el calendario de emisión, reseñas, comunidades y listas públicas de los miembros.
- Dirección base
- https://api.nogitsu.com
Tu primera solicitud
Cada operación es una simple solicitud GET. No hay ninguna clave que crear ni nada que firmar. Esta solicitud devuelve las tres obras más populares:
curl "https://api.nogitsu.com/v1/works?limit=3"La respuesta es JSON. Las listas ponen los resultados en items y la dirección de la página siguiente en 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"
}Lo que debes saber primero
- Sin clave, token ni registro.
- Solo lectura: únicamente lo que es público en nogitsu.com.
- Llámala desde tu servidor; los navegadores de otros sitios están bloqueados.
- 120 solicitudes por minuto por cada dirección.
- Gratuita para uso no comercial, mencionando a Nogitsu.
Guías
- Acceso y solicitudesSin clave, solo lectura, desde el servidor; formatos de identificadores, fechas y valores ausentes.
- Páginas y cursoresCómo las operaciones de lista dividen los resultados en páginas y cómo leer la siguiente.
- ErroresLa forma única de los errores, los códigos de estado y qué hacer con cada uno.
- Límites de solicitudes y cachéCuántas solicitudes puedes enviar, las cabeceras que te lo indican y qué guardar en caché.
- IdiomasObtener descripciones y etiquetas en uno de los doce idiomas del sitio.
- ImágenesPortadas, banners y retratos: tamaños, copias AVIF más pequeñas y derechos.
- Licencia y atribuciónQué puedes hacer con los datos, cómo mencionar a Nogitsu y qué queda excluido.
Operaciones por tema
- Obras6 operacionesEl catálogo de anime, donghua, animación, manga, manhwa, manhua y webtoons: listas con filtros, obras individuales y el vocabulario de géneros.
- Detalles de la obra10 operacionesTodo lo que hay en la página de una obra más allá del resumen: episodios y capítulos, personajes, equipo, obras relacionadas, tráileres, imágenes, dónde verla o leerla y estadísticas de los miembros.
- Búsqueda4 operacionesBúsqueda de texto en obras y en personajes, personas y empresas, y la búsqueda filtrada de la página Explorar.
- Personajes3 operacionesEl directorio de personajes y las páginas de personajes con las obras en las que aparecen.
- Personas4 operacionesActores de voz, autores, artistas y equipo, con sus créditos y papeles de voz.
- Empresas3 operacionesEstudios, editoriales y otras empresas, con las obras en cuyos créditos aparecen.
- Noticias3 operacionesNoticias escritas a partir de eventos del catálogo: estrenos y finales, fechas, regresos tras una pausa, anuncios de secuelas y nuevos tráileres.
- Tráileres2 operacionesEl rincón de tráileres: tráileres nuevos, próximos, de esta temporada y populares, y tráileres individuales.
- Calendario2 operacionesEpisodios con hora exacta de emisión, para los próximos días o para un intervalo de fechas.
- Reseñas6 operacionesReseñas de obras escritas por miembros, el resumen de reseñas de una obra y los mejores reseñadores del mes.
- Comunidades8 operacionesComunidades del foro en cada idioma, la comunidad de una obra, tendencias y cuántas personas hay en línea.
- Publicaciones y comentarios11 operacionesPublicaciones del foro, árboles de comentarios, textos de spoiler ocultos y los hilos de comentarios de obras, personajes, personas, empresas y reseñas.
- Listas6 operacionesListas públicas creadas por miembros y las obras que contienen.
- Miembros13 operacionesPerfiles públicos de los miembros y las partes que cada miembro ha decidido mostrar.