Documentación para desarrolladores

Crea tu primera hoja en cinco minutos

Crea una clave de API para servidor, consulta el catálogo gratuito y genera una hoja en JSON.

Dirigido a
Desarrolladores individuales o de organizaciones, editoriales y autores
Antes de empezar
Una cuenta de Over The Math Wall y un servidor o terminal que pueda hacer solicitudes HTTPS

1. Crea una clave

Inicia sesión, abre el portal de desarrolladores, añade una etiqueta reconocible, acepta los Términos de la API y crea la clave. El secreto completo se muestra una sola vez.

export OTMW_API_KEY="otmw_live_..."

2. Consulta el catálogo gratuito

El catálogo requiere autenticación, pero no consume créditos. Usa únicamente temas con implemented: true y una dificultad incluida en su lista.

curl "https://overthemathwall.com/api/public/v1/catalog?locale=en" \
  -H "Authorization: Bearer $OTMW_API_KEY"

3. Genera diez problemas

Copia los identificadores grade y topic del catálogo. El id de la entrada lo eliges tú y vuelve en la respuesta para que puedas relacionar resultados.

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
      }
    ]
  }'

4. Verifica la respuesta y el uso

Una respuesta 200 contiene data.entries y los problemas con prompt y answer. En una cuenta prepago, X-RateLimit-Remaining muestra el saldo posterior a la solicitud. Esta solicitud de diez problemas cuesta un crédito.

HTTP/2 200
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 49

{
  "data": {
    "entries": [{
      "id": "fractions-1",
      "grade": "grade5",
      "topic": "fractions",
      "difficulty": "medium",
      "problems": [{"id":"...","prompt":"...","answer":"..."}]
    }]
  }
}