# 📘 GUÍA VISUAL Y MANUAL PRÁCTICO DE APIS - POSCLOUD V12

> **¿Para qué es este manual?**  
> Para que cualquier persona (desarrollador, creador de tiendas, o agente de IA/WhatsApp) pueda entender **exactamente qué hace cada API, cómo llamarla, qué parámetros acepta, cuáles son obligatorios, cuáles son opcionales y qué respuesta entrega**.

---

## 🧭 MAPA RÁPIDO DE APIS

| # | Endpoint | Método | ¿Para qué sirve? |
| :-: | :--- | :-: | :--- |
| **1** | `/api/tienda/productos` | `GET` / `POST` | **Tiendas Online**: Obtener catálogo, precios 1, 2 y 3, fracciones y stock en tiempo real. |
| **2** | `/api/whatsapp/productos` | `GET` | **Bot WhatsApp**: Catálogo ultra-ligero y público para clientes por chat. |
| **3** | `/api/whatsapp/cliente` | `GET` | **Bot WhatsApp**: Identificar cliente por número de celular / WhatsApp o cédula. |
| **4** | `/api/whatsapp/cliente` | `POST` | **Bot WhatsApp**: Guardar o actualizar dirección y datos de entrega del cliente. |
| **5** | `/api/whatsapp/pedido` | `POST` | **Bot WhatsApp**: **(Venta)** Crear el pedido y guardarlo directamente en **Cotizaciones** del POS. |
| **6** | `/api/whatsapp/pedido/{numero}`| `GET` | **Bot WhatsApp**: Consultar estado y detalle de un pedido por su número de cotización. |
| **7** | `/api/ia/inventario` | `GET` | **IA / POS**: Consultar existencias de productos con múltiples filtros. |
| **8** | `/api/ia/inventario-cambios` | `GET` | **IA / Sincronización**: Consultar solo lo que se vendió o ingresó hoy (ultra rápido). |
| **9** | `/api/ia/ventas` | `GET` | **IA / Reportes**: Consultar dinero vendido, costos, utilidad y ventas por bodega/marca. |
| **10**| `/api/ia/rotacion` | `GET` | **IA / Demanda**: Consultar qué productos rotan más en cajas y fracciones físicas. |
| **11**| `/api/ia/sugerido-traslados`| `GET` | **IA / Traslados**: Sugerir transferencias inteligentes entre bodegas con sobrestock y faltantes. |
| **12**| `/api/ia/traslados` | `POST` | **IA / Traslados**: Mover productos de una bodega a otra. |
| **13**| `/api/ia/traslados/guardar` | `POST` | **IA / Traslados**: Guardar y cerrar el traslado definitivamente. |
| **14**| `/api/ia/traslados/lote` | `POST` | **IA / Traslados**: Crear y cerrar múltiples traslados en un solo envío. |
| **15**| `/api/ia/traslados/ejecutar-sugeridos` | `POST` | **IA / Traslados**: Calcular y ejecutar traslados sugeridos automáticamente con exclusión de marcas. |
| **16**| `/api/ia/clientes` | `GET` / `POST` | **IA / Clientes**: Buscar y registrar clientes en la base de datos central. |
| **17**| `/api/ia/ventas-clientes` | `GET` | **IA / Clientes**: Consultar qué productos compró cada cliente con cálculo neto de devoluciones. |
| **18**| `/api/contabilidad/movimientos` | `GET` | **Contabilidad**: Extraer débitos y créditos agrupados por cuenta PUC y tercero. |

---

## 🔑 ¿CÓMO SE ENVÍA LA AUTENTICACIÓN (TOKEN)?

Todas las APIs requieren un **Token de Seguridad**. Tienes dos formas de enviarlo:

1. **Forma Recomendada (Header HTTP):**
   ```http
   Authorization: Bearer TU_TOKEN_AQUI
   ```
2. **Forma Fácil en la URL (Query String):**
   ```text
   https://tu-dominio.com/api/whatsapp/productos?token=TU_TOKEN_AQUI
   ```

---

# 💬 SECCIÓN 1: APIS ESPECIALES PARA BOT / ASISTENTE DE WHATSAPP

Estas APIs están diseñadas especialmente para bots de WhatsApp (usando **n8n, Make, Botpress, Voiceflow, ChatGPT Custom GPTs o código propio**) para vender de forma 100% autónoma.

* **Controlador:** [`WhatsAppApiController.php`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/app/Http/Controllers/WhatsAppApiController.php)
* **Archivo de Tools / Skills:** [`skill_ai/whatsapp_functions.json`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/skill_ai/whatsapp_functions.json)

