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

  1. Consulta GET /catalog con el locale deseado y conserva únicamente temas con implemented: true.
  2. Construye entries con identificadores únicos, dificultad compatible y un count entre 1 y 30.
  3. Envía POST /worksheets desde tu servidor y valida response.ok antes de leer data.
  4. 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.