Search docs

Search the TryOnCloud API docs

Guías

Registro de cambios de la API

Todas las modificaciones de la API para desarrolladores, ordenadas de más reciente a más antigua.

Los ejemplos de código, los puntos finales y los códigos de error son los mismos en todos los idiomas.

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
  • 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
  • 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
  • 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
  • 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
  • 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
  • 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.
  • 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
  • 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
  • Novedad: GET /api/v1/credits, para comprobar las pruebas restantes con tu clave API. Documentación
  • Novedad: servidor MCP en https://www.tryoncloud.com/api/mcp para Claude Code, Cursor y VS Code. Documentación
  • Novedad: JavaScript/TypeScript SDK. Documentación
  • Novedad: Modo de prueba gratuito, ?mock=true o X-Mock: true. Documentación
  • Novedad: DELETE /api/v1/results/:id, para borrar antes de tiempo un resultado almacenado. Documentación
  • 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 y una autorización de reventa incluida en las condiciones de uso.

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.