Errors and retries

Every failure is an OvokException with status, code, type, message, traceId, requestId, retryAfterMs and fieldErrors. Catch a subclass to handle one case:

try {
  await ovok.fhir.read('Patient', id);
} on OvokNotFoundException {
  // show "not found"
} on OvokException catch (error) {
  log('Ovok failed', error: error.traceId);
}

Quote traceId when you report a problem.

Retries and timeoutsCopy Anchor Link

• Retried requests: GET, PUT, DELETE and conditional creates retry on 429, 502, 503, 504 or a connection failure, up to maxNetworkRetries times.
• Backoff: the first wait is 300 ms and doubles each time; Retry-After wins, and no wait is longer than 5 s.
• Timeouts: a timed-out request fails with OvokConnectionException. package:http cannot cancel it, so it may still reach the server.