API de datos abiertos
Los datos que recopilamos en Kame School se pueden reutilizar libremente. La API es un conjunto de ficheros JSON estáticos: sin clave, sin registro, sin límites de uso y con CORS abierto, así que se pueden consultar desde cualquier web o programa.
Licencia
Los datos se publican con licencia Creative Commons Atribución-CompartirIgual 4.0 Internacional (CC BY-SA 4.0). Puedes copiarlos, transformarlos y usarlos para cualquier fin, también comercial, con dos condiciones:
- Atribución: cita a Kame School y a las fuentes. Por ejemplo:
Datos: Kame School (kameschool.com), CC BY-SA 4.0, con datos de Wikipedia y Kanzenshuu. - Compartir igual: si publicas datos derivados, hazlo con la misma licencia o una compatible.
La licencia cubre lo que es de Kame School: la selección y organización de los datos, las traducciones al castellano y los textos propios de cada ficha. No da ningún derecho sobre Dragon Ball: la obra, sus personajes, sus títulos originales y sus marcas pertenecen a Bird Studio, Shueisha y Toei Animation. Los títulos japoneses y los títulos ingleses de Viz se incluyen como dato de referencia.
Recursos (versión 1)
| Ruta | Contenido |
|---|---|
/api/v1/index.json | Índice de recursos |
/api/v1/fuentes.json | Fuentes de los datos, con licencia y revisión exacta |
/api/v1/manga/index.json | Obras de manga disponibles |
/api/v1/manga/dragon-ball.json | Ficha de la obra, sagas, arcos y resumen de tomos |
/api/v1/manga/dragon-ball/capitulos.json | Los 519 capítulos |
/api/v1/manga/dragon-ball/capitulos/{numero}.json | Un capítulo (1–519) |
/api/v1/manga/dragon-ball/tomos.json | Los 42 tomos japoneses |
/api/v1/manga/dragon-ball/tomos/{numero}.json | Un tomo (1–42) con su lista de capítulos |
/api/v1/manga/dragon-ball/sagas.json | Sagas oficiales, arcos y volúmenes Full Color |
/api/v1/esquemas/manga-capitulo.schema.json | JSON Schema de un capítulo |
Cada respuesta lleva la licencia y la atribución junto a los datos (campo datos); las listas incluyen además la fecha de generación y las fuentes. La versión 1 no cambiará de forma incompatible: los cambios que rompan la estructura irán a /api/v2/.
Ejemplo: un capítulo
{
"id": "dragon-ball/1",
"obra": "dragon-ball",
"numero": 1,
"titulo": {
"ja": "ブルマと孫悟空",
"ja_romaji": "Buruma to Son Gokū",
"es": "Bulma y Son Goku",
"en_literal": "Bulma and Son Goku",
"en_viz": "Bloomers and the Monkey King"
},
"titulo_es_fuente": "traduccion_kame_school",
"tomo": 1,
"saga": "ninez",
"arco": "son-goku",
"publicacion": {
"revista": "Weekly Shōnen Jump",
"anio": 1984,
"numero": "51",
"fecha_venta": "1984-11-20"
},
"ediciones": {
"full_color": {
"saga": "ninez",
"volumen": 1
},
"viz": {
"serie": "Dragon Ball",
"volumen": 1,
"capitulo": 1
}
},
"verificacion": {
"nivel": "referencia_secundaria",
"nota": "Contrastado entre Wikipedia y Kanzenshuu; no comprobado aún en la edición impresa."
},
"fuentes": [
"wikipedia-db",
"kanzenshuu"
],
"url": "https://kameschool.com/es/manga/dragon-ball/capitulo-1/"
} El campo verificacion.nivel indica cuánto se ha comprobado cada dato: referencia_secundaria significa que se ha contrastado entre fuentes publicadas, pero aún no en la edición impresa. Los títulos en castellano son traducción propia (titulo_es_fuente: "traduccion_kame_school"), no los de la edición española.
Fuentes
- Wikipedia en inglés: List of Dragon Ball chapters (series) (CC BY-SA 4.0): Títulos japoneses, transliteración, traducción literal inglesa y títulos de Viz (capítulos 1-194); tomos 1-16.
- Wikipedia en inglés: List of Dragon Ball Z chapters (CC BY-SA 4.0): Lo mismo para los capítulos 195-519 y los tomos 17-42.
- Wikipedia en inglés: List of Dragon Ball manga volumes (CC BY-SA 4.0): Página principal de la que se transcluyen las dos listas.
- Kanzenshuu: Dragon Ball Chapter List y Series Information (Datos fácticos (sin textos)): Número y fecha de venta de Weekly Shōnen Jump, reparto en tomos japoneses, edición Full Color y arcos; contraste de los títulos japoneses.
¿Has encontrado un error o reutilizas los datos? Escríbenos a hola@thelegaletters.com.