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