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.
| Campo | Valores compatibles | Predeterminado |
|---|---|---|
title | Cadena | Vacío |
columns | 1 | 2 | 2 |
workspace | compact | normal | roomy | normal |
fontSize | small | normal | large | normal |
showDifficulty | boolean | true |
showScore | boolean | false |
showAnswerKey | boolean | false |
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.pdfComprueba 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.
