​

Errori e comportamento di retry

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}

​

Indicazioni per i retry

• Riprovare in caso di errori di trasporto.
• Riprovare le scritture idempotenti con la stessa Idempotency-Key.
• Dopo lavoro asincrono, rileggere lo stato persistente invece di assumere che la prima risposta sia completa.

​

Regole pratiche

• Considerare i guasti lato server come candidati al retry solo quando la scrittura originale ha usato una chiave di idempotenza stabile.
• Considerare gli URL di download delle esportazioni appena generati come temporanei e rileggerli da GET /exports/{exportId} quando serve.
• Se una mutazione è già in corso o va in conflitto con lo stato corrente, ispezionare il code restituito ed eseguire il retry solo quando l’operazione è ancora logicamente sicura.

​

Client leggibili dalle macchine

• code
• message
• status
• retryable