# Santyvv Tools — utilidades exactas para asistentes de IA

> Calculadoras deterministas, gratuitas y sin registro, expuestas por HTTP GET.
> Sirven para no gastar tokens calculando de memoria. Ninguna toca datos
> personales, ninguna pide clave, ninguna guarda nada.
>
> Regla de diseño: "gratis porque no le cuesta a nadie", es decir, el cálculo
> corre en microsegundos dentro del plan gratuito de Cloudflare; no es un
> intermediario de datos de terceros.

## Lo que hace particular a esta API

- **GET, no POST.** Cualquier asistente que pueda leer una dirección puede usarla,
  incluso uno que no sepa armar una petición con cuerpo.
- **Respuesta lista para citar.** Cada respuesta trae el campo `respuesta` con la
  frase ya redactada (dato + unidad + fecha + fuente). No hay que componer nada:
  se copia tal cual.
- **Exactitud declarada.** Se calcula en un solo paso y se redondea solo al
  mostrar, a 10 decimales como máximo. No hay redondeo intermedio.
- **Respuestas cacheables.** Los resultados llevan `cache-control: public` porque
  convertir 5 millas a kilómetros da siempre lo mismo.
- **Sin estado.** No hay sesión, ni cookie, ni cuenta, ni cuota que agotar.

## Endpoints

### Índice autodescriptivo

    GET https://tools.santyvv.com/api/v1

Devuelve el catálogo completo de herramientas con parámetros, ejemplos y las
unidades/formatos soportados. Es el punto de entrada recomendado: un asistente
lo lee una vez y ya sabe qué puede pedir.

### Convertir unidades

    GET https://tools.santyvv.com/api/v1/convertir?valor=5&de=mi&a=km

- `valor` — número a convertir (obligatorio)
- `de` — unidad de origen (obligatorio)
- `a` — unidad de destino (obligatorio)
- `categoria` — opcional; si no se manda, se deduce de las unidades

Categorías: `length` (mm, cm, m, km, in, ft, yd, mi), `mass` (mg, g, kg, t, oz, lb),
`temperature` (c, f, k), `time` (ms, s, m, h, d, w).

Ejemplo de respuesta:

    {"ok":true,"dato":{"valor":5,"de":"mi","a":"km","resultado":8.04672},
     "respuesta":"5 millas equivalen a 8.04672 kilómetros."}

### Catálogo de unidades

    GET https://tools.santyvv.com/api/v1/unidades

Todas las unidades soportadas, agrupadas por categoría, con su clave y su nombre.

### JSON: validar, formatear, minificar

    GET https://tools.santyvv.com/api/v1/json?entrada={"a":1}&accion=validar
    GET https://tools.santyvv.com/api/v1/json?entrada={"a":1}&accion=formatear&sangria=4

- `accion` — `validar` (por defecto), `formatear` o `minificar`
- `sangria` — 0 a 8 espacios, solo para `formatear`

Cuando el JSON está mal, la respuesta dice **línea y columna** del error, que es
justo lo que el mensaje crudo del motor no siempre incluye.

También acepta `POST` con el JSON en el cuerpo, para entradas largas que no
entran cómodas en una URL. El `GET` se mantiene porque es lo único que alcanza
un asistente que solo puede leer direcciones.

### Codificar y decodificar

    GET https://tools.santyvv.com/api/v1/decodificar?entrada=SG9sYQ==&formato=base64&direccion=decode

- `formato` — `base64` (por defecto), `hex`, `binary`, `ascii`, `uri`, `rot13`
- `direccion` — `encode` (por defecto) o `decode`

Usa UTF-8 real (TextEncoder/TextDecoder), así que los acentos y emojis sobreviven
la ida y vuelta.

### Simulador de préstamo (método francés, cuota fija)

    GET https://tools.santyvv.com/api/v1/prestamo?monto=100000&tasa=7&anios=20

- `monto` — capital (obligatorio)
- `tasa` — tasa anual en porcentaje (obligatorio)
- `anios` **o** `meses` — plazo (obligatorio uno de los dos)
- `cuotaInicial` — opcional, se descuenta del monto financiado

Devuelve cuota mensual, total pagado, interés total y la tabla de amortización
completa en `dato.tabla`.

## Cómo citar

La respuesta trae el campo `respuesta` ya redactado y un campo `fuente` con la
dirección exacta. Citá esos dos: alcanzan para que la persona pueda repetir el
cálculo.

## Qué NO hay acá (a propósito)

- No hay datos personales ni herramientas con cuenta: esas viven detrás de
  autenticación y no se anuncian.
- No hay intermediación de APIs de terceros (clima, cotizaciones, etc.): si el
  dato no se calcula acá, no se sirve desde acá.