Documentación para desarrolladores

Generar PDF y LaTeX

Produce un PDF listo para imprimir o un fragmento/documento LaTeX con respuestas opcionales.

Dirigido a
Editoriales, herramientas docentes y autores de libros
Antes de empezar
Entradas de generación válidas y capacidad suficiente en el plan

PDF listo para imprimir

POST /worksheets/pdf genera los problemas y devuelve el archivo binario en una sola solicitud. Usa el cuerpo común más layout y showAnswerKey.

Opciones de diseño PDF
CampoValores compatiblesPredeterminado
titleCadenaVacío
columns1 | 22
workspacecompact | normal | roomynormal
fontSizesmall | normal | largenormal
showDifficultybooleantrue
showScorebooleanfalse
showAnswerKeybooleanfalse
curl -X POST "https://overthemathwall.com/api/public/v1/worksheets/pdf" \
  -H "Authorization: Bearer $OTMW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seed": 20260720,
    "locale": "en",
    "entries": [
      {"id":"division-1","grade":"grade3","topic":"division","difficulty":"easy","count":10}
    ],
    "layout": {
      "title": "Division practice",
      "columns": 2,
      "workspace": "normal",
      "fontSize": "normal",
      "showDifficulty": true,
      "showScore": false
    },
    "showAnswerKey": true
  }' \
  --output worksheet.pdf

Comprueba Content-Type antes de guardar el cuerpo. Si la respuesta no es 2xx, intenta analizar el JSON de error en lugar de guardar esos bytes como PDF. Usa únicamente los valores documentados; no dependas de la tolerancia actual ante opciones inválidas.

LaTeX

POST /worksheets/latex devuelve data.latex. document: false (predeterminado) produce un fragmento para incluir en otra obra; document: true produce un archivo completo con documentclass. showAnswerKey añade respuestas.

curl -X POST "https://overthemathwall.com/api/public/v1/worksheets/latex" \
  -H "Authorization: Bearer $OTMW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seed": 20260720,
    "locale": "en",
    "entries": [
      {"id":"multiplication-1","grade":"grade3","topic":"multiplication","difficulty":"hard","count":8}
    ],
    "title": "Practice set",
    "document": true,
    "showAnswerKey": true
  }'
{
  "data": {
    "latex": "\\documentclass{article} ... \\end{document}"
  }
}

Puedes enviar el valor como encoded_snip a la integración documentada de Overleaf. Revisa y compila la salida en un entorno controlado antes de incorporarla a una publicación.

Marca y consumo

El PDF incorpora la marca de salida configurada para el socio cuando corresponde. La configuración de marca de la API no modifica las hojas creadas por docentes en la aplicación, y la marca visual de la organización en Clerk es una configuración distinta. La salida LaTeX conserva el contenido matemático, pero no promete replicar todos los elementos visuales del PDF.

El crédito o cuota se confirma únicamente después de que la salida se genera correctamente; un fallo de generación o renderizado se revierte.