Idempotência da API

Toda requisição que não seja GET precisa de um cabeçalho Idempotency-Key. Use uma chave estável por escrita lógica para que as novas tentativas de rede sejam seguras.

Última atualização - 5 de junho de 2026 Tempo de leitura - 4 min Autor - Tom Rushmore

Obrigatório em escritas

Envie Idempotency-Key em cada requisição POST, PUT, PATCH e DELETE. Chaves ausentes retornam 400 idempotency_key_required.

Idempotency-Key: order-5501234567890-assignment-1

Comportamento de replay

Mesma chave, mesmo endpoint, mesmo corpo: a API repete a resposta bem-sucedida e não escreve novamente.
Mesma chave com um corpo diferente: a API retorna 409 idempotency_conflict.
Mesma chave enquanto a primeira requisição ainda está em execução: a API retorna 409 idempotency_conflict_in_progress.
As chaves expiram após 24 horas. Gere uma nova chave para cada nova operação lógica.

Documentação da API

Comece por aqui

Guia rápido da API

Faça um ping na API, importe um ativo, mapeie-o para um produto e atribua acesso a um pedido.

Referência

Referência de endpoints

Confira os endpoints disponíveis para ativos, mapeamentos, pedidos, mudanças de acesso e status.

Isto foi útil?

Ainda com dúvidas? Envie um e-mail para admin@alvaapps.com.

Última atualização 2026-06-05