Documentación para desarrolladores
Generar hojas en JSON
Genera datos estructurados de preguntas y respuestas para tu propio diseño o material educativo.
- Dirigido a
- Editoriales, desarrolladores de aplicaciones y autores de contenido
- Antes de empezar
- Identificadores válidos de grado y de tema implementado obtenidos del catálogo
Guía
- Consulta GET /catalog con el locale deseado y conserva únicamente temas con implemented: true.
- Construye entries con identificadores únicos, dificultad compatible y un count entre 1 y 30.
- Envía POST /worksheets desde tu servidor y valida response.ok antes de leer data.
- Relaciona cada elemento de data.entries por su posición e id y presenta prompt/answer con un renderizador matemático compatible.
curl -i -X POST "https://overthemathwall.com/api/public/v1/worksheets" \
-H "Authorization: Bearer $OTMW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"seed": 20260720,
"locale": "en",
"entries": [
{
"id": "fractions-1",
"grade": "grade5",
"topic": "fractions",
"difficulty": "medium",
"count": 10
}
]
}'Datos devueltos
{
"data": {
"entries": [{
"id": "fractions-1",
"grade": "grade5",
"topic": "fractions",
"difficulty": "medium",
"problems": [{
"id": "generated-uuid",
"prompt": "3 \\times 4 = ?",
"answer": "12"
}]
}]
}
}prompt y answer contienen cadenas matemáticas de estilo LaTeX, no HTML sanitizado. Trátalas como datos no confiables al incorporarlas en tu interfaz. El id de cada problema es opaco y no es determinista.
Semillas y caché propia
Guarda la seed, locale y entries si necesitas reconstruir el mismo contenido. Esa combinación reproduce las preguntas y respuestas mientras el comportamiento v1 sea compatible, pero genera nuevos UUID de problema. Si necesitas referencias estables en tu producto, asigna tus propios ids al guardar la respuesta.
