Formato de fichero
El fichero .json de un test: qué lleva y cómo abrirlo
Un test de CanQuiz se exporta como un fichero .json: texto con las preguntas, las opciones y las respuestas dentro. Aquí está su formato campo a campo, con un ejemplo que se abre en el navegador sin crear cuenta.
Se abre en app.canquiz.com/abrir. El fichero se lee en tu navegador.
Qué es y de dónde sale
Es lo que descargas desde la «Biblioteca»: en el menú «Más» de un test, «Descargar» y «Fichero de CanQuiz (para pasárselo a alguien)». Pesa unos pocos kilobytes, viaja por WhatsApp o por correo como cualquier adjunto y no caduca. Por eso los tests pasan de mano en mano así.
Si alguien te lo ha pasado, no hace falta entender nada de lo que sigue: suéltalo en app.canquiz.com/abrir y haz el test. Esta página es para quien quiere saber qué hay dentro, escribir uno a mano o hacer que otra herramienta los genere.
El nivel superior
El fichero es un objeto JSON. Lo único imprescindible es la lista de preguntas: si falta el objeto de ajustes, CanQuiz lo rellena con los valores por defecto.
questionslistaobligatorio- Las preguntas, en el orden en que salen. Al menos una. Cada una se describe más abajo.
settingsobjeto- Cómo se hace el test: barajar, nota para aprobar, explicaciones. Puede faltar, y entonces CanQuiz pone los ajustes por defecto; todos sus campos son opcionales.
metadataobjeto- Datos del test. El que usa CanQuiz al abrirlo es title_suggestion, el título que se propone si el fichero no trae otro, de hasta 120 caracteres. El resto se conserva tal cual.
_canquiz_urltexto- Lo añade la exportación junto a _canquiz y _canquiz_titulo: el enlace del test, solo si estaba compartido por enlace, una nota de una línea y el título con que se descargó. Al abrir el fichero se quitan, así que puedes borrarlos o dejarlos.
También se abre el mismo contenido envuelto en otro objeto con dos campos, title y content: title pasa a ser el título del test y content lleva questions, settings y metadata.
Cada pregunta
Los mismos campos para todos los tipos. Las respuestas se comparan por texto exacto, así que lo que pongas en correct_answer tiene que estar escrito igual que en options.
idtextoobligatorio- Un identificador corto, como q1, q2, q3. No se enseña, pero no puede repetirse dentro del test: importar a una cuenta rechaza los repetidos.
typetextoobligatorio- El tipo de pregunta, tal cual: single_choice, multiple_choice, true_false, question_answer o short_answer. Están explicados en la sección siguiente.
questiontextoobligatorio- El enunciado, hasta 2000 caracteres. Solo texto: el formato no lleva imágenes.
optionslista- Las opciones, cada una de hasta 1000 caracteres. Obligatorias en las de elegir; las preguntas abiertas no llevan este campo.
correct_answertexto o listaobligatorio- El texto exacto de la opción correcta, o una lista de textos en multiple_choice. En las abiertas, la respuesta esperada. Hasta 2000 caracteres.
explanationtexto- Por qué es correcta, hasta 20000 caracteres. Se enseña al corregir si el test tiene activadas las explicaciones.
Tipos de pregunta
El valor de type decide qué campos hacen falta y cómo se corrige la respuesta.
single_choiceuna respuesta- Una sola opción correcta entre varias. correct_answer es un texto que tiene que coincidir con una de las options.
multiple_choicevarias respuestas- Al menos dos opciones, y una o más correctas. correct_answer es una lista con el texto de cada opción correcta.
true_falseverdadero o falso- Exactamente dos opciones, en el idioma que quieras (Verdadero y Falso, True y False). correct_answer es una de las dos.
question_answerpregunta abierta- Sin options. Se contesta escribiendo y la corrige la IA comparando con correct_answer, que es la respuesta esperada. Esa corrección necesita cuenta.
short_answerrespuesta corta- Sin options. Se contesta con una palabra o una frase breve y se compara con la respuesta correcta sin tener en cuenta mayúsculas, tildes, signos ni un artículo delante; si no coincide, la IA mira si significa lo mismo. correct_answer puede ser una lista de respuestas válidas.
Los ajustes
Todos opcionales. Si falta uno, se entiende que está apagado o que vale lo de siempre.
shuffle_questionstrue o false- Baraja el orden de las preguntas cada vez que se hace el test.
shuffle_optionstrue o false- Baraja el orden de las opciones dentro de cada pregunta.
passing_scorenúmero- El porcentaje para aprobar, de 0 a 100. Se acepta y se conserva, pero hoy CanQuiz no lo aplica: el resultado no dice si apruebas o suspendes.
show_explanationtrue o false- Enseña la explicación al corregir cada pregunta.
show_progresstrue o false- Enseña cuántas preguntas llevas y cuántas quedan.
time_limitnúmero- Un límite en segundos, mayor que 0. Se acepta y se conserva, pero hoy CanQuiz no lo aplica: un test suelto no tiene cuenta atrás.
ai_strictness_levelnúmero- De 1 a 10: lo exigente que es la corrección con IA de las preguntas abiertas.
Un ejemplo completo
Cuatro preguntas de cuatro tipos distintos, con sus ajustes, y todas se corrigen sin cuenta. Cópialo o descárgalo y ábrelo en app.canquiz.com/abrir para ver cómo queda.
{
"metadata": {
"title_suggestion": "El agua (ejemplo)"
},
"settings": {
"shuffle_questions": false,
"shuffle_options": true,
"passing_score": 70,
"show_explanation": true,
"show_progress": true
},
"questions": [
{
"id": "q1",
"type": "single_choice",
"question": "¿A qué temperatura hierve el agua pura a nivel del mar?",
"options": [
"90 °C",
"100 °C",
"110 °C",
"120 °C"
],
"correct_answer": "100 °C",
"explanation": "A una atmósfera de presión, el agua pura hierve a 100 °C."
},
{
"id": "q2",
"type": "multiple_choice",
"question": "¿Qué elementos forman una molécula de agua?",
"options": [
"Hidrógeno",
"Oxígeno",
"Carbono",
"Nitrógeno"
],
"correct_answer": [
"Hidrógeno",
"Oxígeno"
],
"explanation": "H₂O: dos átomos de hidrógeno y uno de oxígeno."
},
{
"id": "q3",
"type": "true_false",
"question": "El hielo flota en el agua líquida porque es menos denso que ella.",
"options": [
"Verdadero",
"Falso"
],
"correct_answer": "Verdadero",
"explanation": "Al congelarse, el agua se expande y su densidad baja a unos 0,92 g/cm³."
},
{
"id": "q4",
"type": "short_answer",
"question": "¿Cómo se llama el paso del agua de líquido a gas por debajo de su punto de ebullición?",
"correct_answer": "Evaporación",
"explanation": "Ocurre en la superficie a cualquier temperatura: por eso la ropa tendida se seca sin llegar a 100 °C."
}
]
}Si lo editas, guárdalo como texto con la extensión .json. Un editor de código avisa si se te escapa una coma o unas comillas.
Por qué un fichero no se abre
Al abrir un fichero, CanQuiz no adivina: o cumple el formato o avisa. Estos son los fallos de siempre.
La correcta como letra
«B» o «2» en correct_answer no valen en un fichero: tiene que ir el texto de la opción, escrito igual.
Sin preguntas
questions tiene que estar y llevar al menos una pregunta. settings, en cambio, puede faltar: CanQuiz pone los ajustes por defecto.
Un verdadero o falso con más de dos opciones
true_false lleva exactamente dos. Para tres o más, usa single_choice.
Una abierta con opciones
question_answer no puede llevar options. Si tiene opciones, es una de elegir.
Un tipo mal escrito
multiple-choice con guion o MultipleChoice no son tipos: se escriben en minúsculas y con guion bajo.
Un texto demasiado largo
Cada campo tiene su tope de caracteres, puesto para parar ficheros absurdos: un enunciado de más de dos mil caracteres ya no se abre.
Ids repetidos
Dos preguntas con el mismo id se pueden hacer sin cuenta, pero no se pueden importar a una cuenta.
Si quieres que lo haga una IA
No hace falta escribir el JSON. Con el plugin de CanQuiz en ChatGPT le pides el test y se guarda en tu cuenta, listo para hacerlo. Cómo se hace está en cómo hacer preguntas tipo test con ChatGPT.
Preguntas frecuentes
¿Necesito cuenta para abrir un .json?
No. En app.canquiz.com/abrir lo sueltas o lo eliges, y haces el test entero, con correcciones y explicaciones. La cuenta solo hace falta para guardarlo, repasarlo más adelante o editarlo: pulsa «Entrar y guardarlo» y, al volver, el test queda en tu cuenta con lo que llevabas respondido. Entonces el test pasa a ser tuyo y quien te lo pasó ya no puede cambiarlo.
¿El fichero se sube a algún servidor?
Mientras no entres en una cuenta, el fichero no se guarda en ningún sitio: el navegador lo lee en tu dispositivo y el test se hace ahí. Solo si una respuesta corta no coincide con la correcta, esa pregunta y lo que escribiste van a la IA para ver si significa lo mismo, sin guardarse. Si decides guardar el test, entonces sí se guarda en tu cuenta de CanQuiz.
¿Cómo exporto un test mío a JSON?
En la «Biblioteca», abre el menú «Más» del test, pulsa «Descargar» y elige «Fichero de CanQuiz (para pasárselo a alguien)». Desde el mismo menú salen también «Hoja de cálculo (CSV)» y «Anki (texto con tabuladores)».
¿Puedo escribir un test a mano en este formato?
Sí. Parte del ejemplo de esta página, cambia preguntas y respuestas con cualquier editor de texto y guárdalo con la extensión .json. Si al abrirlo no va, revisa primero que cada correct_answer esté escrito exactamente igual que su opción.
¿Puede generarlo otra IA o un programa mío?
Sí, es JSON normal. Si lo genera un programa, sigue los campos de esta página y el fichero se abrirá como uno exportado. Si quieres que lo haga un chat de IA, es más cómodo el plugin de CanQuiz en ChatGPT o conectar tu cuenta a Claude: el test se guarda solo, sin fichero.
¿Abre ficheros de Quizlet, Kahoot o un CSV?
No. CanQuiz solo importa su propio JSON. Exporta a JSON, CSV y Anki, pero no importa desde esas herramientas ni exporta a Quizlet o Kahoot. Si tienes las preguntas en otro sitio, puedes pegarlas como texto y dejar que la IA monte el test.
¿Cuántas preguntas caben en un fichero?
Al abrirlo, CanQuiz no fija un número máximo de preguntas: lo que tiene tope es el texto de cada campo, de dos mil caracteres en el enunciado a veinte mil en la explicación. Un test largo sigue pesando poco, unos pocos kilobytes de texto.
¿Te han pasado un .json?
Suéltalo en CanQuiz y haz el test ahora, en tu navegador y sin crear cuenta.