🚀 APIDoc 4.0 - Guía Rápida de Autenticación

⚡ Configuración en 3 Pasos

1️⃣ Configurar apidoc.json

Agrega la sección login a tu apidoc.json:

{
  "name": "Mi API",
  "version": "1.0.0",
  "login": {
    "active": true,
    "admited": [
      {
        "email": "admin@miempresa.com",
        "password": "mi_password_seguro"
      }
    ]
  }
}
Copy

2️⃣ Generar Documentación

# Instalar APIDoc 4.0
npm install -g @hrefcl/apidoc

# Generar con autenticación
apidoc -i src/ -o docs/
Copy

3️⃣ Servir y Probar

# Servir documentación
npx serve docs/ -p 8080

# Abrir en navegador
open http://localhost:8080
Copy

¡Listo! Tu documentación ahora requiere login para acceder.

---

🔐 Opciones de Autenticación

🏠 Solo Local

{
  "login": {
    "active": true,
    "admited": [
      {"email": "user1@example.com", "password": "pass123"},
      {"email": "user2@example.com", "password": "pass456"}
    ]
  }
}
Copy

🌐 Solo Remota

{
  "login": {
    "active": true,
    "urlAuth": "https://api.miempresa.com/auth/login",
    "value_form": {
      "email": "email",
      "password": "password"
    },
    "response_success": 200,
    "response_error": 401
  }
}
Copy

🔗 Híbrida (Local + Remota)

{
  "login": {
    "active": true,
    "admited": [
      {"email": "admin@local.com", "password": "local123"}
    ],
    "urlAuth": "https://api.miempresa.com/auth/login",
    "value_form": {
      "email": "email",
      "password": "password"
    },
    "response_success": 200,
    "response_error": 401
  }
}
Copy

---

🧪 Testing Rápido

Usa las credenciales de ejemplo:

• Email: odin@href.cl
• Password: 6789123450

Estas funcionan tanto para autenticación local como remota.

---

📚 Documentación Completa

Ver AUTHENTICATION.md para:

• Configuración avanzada
• Seguridad y mejores prácticas
• Solución de problemas
• API de desarrollo
• Ejemplos completos

---

🆘 Problemas Comunes

❌ "Login form doesn't appear"

Solución: Verificar en consola del navegador:

console.log('AuthManager:', !!window.AuthManager);
console.log('Config:', window.LOGIN_CONFIG);
Copy

❌ "Authentication failed"

Solución: Usar script de validación:

cd docs/
node test-credentials.js
Copy

❌ "Templates not found"

Solución: Regenerar documentación:

apidoc -i src/ -o docs/ --debug
Copy

---

🎯 Próximos Pasos

1. ✅ Configurar autenticación básica
2. 🔧 Personalizar usuarios y passwords
3. 🌐 Integrar con tu sistema de auth existente
4. 🚀 Desplegar en producción con HTTPS
5. 📊 Monitorear accesos y uso

¡Tu API Documentation está protegida y lista! 🎉