# 🚀 Guía Rápida - API Ultranav

## Acceso Rápido

**URL:** `https://ultranav.smartime.cl`  
**Token:** `c06ab5c4a51ba98ac02151518cd2ecc06c38e3d24e3d10346bacf9b6210a78c7`

---

## ✅ Verificar que la API está activa

```bash
curl https://ultranav.smartime.cl/health
```

**Respuesta esperada:**
```json
{"status":"ok"}
```

---

## 📥 Obtener datos de asistencia

### Comando cURL (copiar y pegar)

```bash
curl -X POST https://ultranav.smartime.cl/api/v1/asistencia/resumen \
  -H "Authorization: Bearer c06ab5c4a51ba98ac02151518cd2ecc06c38e3d24e3d10346bacf9b6210a78c7" \
    -H "Content-Type: application/json" \
      -d '{"fecha": "02-02-2026 - 02-02-2026", "idNodo": null}'
```

### En Postman Web

1. Ir a https://web.postman.co/
2. Nueva request POST
3. URL: `https://ultranav.smartime.cl/api/v1/asistencia/resumen`
4. Headers:
   - `Authorization: Bearer c06ab5c4a51ba98ac02151518cd2ecc06c38e3d24e3d10346bacf9b6210a78c7`
   - `Content-Type: application/json`
5. Body (raw JSON):
   ```json
   {"fecha": "02-02-2026 - 02-02-2026", "idNodo": null}
   ```
6. Send

---

## 📋 Parámetros

| Parámetro | Formato | Ejemplo | Requerido |
|-----------|---------|---------|-----------|
| `fecha` | dd-mm-yyyy - dd-mm-yyyy | 01-01-2026 - 31-01-2026 | ✅ Sí |
| `idNodo` | número o null | 26338 o null | ❌ No |

**Nota:** Máximo 30 días por consulta

---

## 🔍 Respuesta

```json
{
  "data": [
    {
      "nombre": "JUAN PÉREZ",
      "rut": "12345678-9",
      "division": "Humboldt - Viña del Mar",
      "fecha": "06/01/2026",
      "marca_entrada": "08:30:00",
      "marca_salida": "17:00:00",
      "salida_almorzar": "12:30:00",
      "llegada_almorzar": "13:30:00",
      "tiempo_antes_almuerzo": "04:00:00",
      "almuerzo": "01:00:00",
      "tiempo_despues_almuerzo": "03:30:00"
    }
  ],
  "count": 1,
  "filters": {
    "fecha_inicio": "01-01-2026",
    "fecha_fin": "31-01-2026",
    "id_nodo": 26338
  }
}
```

---

## ⚠️ Errores Comunes

| Error | Causa | Solución |
|-------|-------|----------|
| 401 Invalid authorization token | Token incorrecto | Copiar token exactamente |
| 400 fecha format must be... | Formato de fecha mal | Usar: dd-mm-yyyy - dd-mm-yyyy |
| 400 Date range cannot exceed 30 days | Rango > 30 días | Reducir rango |
| 500 Error processing request | Problema BD | Contactar soporte |

---

## 📞 Contacto

Para problemas o preguntas, contactar al equipo de desarrollo.

**Estado:** ✅ Producción  
**Disponibilidad:** 24/7  
**Última actualización:** 22 de enero de 2026