# Registro de cambios de la API

Cambios en la API para desarrolladores, ordenados de más reciente a más antiguo. Los formatos de solicitud y respuesta existentes no se modifican sin previo aviso en esta sección; se añaden nuevos campos y puntos finales junto a ellos.

## 19 de noviembre de 2026

- **Novedad:** Pruebas asíncronas: `POST /api/v1/generations` devuelve una tarea de inmediato; se puede consultar en `GET /api/v1/generations/:id`. [Documentación](/docs/async)
- **Novedad:** lotes de hasta 500 pruebas a partir de URL de imágenes: `POST /api/v1/batches`, `GET` y `DELETE /api/v1/batches/:id` (los artículos cancelados se reembolsan). [Documentación](/docs/async#batches)
- **Novedad:** webhooks firmados `generation.completed`, `generation.failed` y `batch.completed`, por solicitud (`webhook_url`) o como punto final de la cuenta con selección de eventos y un evento de prueba en **Claves API > Webhooks**. [Documentación](/docs/async#webhooks)
- **Novedad:** `GET /api/v1/results/:id` permite descargar un resultado guardado con tu clave. Los resultados asíncronos se conservan durante 7 días.
- **Novedad:** `DELETE /api/v1/customers/:customer_id` borra los resultados y registros almacenados de un usuario final. Se acepta `customer_id` en `/generate`, `/generations` y elementos por lotes. [Documentación](/docs/async#delete-a-customers-data)
- **Novedad:** límite de crédito mensual por clave y fecha de caducidad, que se establecen al crear una clave. Si se supera el límite: `402 KEY_LIMIT_REACHED`. [Documentación](/docs/limits)
- **Novedad:** Modo de prueba (`?mock=true`) para tareas asíncronas y lotes (hasta 10 elementos), gratuito.
- **Más rápido:** el análisis de la prenda se almacena en caché durante 30 días, por lo que las pruebas repetidas de la misma foto del producto se aceleran unos 2 segundos.
- **Panel de control:** Búsqueda de generaciones por ID de cliente o ID de solicitud, filtro de periodo, vista en tiempo real y exportación a CSV. La vista general muestra la mediana y el percentil 95 del tiempo, así como la autonomía financiera.
- **Seguridad:** Los webhooks solo se envían a direcciones públicas que se comprueban en el momento de la conexión, sin seguir nunca las redirecciones.

## 18 de noviembre de 2026

- **Novedad:** encabezado `Idempotency-Key` en `POST /api/v1/generate`; los reintentos nunca se cobran dos veces. [Documentación](/docs/generate#retries-and-idempotency)
- **Novedad:** `X-Request-Id` en cada respuesta (y `request_id` en los cuerpos de los mensajes de error), además de `X-RateLimit-Limit` y `X-RateLimit-Remaining`.
- **Novedad:** especificación OpenAPI 3.1 en `https://www.tryoncloud.com/api/v1/openapi.json`.
- **Novedad:** Datos sobre el servicio público en `GET /api/v1/status` y en la [página de estado](/status).
- **Documentación:** Resolución de salida indicada: aproximadamente 1 megapíxel (clase 1K).

## 14 de noviembre de 2026

- **Novedad:** el encabezado de webhook `x-tryoncloud-signature-v2`, que firma la marca de tiempo junto con el cuerpo del mensaje para que se puedan rechazar las entregas antiguas. `x-tryoncloud-signature` no ha sufrido cambios. [Documentación](/docs/webhook)
- **Modificado:** Ahora se aplican límites de frecuencia en todos los servidores, con un límite para toda la cuenta de 600 solicitudes de generación por minuto y un límite independiente para el modo de prueba. [Documentación](/docs/limits)
- **Novedad:** `GET /api/v1/credits`, para comprobar las pruebas restantes con tu clave API. [Documentación](/docs/credits)
- **Novedad:** servidor MCP en `https://www.tryoncloud.com/api/mcp` para Claude Code, Cursor y VS Code. [Documentación](/docs/mcp)
- **Novedad:** JavaScript/TypeScript SDK. [Documentación](/docs/sdk)
- **Novedad:** Modo de prueba gratuito, `?mock=true` o `X-Mock: true`. [Documentación](/docs/generate)
- **Novedad:** `DELETE /api/v1/results/:id`, para borrar antes de tiempo un resultado almacenado. [Documentación](/docs/delete-result)
- **Modificación:** El precio para empresas (más de 5.000 pruebas) se ha reducido de 0,08 $ a 0,07 $. En la India se mantiene en 6,50 ₹.
- **Modificado:** ahora se comprueban las descargas de `garment_url` en cada redirección y en el momento de establecer la conexión; se rechazan las direcciones internas, privadas y de metadatos en la nube.
- **Documentación:** Nuevos documentos de varias páginas con versiones en Markdown de cada página, un [acuerdo de tratamiento de datos](/dpa) y una autorización de reventa incluida en las [condiciones de uso](/terms#developer-api).

## 12 de noviembre de 2026

- **Modificado:** Nuevos precios para cada tramo: a partir de 50, 0,11 $; a partir de 300, 0,10 $; a partir de 1.000, 0,09 $; a partir de 5.000, 0,08 $.
- **Novedad:** claves API con nombre, hasta 5 activas, fechas de último uso, revocación una por una.

## 5 de noviembre de 2026

- **Modificado:** `POST /generate` siempre devuelve `image/png`, tal y como indica su `Content-Type` documentado.
