Search docs

Search the TryOnCloud API docs

Guias

Registo de alterações da API

Todas as alterações à API do Desenvolvedor, com as mais recentes em primeiro lugar.

Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.

Alterações à API para programadores, com as mais recentes em primeiro lugar. Os formatos de pedidos e respostas existentes não sofrem alterações sem aviso prévio nesta secção; são adicionados novos campos e pontos de extremidade a par destes.

19 de novembro de 2026

  • Novidade: Testes assíncronos: POST /api/v1/generations devolve uma tarefa de uma só vez; consulte-a em GET /api/v1/generations/:id. Documentação
  • Novidade: Lotes de até 500 experimentações a partir de URLs de imagens: POST /api/v1/batches, GET e DELETE /api/v1/batches/:id (os artigos cancelados são reembolsados). Documentação
  • Novidade: Webhooks assinados generation.completed, generation.failed e batch.completed, por pedido (webhook_url) ou como um ponto final da conta com seleção de eventos e um evento de teste em Chaves API > Webhooks. Documentação
  • Novidade: GET /api/v1/results/:id permite descarregar um resultado guardado com a sua chave. Os resultados assíncronos são mantidos durante 7 dias.
  • Novo: DELETE /api/v1/customers/:customer_id apaga os resultados e registos armazenados de um utilizador final. O customer_id é aceite nas chamadas /generate, /generations e em itens em lote. Documentação
  • Novidade: Limite de crédito mensal por chave e data de validade, definidos aquando da criação da chave. Excedimento do limite: 402 KEY_LIMIT_REACHED. Documentação
  • Novidade: Modo de teste (?mock=true) para tarefas assíncronas e lotes (até 10 itens), gratuito.
  • Mais rápido: a análise da peça de roupa fica armazenada em cache durante 30 dias, pelo que as novas experiências com a mesma fotografia do produto poupam cerca de 2 segundos.
  • Painel: Pesquisa por gerações através do ID do cliente ou do ID do pedido, filtro de período, visualização em tempo real e exportação para CSV. A visão geral apresenta o tempo mediano e o tempo p95, bem como a autonomia de crédito.
  • Segurança: Os webhooks são enviados apenas para endereços públicos verificados no momento da ligação, nunca seguindo redirecionamentos.

18 de novembro de 2026

  • Novidade: cabeçalho Idempotency-Key na chamada POST /api/v1/generate; as tentativas de repetição nunca são cobradas duas vezes. Documentação
  • Novidade: X-Request-Id em todas as respostas (e request_id nos corpos das respostas de erro), além de X-RateLimit-Limit e X-RateLimit-Remaining.
  • Novidade: Especificação OpenAPI 3.1 em https://www.tryoncloud.com/api/v1/openapi.json.
  • Novidade: Dados sobre os serviços públicos em GET /api/v1/status e na página de estado.
  • Documentação: Resolução de saída indicada: cerca de 1 megapixel (da classe 1K).

14 de novembro de 2026

  • Novidade: o cabeçalho de webhook x-tryoncloud-signature-v2, que assina o carimbo temporal juntamente com o corpo da mensagem, para que as entregas antigas possam ser rejeitadas. O x-tryoncloud-signature permanece inalterado. Documentação
  • Alteração: Os limites de taxa são agora aplicados em todos os servidores, com um limite global por conta de 600 pedidos de geração por minuto e um limite separado para o modo de teste. Documentação
  • Novo: GET /api/v1/credits para verificar as tentativas restantes com a sua chave API. Documentação
  • Novidade: servidor MCP em https://www.tryoncloud.com/api/mcp para o Claude Code, o Cursor e o VS Code. Documentação
  • Novidade: JavaScript/TypeScript SDK. Documentação
  • Novidade: Modo de teste gratuito, ?mock=true ou X-Mock: true. Documentação
  • Novidade: DELETE /api/v1/results/:id para eliminar antecipadamente um resultado armazenado. Documentação
  • Alteração: O preço para empresas (5 000 ou mais experimentações) foi reduzido de 0,08 $ para 0,07 $. Na Índia, mantém-se em 6,50 ₹.
  • Alteração: os downloads de garment_url são agora verificados em cada redirecionamento e no momento da ligação; os endereços internos, privados e de metadados na nuvem são recusados.
  • Documentação: Novos documentos com várias páginas, incluindo versões em Markdown de cada página, um Acordo de Tratamento de Dados e uma autorização de revenda nos Termos.

12 de novembro de 2026

  • Alterado: Novos preços para cada quantidade: 50 ou mais = 0,11 $, 300 ou mais = 0,10 $, 1 000 ou mais = 0,09 $, 5 000 ou mais = 0,08 $.
  • Novidade: Chaves API com nome, até 5 ativas, datas da última utilização, revogação uma de cada vez.

5 de novembro de 2026

  • Alteração: POST /generate devolve sempre image/png, em conformidade com o Content-Type documentado.