Referencia pública

SaberParaTodos API

Contrato público para consumir preguntas desde api.saberparatodos.space. El acceso premium usa /v1/premium/questions y el acceso público usa /v1/questions.

Generar API key Ver planes

Autorización

El endpoint premium acepta Authorization: Bearer YOUR_API_KEY o x-api-key. La clave se genera desde el dashboard y solo se muestra una vez.

Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

Endpoints

Premium

GET /v1/premium/questions

Respuesta autenticada con control de volumen y cuota.

Público

GET /v1/questions

Uso sin API key para prototipos, portales y pruebas públicas.

Parámetros

country: ejemplo co; envíalo según el tenant o dataset objetivo.
exam: ejemplo icfes; envíalo explícitamente y no dependas de defaults implícitos.
grade: 3, 5, 7, 9, 11.
subject: matematicas, lectura_critica, ingles, ciencias_naturales, sociales_y_ciudadanas.
page: página lógica del lote de preguntas.
limit: solo aplica al endpoint premium; el máximo depende del plan.

Ejemplo cURL

curl -X GET \
  "https://api.saberparatodos.space/v1/premium/questions?country=co&exam=icfes&grade=11&subject=matematicas&page=1&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta de ejemplo

{
  "success": true,
  "questions": [
    {
      "id": "SAMPLE-MAT-11-probability-advanced-001-PRO-v15",
      "statement": "...",
      "subject": "matematicas",
      "grade": 11,
      "options": [
        { "id": "A", "text": "...", "isCorrect": false, "weight": 0 }
      ],
      "correctOptionId": "C",
      "bundleId": "SAMPLE-MAT-11-probability-advanced-001-PRO",
      "protocol_version": "4.1"
    }
  ],
  "meta": {
    "total": 5,
    "country": "co",
    "grade": 11,
    "subject": "matematicas",
    "page": 1,
    "rate_limit": 60,
    "quota_remaining": 9995
  }
}

Notas de integración

Usa siempre api.saberparatodos.space como base pública.
El endpoint público es útil para validaciones iniciales y experiencias abiertas.
El endpoint premium es el contrato recomendado para integraciones de producción.
La especificación OpenAPI está embebida abajo para pruebas rápidas y validación manual.

OpenAPI

Explora el contrato público, parámetros y respuestas directamente desde esta referencia.