Chave de idempotência (Idempotency-key)

Alguns endpoints da Sistematize utilizam a chave de idempotência para prevenir a ocorrência de requisições duplicadas.

Portanto, um parceiro poderia, acidentalmente, enviar mais de uma requisição para um destino sem a intenção daquilo. O uso da chave de idempotência previne esse tipo de erro.

A chave de idempotência deve ser enviada por meio do cabeçalho adicional Idempotency-key, da seguinte forma:

No momento o VALOR-DO-IDEMPOTENCY é aceito um UUID unico, para cada requisição, isso evita o processamento de duplo request.

Endpoints
Confira a seguir os endpoints que utilizam a chave de idempotência (Idempotency-key) em seu header:

Descrição	EndPoint
Criação de assinaturas	POST/https://sandbox.sistematize.me:8443/api/v1/assinatura
Pagamento de Assinaturas	POST/[<https://sandbox.sistematize.me:8443/api/v1/assinatura/{ID_ASSINATURA}/pagar](<https://sandbox.sistematize.me:8443/api/v1/assinatura/{ID_ASSINATURA}/pagar)
Criação de transações online	POST/https://sandbox.sistematize.me:8443/api/v1/transacao

Erros
Na utilização da chave de idempotência, poderão ocorrer os seguintes erros:

Código	Descrição
412	O código 412 indica que o servidor recusou a requisição feita pelo cliente porque uma ou mais condições exigidas nos cabeçalhos da requisição não foram atendidas