---

### 1.1 Consultar Productos y Precios para WhatsApp (`GET /api/whatsapp/productos`)
* **¿Qué hace?**  
  Devuelve una lista rápida y liviana con solo los datos que el cliente de WhatsApp necesita saber: nombre, precio por caja, precio por fracción/pastilla, si hay disponibilidad y promociones. Oculta costos internos y márgenes.

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token privado del bot de WhatsApp. |
| `nombre` | Texto | 🟢 **Opcional** | Ninguno | Palabra clave a buscar (Ej: `dolex`, `acetaminofen`, `pañales`). |
| `codigo` | Texto | 🟢 **Opcional** | Ninguno | Código de barras o SKU exacto. |
| `bodega` | Número | 🟢 **Opcional** | `1` | ID de la bodega que atiende los domicilios. |
| `limit` | Número | 🟢 **Opcional** | `15` | Cantidad máxima de productos a mostrar. |

#### 💡 Ejemplo de Llamada
```text
GET https://tu-dominio.com/api/whatsapp/productos?token=TU_TOKEN_WHATSAPP&nombre=acetaminofen&bodega=1
```

#### 📤 Respuesta JSON de Ejemplo
```json
{
  "estado": "ok",
  "bodega": 1,
  "productos": [
    {
      "codigo": "7702001",
      "nombre": "ACETAMINOFEN 500MG X 100 TAB",
      "marca": "GENFAR",
      "categoria": "ANALGESICOS",
      "precio_caja": 15000.00,
      "precio_fraccion": 200.00,
      "maneja_fracciones": true,
      "unidades_por_caja": 100,
      "disponible": true,
      "stock_cajas": 45,
      "promocion": "Lleva 3 cajas con 10% de descuento"
    }
  ]
}
```

---

### 1.2 Identificar Cliente por WhatsApp (`GET /api/whatsapp/cliente`)
* **¿Qué hace?**  
  El bot consulta si el número de celular del cliente ya está registrado para llamarlo por su nombre y recordar su dirección de entrega.

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token privado de WhatsApp. |
| `telefono` | Texto | 🟢 **Opcional** | Ninguno | Número de WhatsApp del cliente (Ej: `3101234567`). |
| `cedula` | Texto | 🟢 **Opcional** | Ninguno | Cédula o NIT del cliente. |

#### 💡 Ejemplo de Llamada
```text
GET https://tu-dominio.com/api/whatsapp/cliente?token=TU_TOKEN&telefono=3101234567
```

---

### 1.3 Registrar o Actualizar Cliente (`POST /api/whatsapp/cliente`)
* **¿Qué hace?**  
  Guarda la dirección de entrega, nombre y teléfono del cliente en la base de datos del POS.

#### 📋 Parámetros en el Body (JSON)
| Campo | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token privado de WhatsApp. |
| `telefono` | Texto | 🔴 **OBLIGATORIO** | — | Número de celular / WhatsApp del cliente. |
| `nombre` | Texto | 🔴 **OBLIGATORIO** | — | Nombre completo del cliente. |
| `direccion` | Texto | 🟢 **Opcional** | `""` | Dirección completa de entrega. |
| `barrio` | Texto | 🟢 **Opcional** | `""` | Barrio o sector. |
| `cedula` | Texto | 🟢 **Opcional** | El teléfono | Si no da cédula, el sistema usa su celular como ID. |

#### 💡 Ejemplo de Petición JSON
```json
{
  "token": "TU_TOKEN_WHATSAPP",
  "telefono": "3101234567",
  "nombre": "Mariana Gómez",
  "direccion": "Calle 45 # 12-34 Apto 301",
  "barrio": "La Floresta"
}
```

---

### 1.4 Crear Pedido de Venta en Cotización (`POST /api/whatsapp/pedido`)
* **¿Qué hace?**  
  **Es el cierre de venta del bot.** Cuando el cliente confirma el pedido, el bot llama a este endpoint. La venta se guarda en la tabla `cotizacion` con el número consecutivo `WA-...` y queda lista en el POS para que el personal de la tienda la prepare y despache.

