# Registo de alterações da API

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](/docs/async)
- **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](/docs/async#batches)
- **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](/docs/async#webhooks)
- **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](/docs/async#delete-a-customers-data)
- **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](/docs/limits)
- **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](/docs/generate#retries-and-idempotency)
- **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](/status).
- **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](/docs/webhook)
- **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](/docs/limits)
- **Novo:** `GET /api/v1/credits` para verificar as tentativas restantes com a sua chave API. [Documentação](/docs/credits)
- **Novidade:** servidor MCP em `https://www.tryoncloud.com/api/mcp` para o Claude Code, o Cursor e o VS Code. [Documentação](/docs/mcp)
- **Novidade:** JavaScript/TypeScript SDK. [Documentação](/docs/sdk)
- **Novidade:** Modo de teste gratuito, `?mock=true` ou `X-Mock: true`. [Documentação](/docs/generate)
- **Novidade:** `DELETE /api/v1/results/:id` para eliminar antecipadamente um resultado armazenado. [Documentação](/docs/delete-result)
- **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](/dpa) e uma autorização de revenda nos [Termos](/terms#developer-api).

## 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.
