CONFIABILIDADE
Idempotência
Como repetir chamadas sem imprimir duas vezes.
Contrato
POST /print-sta-api-print-jobs e retry exigem Idempotency-Key de 8–128 caracteres em [A-Za-z0-9._:-].
| Situação | Resultado |
|---|---|
| Mesma chave + mesmo payload | Replay seguro; job original. |
| Mesma chave + payload diferente | HTTP 409 PRINT_STA_JOB_IDEMPOTENCY_CONFLICT. |
| Chave nova | Novo trabalho. |
Retenção mínima: 24h e pelo menos até a expiração do job; o serviço pode guardar mais tempo. Gere a chave de uma identidade de negócio, por exemplo pedido:98421:cupom:1.
Consulte também o OpenAPI 3.1.0 v1, com schemas tipados e exemplos.
Referência completa