#### 📋 Parámetros en el Body (JSON)
| Campo | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token privado de WhatsApp. |
| `cliente` | Texto | 🔴 **OBLIGATORIO** | — | Cédula o celular del cliente. |
| `direccion_entrega`| Texto | 🔴 **OBLIGATORIO** | — | Dirección exacta a donde llevar el pedido. |
| `metodo_pago` | Texto | 🟢 **Opcional** | Contraentrega | Forma de pago (`Efectivo`, `Nequi`, `Daviplata`, `Tarjeta`). |
| `nota` | Texto | 🟢 **Opcional** | `""` | Instrucciones (Ej: `Llevar cambio de $50.000`). |
| `bodega` | Número | 🟢 **Opcional** | `1` | ID de la bodega que despacha. |
| `productos` | Array | 🔴 **OBLIGATORIO** | — | Lista de productos a comprar. |
| `productos[].codigo` | Texto | 🔴 **OBLIGATORIO** | — | Código del producto. |
| `productos[].cantidad_cajas` | Número | 🟢 **Opcional** | `0` | Cantidad de cajas a pedir. |
| `productos[].cantidad_fracciones`| Número | 🟢 **Opcional** | `0` | Cantidad de pastillas/fracciones a pedir. |

#### 💡 Ejemplo de Petición JSON (Crear Pedido)
```json
{
  "token": "TU_TOKEN_WHATSAPP",
  "cliente": "3101234567",
  "direccion_entrega": "Calle 45 # 12-34 Apto 301",
  "metodo_pago": "Nequi",
  "nota": "Timbrar duro por favor",
  "bodega": 1,
  "productos": [
    {
      "codigo": "7702001",
      "cantidad_cajas": 2,
      "cantidad_fracciones": 0
    },
    {
      "codigo": "7702005",
      "cantidad_cajas": 0,
      "cantidad_fracciones": 10
    }
  ]
}
```

#### 📤 Respuesta JSON (Incluye mensaje formateado para WhatsApp)
```json
{
  "estado": "ok",
  "mensaje": "Pedido guardado en cotización exitosamente.",
  "numero_cotizacion": "WA-260827201500",
  "cliente": {
    "cedula": "3101234567",
    "nombre": "Mariana Gómez"
  },
  "total": 32000.00,
  "direccion_entrega": "Calle 45 # 12-34 Apto 301",
  "metodo_pago": "Nequi",
  "mensaje_whatsapp": "✅ *¡Pedido recibido con éxito!*\n\n📋 *No. Cotización:* WA-260827201500\n👤 *Cliente:* Mariana Gómez\n📍 *Dirección:* Calle 45 # 12-34 Apto 301\n💳 *Método de Pago:* Nequi\n\n📦 *Productos:*\n- ACETAMINOFEN 500MG X 100 TAB (Cajas: 2, Fracc: 0) = $ 30.000 COP\n- DOLEX FORTE TAB (Cajas: 0, Fracc: 10) = $ 2.000 COP\n\n💰 *TOTAL A PAGAR:* $ 32.000 COP\n\nUn asesor preparará tu despacho a la brevedad."
}
```

---

### 1.5 Consultar Estado de Pedido (`GET /api/whatsapp/pedido/{numeroCotizacion}`)
* **¿Qué hace?**  
  Permite al bot consultar el detalle y total de un pedido cuando el cliente pregunta *"¿Cómo va mi pedido WA-260827201500?"*.

#### 💡 Ejemplo de Llamada
```text
GET https://tu-dominio.com/api/whatsapp/pedido/WA-260827201500?token=TU_TOKEN_WHATSAPP
```

---

# 🛒 SECCIÓN 2: APIS PARA TIENDAS ONLINE Y E-COMMERCE

---

### 2.1 Obtener Catálogo para Tiendas (`GET /api/tienda/productos`)
* **URL:** `GET /api/tienda/productos` o `POST /api/tienda/productos`
* **Controlador:** [`TiendaApiController.php`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/app/Http/Controllers/TiendaApiController.php)
* **¿Qué hace?**  
  Devuelve el catálogo de productos disponibles en la **Bodega 1**, con su código de barras, nombre, marca, factor de conversión, IVA, promociones, precios de venta (`VentaCaja`, `VentaCaja3`, `VentaFrcc`) y stock disponible (`inventario`).

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token asignado a la tienda (identifica la base de datos). |

#### 💡 Ejemplo de Llamada
```text
GET https://tu-dominio.com/api/tienda/productos?token=TU_TOKEN_TIENDA
```

---

# 🤖 SECCIÓN 3: APIS PARA INTELIGENCIA ARTIFICIAL (IA ADMINISTRATIVA)

