Changelog da API

Atualização da v1 - julho de 2026

Adições aditivas de códigos de erro e campos de resposta ao contrato v1 existente.

• Novo erro 422 withdrawal_consent_required no endpoint de download-urls de pedidos: retornado quando a loja tem o consentimento do direito de arrependimento da UE ativado e o pedido ainda não tem um registro de consentimento; as URLs de download são emitidas assim que o cliente consente.
• Novo erro 422 key_limit_reached ao criar chaves de API: uma loja pode ter no máximo 25 chaves de API ativas; revogue uma primeiro.
• Novo erro 409 delivery_not_yet_released nos endpoints download-urls e resend de pedidos: retornado quando o produto tem um atraso na entrega do download configurado e os arquivos do comprador ainda não foram liberados. Nenhuma URL de download é emitida e nenhum e-mail é enviado até o atraso terminar.
• Novo objeto error.details no envelope de erro: presente apenas nos códigos que carregam contexto seguro para quem chama. Hoje delivery_not_yet_released é o único produtor, e ele carrega release_at, o instante ISO 8601 em que os downloads são liberados. Trate o objeto como aberto: novas chaves podem aparecer sem uma mudança de versão maior.
• Novos campos delivery_pending e release_at no objeto de compra do status do pedido: delivery_pending é true enquanto uma compra ainda está retida por um atraso na entrega do download, e release_at é o instante ISO 8601 da liberação, ou null quando não há nada pendente.
• O endpoint grant-downloads agora libera imediatamente as compras retidas do pedido, permitindo que o lojista substitua um atraso na entrega do download pela API.

v1.0.0 - junho de 2026

Superfície inicial da API em piloto, com acesso somente mediante aprovação.

• Chaves de API para lojas aprovadas.
• Chaves de idempotência obrigatórias em requisições de escrita.
• Importação de ativos por URL remota, uploads diretos, listagem de ativos, atualizações de ativos e exclusão de ativos.
• Categorias planas, mapeamentos de produtos, pacotes e tags de chaves de licença.
• Atribuições de pedidos que tornam os downloads mapeados visíveis nas contas de cliente do Shopify.
• Controles de acesso ao pedido: revogar, restaurar, conceder downloads e reenviar e-mail.
• Endpoints de status de jobs e pedidos.
• Downloads da especificação OpenAPI e da coleção Postman.

Política de versionamento

O contrato da v1 é apenas aditivo: novos endpoints, campos opcionais e novos códigos de erro podem ser adicionados. Mudanças incompatíveis usarão um futuro caminho /api/v2.