📡 API Documentation

http://localhost:8000

# Primero, hacer login y guardar cookies
curl -c cookies.txt -X POST http://localhost:8000/login.php \
  -d "nombre_usuario=test&contrasena=Test1234"
# Luego usar -b cookies.txt en otras peticiones
curl -b cookies.txt -X POST http://localhost:8000/src/funciones.php \
  -d "accion=obtener_estado"

curl http://localhost:8000/index.php

curl -c cookies.txt -X POST http://localhost:8000/login.php \
  -d "nombre_usuario=test&contrasena=Test1234"

curl -X POST http://localhost:8000/register.php \
  -d "nombre_usuario=newuser&correo=new@example.com&contrasena=Test1234&confirmar_contrasena=Test1234"

curl -I "http://localhost:8000/auth_provider.php?provider=google"

curl -b cookies.txt -X POST http://localhost:8000/ai_tutor.php \
  -d "slug=past-simple-2025&lesson_title=PAST SIMPLE DOMINATION 2025&lesson_subject=Inglés&question=¿Qué significa did?"

curl -c cookies.txt http://localhost:8000/guest_login.php

curl -b cookies.txt http://localhost:8000/dashboard.php

curl -b cookies.txt "http://localhost:8000/leccion_detalle.php?slug=b1-past-simple-2025&materia=Inglés"

curl -b cookies.txt http://localhost:8000/logout.php

{
  "ok": true,
  "score": 8,
  "xp_ganado": 80,
  "new_puntos": 580,
  "new_nivel": 2,
  "nuevo_badge": null,
  "details": [
    {
      "pregunta": "¿Pregunta 1?",
      "correcta": "Respuesta A",
      "respuesta": "Respuesta A",
      "acertada": true
    },
    {
      "pregunta": "¿Pregunta 2?",
      "correcta": "Respuesta B",
      "respuesta": "Respuesta C",
      "acertada": false
    }
  ]
}

{
  "ok": false,
  "error": "Lección no encontrada" | "Usuario no autenticado" | "Error BD"
}

curl -b cookies.txt -X POST http://localhost:8000/src/funciones.php \
  -d "accion=calificar_quiz&slug=b1-past-simple-2025&q0=The+students+studied&q1=Yesterday&q2=Yes"

{
  "ok": true,
  "usuario_id": 1,
  "nombre_usuario": "test",
  "puntos": 580,
  "nivel": 2,
  "progreso": 30,
  "badges": [
    {
      "id": 1,
      "nombre": "Primer Paso",
      "descripcion": "Completa tu primera lección",
      "tipo": "bronze",
      "otorgado_en": "2025-01-05 10:30:00"
    }
  ],
  "ranking": [
    {
      "rank": 1,
      "nombre_usuario": "usuario1",
      "puntos": 1500,
      "es_actual": false
    },
    {
      "rank": 2,
      "nombre_usuario": "test",
      "puntos": 580,
      "es_actual": true
    }
  ]
}

curl -b cookies.txt -X POST http://localhost:8000/src/funciones.php \
  -d "accion=obtener_estado"

{
  "ok": true,
  "completed": true,
  "xp_ganado": 50,
  "new_puntos": 630
}

curl -b cookies.txt -X POST http://localhost:8000/src/funciones.php \
  -d "accion=completar&slug=b1-past-simple-2025&xp=50"

curl http://localhost:8000/mapa/index.html

{
  "maestro": "Miguel",
  "materia": "Inglés"
}

{
  "success": true,
  "message": "Registro insertado",
  "maestro": "Miguel",
  "materia": "Inglés"
}

{
  "success": false,
  "error": "Parámetros requeridos faltantes"
}

curl -X POST http://localhost:8000/mapa/updateDB.php \
  -H "Content-Type: application/json" \
  -d '{"maestro":"Miguel","materia":"Inglés"}'

curl -b cookies.txt -X POST http://localhost:8000/update_progress.php \
  -d "slug=b1-past-simple-2025&correctas=8&xp=80"

{
  "ok": false,
  "error": "Mensaje descriptivo del error"
}

#!/bin/bash
BASE="http://localhost:8000"
COOKIE_JAR="cookies.txt"
# 1. Registrar nuevo usuario
echo "1. Registrando usuario..."
curl -X POST "$BASE/register.php" \
  -d "nombre_usuario=newuser&correo=new@example.com&contrasena=Test1234&confirmar_contrasena=Test1234"
# 2. Login
echo "2. Haciendo login..."
curl -c "$COOKIE_JAR" -X POST "$BASE/login.php" \
  -d "nombre_usuario=newuser&contrasena=Test1234"
# 3. Ver dashboard
echo "3. Viendo dashboard..."
curl -b "$COOKIE_JAR" "$BASE/dashboard.php"
# 4. Cargar lección
echo "4. Cargando lección..."
curl -b "$COOKIE_JAR" "$BASE/leccion_detalle.php?slug=b1-past-simple-2025&materia=Inglés"
# 5. Responder quiz
echo "5. Respondiendo quiz..."
curl -b "$COOKIE_JAR" -X POST "$BASE/src/funciones.php" \
  -d "accion=calificar_quiz&slug=b1-past-simple-2025&q0=The+students&q1=Yesterday&q2=Yes"
# 6. Obtener estado
echo "6. Obteniendo estado..."
curl -b "$COOKIE_JAR" -X POST "$BASE/src/funciones.php" \
  -d "accion=obtener_estado" | jq .
# 7. Logout
echo "7. Saliendo..."
curl -b "$COOKIE_JAR" "$BASE/logout.php"

bash api_test.sh

{
  "ok": true,
  "puntos": 40,
  "nivel": 1,
  "progreso": 0,
  "badges": [
    {
      "nombre": "Nivel 1: Novato",
      "tipo": "bronze"
    }
  ],
  "ranking": [
    {
      "id": 26,
      "nombre_usuario": "Maria",
      "puntos": 40,
      "es_actual": true
    },
    {
      "id": 25,
      "nombre_usuario": "cervanlfc7",
      "puntos": 30,
      "es_actual": false
    }
  ]
}

{
  "ok": false,
  "error": "No autenticado"
}

{
  "ok": true,
  "puntos": 0,
  "nivel": 1,
  "progreso": 0,
  "badges": [],
  "ranking": []
}

# Con sesión autenticada
curl -b cookies.txt http://localhost:8000/api/ranking.php
# Respuesta:
# {"ok":true,"puntos":40,"nivel":1,"progreso":0,"badges":[],"ranking":[...]}

fetch('api/ranking.php', {
    method: 'GET',
    headers: { 'Content-Type': 'application/json' }
})
.then(res => res.json())
.then(data => {
    if (data.ok) {
        // Actualizar UI con data.puntos, data.ranking, etc.
        console.log('Top jugador:', data.ranking[0].nombre_usuario);
    }
});