> 📖 **Documentación Técnica Exhaustiva y Guía para Desarrolladores:**  
> Consulta el archivo [`DOCUMENTACION_API_IA.md`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/DOCUMENTACION_API_IA.md) para ver la especificación completa de todos los parámetros, cuerpos JSON, códigos de estado, ejemplos en cURL/JS/Python/PHP y arquitectura multi-tenant de [`ApiControllerIa.php`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/app/Http/Controllers/ApiControllerIa.php).

---

### 3.1 Consultar Inventario (`GET /api/ia/inventario`)
* **URL:** `GET /api/ia/inventario`
* **Controlador:** [`ApiControllerIa.php`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/app/Http/Controllers/ApiControllerIa.php)
* **¿Qué hace?**  
  Busca productos en el inventario con filtros por bodega, nombre, marca, categoría o código exacto.

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | ¿Para qué sirve? |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token de acceso a la base de datos. |
| `bodega` | Número | 🟢 **Opcional** | Todas | ID de una bodega específica (Ej: `1`). |
| `bodegas` | Texto / Array | 🟢 **Opcional** | Todas | Varios IDs de bodegas separados por comas (Ej: `1,2,3`). |
| `nombre` | Texto | 🟢 **Opcional** | Ninguno | Palabra a buscar en Nombre, Marca o Categoría. |
| `codigo` | Texto | 🟢 **Opcional** | Ninguno | Código SKU o de barras exacto. |
| `modificado_hoy`| Número (0 o 1)| 🟢 **Opcional** | `0` | Si envías `1`, solo trae productos movidos hoy. |
| `desde_fecha` | Fecha y Hora | 🟢 **Opcional** | Ninguno | `YYYY-MM-DD HH:MM:SS`. |
| `limit` | Número | 🟢 **Opcional** | Sin límite | Cantidad máxima de registros. |

---

### 3.2 Consultar Ventas y Estadísticas Financieras (`GET /api/ia/ventas`)
* **URL:** `GET /api/ia/ventas`
* **¿Qué hace?**  
  Devuelve los **KPIs de dinero** (Total ventas en dinero COP, Costos, Utilidad neta, IVA, Facturas) y ventas por Bodega, Categoría y Marca.

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | ¿Para qué sirve? |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token de acceso. |
| `fi` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | **Hace 30 días** | Fecha Inicial (Ej: `2026-08-01`). |
| `ff` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | **Hoy** | Fecha Final (Ej: `2026-08-27`). |
| `bodega` | Número | 🟢 **Opcional** | Todas | Filtrar por bodega específica. |
| `marca` | Texto | 🟢 **Opcional** | Todas | Filtrar por nombre de marca. |
| `categoria` | Texto | 🟢 **Opcional** | Todas | Filtrar por nombre de categoría. |

---

### 3.3 Consultar Rotación de Unidades (`GET /api/ia/rotacion`)
* **URL:** `GET /api/ia/rotacion`
* **¿Qué hace?**  
  Muestra las **unidades físicas reales vendidas** (cajas enteras y fracciones netas), frecuencia de ventas y stock actual por bodega.

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | ¿Para qué sirve? |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token de acceso. |
| `fecha_inicio` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | Hace 30 días | Inicio de análisis. |
| `fecha_fin` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | Hoy | Fin de análisis. |
| `bodega` | Número | 🟢 **Opcional** | Todas | ID de bodega a consultar. |
| `limit` | Número | 🟢 **Opcional** | `60` | Productos por página. |
| `page` | Número | 🟢 **Opcional** | `1` | Página a consultar. |

---

### 3.4 Sugerencias de Traslado (`GET /api/ia/sugerido-traslados`)
* **URL:** `GET /api/ia/sugerido-traslados`
* **¿Qué hace?**  
  Calcula transferencias automáticas entre bodegas donantes (sobrestock) y receptoras (faltantes).

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | ¿Para qué sirve? |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token de acceso. |
| `bodega_origen` | Número | 🟢 **Opcional** | Todas | Bodega donante de salida. |
| `bodega_destino`| Número | 🟢 **Opcional** | Todas | Bodega receptora de entrada. |
| `dias_provision`| Número | 🟢 **Opcional** | `7` | Días de stock a garantizar en destino. |
| `conservar_minimo`| Booleano | 🟢 **Opcional** | `false` | No dejar en 0 cajas la bodega origen. |

---

### 3.5 Creación y Ejecución de Traslados

1. **Crear Traslado (`POST /api/ia/traslados`)**:
   * Body: `{ "bodega_salida": 1, "bodega_entrada": 2, "productos": [{"codigo": "7702001", "caja": 5, "frcc": 0}] }`
2. **Cerrar Traslado (`POST /api/ia/traslados/guardar`)**:
   * Body: `{ "bodega_salida": 1 }`
3. **Múltiples Traslados en Lote (`POST /api/ia/traslados/lote`)**:
   * Body: `{ "traslados": [...] }`
4. **Ejecutar Sugeridos Automáticamente (`POST /api/ia/traslados/ejecutar-sugeridos`)**:
   * Body: `{ "bodega_origen": 1, "dias_provision": 7, "omitir_productos": ["helados", "Mk"] }`

---

### 3.6 Consultar Ventas Detalladas por Cliente (`GET /api/ia/ventas-clientes`)
* **URL:** `GET /api/ia/ventas-clientes`
* **Controlador:** [`ApiControllerIa.php`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/app/Http/Controllers/ApiControllerIa.php)
* **¿Qué hace?**  
  Devuelve el detalle de los productos vendidos a cada cliente en un rango de fechas, calculando automáticamente las ventas netas (restando devoluciones parciales y totales), con datos del producto (código, nombre, factor, cajas, fracciones, valores y bodega) y datos básicos del cliente (sin incluir información de crédito).

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token de acceso a la base de datos de la empresa. |
| `fi` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | Hace 30 días | Fecha Inicial del periodo a consultar. |
| `ff` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | Hoy | Fecha Final del periodo a consultar. |
| `cliente` / `cedula`| Texto | 🟢 **Opcional** | Todos | Cédula, NIT o teléfono para filtrar un cliente específico. |
| `nombre` | Texto | 🟢 **Opcional** | Todos | Búsqueda parcial por nombre, apellido o alias del cliente. |
| `producto` | Texto | 🟢 **Opcional** | Todos | Búsqueda por código o nombre del producto. |
| `bodega` | Número / Texto | 🟢 **Opcional** | Todas | ID o lista de bodegas separadas por comas (`1` o `1,2`). |
| `limit` | Número | 🟢 **Opcional** | `50` | Cantidad de clientes por página. |
| `page` | Número | 🟢 **Opcional** | `1` | Número de página. |

#### 💡 Ejemplo de Llamada
```text
GET https://tu-dominio.com/api/ia/ventas-clientes?token=TU_TOKEN&fi=2026-08-01&ff=2026-08-31&cliente=1085245890
```

---

# 📊 SECCIÓN 4: API DE CONTABILIDAD EXTERNA

---

### 4.1 Consultar Movimientos Contables (`GET /api/contabilidad/movimientos`)
* **URL:** `GET /api/contabilidad/movimientos`
* **Controlador:** [`ContabilidadApiController.php`](file:///c:/xampp/htdocs/Admin_PosCloud_V12/app/Http/Controllers/ContabilidadApiController.php)
* **¿Qué hace?**  
  Extrae débitos y créditos agrupados por cuenta PUC (`codeC`), tercero y bodega para sincronizar con software contable.

#### 📋 Tabla de Parámetros
| Parámetro | Tipo | ¿Es Obligatorio? | Por Defecto | Descripción |
| :--- | :---: | :---: | :---: | :--- |
| `token` | Texto | 🔴 **OBLIGATORIO** | — | Token en Header `Authorization: Bearer <TOKEN>`. |
| `fi` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | Hoy | Fecha Inicial. |
| `ff` | Fecha (`YYYY-MM-DD`)| 🟢 **Opcional** | Hoy | Fecha Final. |
| `bodega` | Número | 🟢 **Opcional** | `1` | ID de bodega (`0` para todas). |

---

# 🛠️ HISTORIAL DE CAMBIOS Y VERSIONES (CHANGELOG)

| Fecha | Módulo | Autor | Detalle del Cambio |
| :--- | :--- | :--- | :--- |
| **2026-08-31** | API IA Ventas Clientes | Antigravity AI | Creación del endpoint `GET /api/ia/ventas-clientes` para consultar detalle de productos vendidos por cliente con descuento de devoluciones y exclusión de datos crediticios. |
| **2026-08-27** | WhatsApp Bot API | Antigravity AI | Creación del controlador `WhatsAppApiController.php`, rutas `/api/whatsapp/*`, guardado de pedidos en `cotizacion` y esquema de tools `skill_ai/whatsapp_functions.json`. |
| **2026-08-27** | Manual de APIs | Antigravity AI | Reestructuración total a formato visual con tablas de parámetros obligatorios/opcionales y ejemplos listos para usar. |