Ошибки

{
  "ok": true,
  "data": { /* полезная нагрузка эндпоинта */ }
}

{
  "ok": false,
  "error": {
    "code": "INVALID_SIGNATURE",
    "message": "X-Signature mismatch",
    "details": { /* опционально, доп. контекст */ },
    "traceId": "8f3c2a1e-..."
  }
}

async function callApi(req) {
  const res = await fetch(req.url, req.options);
  const env = await res.json();

  if (env.ok) return env.data;

  const { code, message, traceId } = env.error;
  switch (code) {
    case 'TIMESTAMP_SKEW':
      throw new Error('Часы рассинхронизированы — синхронизируйте NTP');
    case 'DUPLICATE_ORDER_ID':
      // Заявка с таким order_id уже создана — найдите её
      return findByOrderId(req.orderId);
    case 'RATE_LIMITED':
      // Уважаем Retry-After и повторяем
      await sleep(Number(res.headers.get('Retry-After') ?? 1) * 1000);
      return callApi(req);
    case 'INTERNAL_ERROR':
    case 'DATABASE_ERROR':
    case 'PROVIDER_UNAVAILABLE':
    case 'ALL_PROVIDERS_FAILED':
      // Транзиентные — повтор с backoff (см. ниже)
      throw new RetryableError(code, traceId);
    default:
      // Клиентские ошибки — чинить запрос, не повторять
      throw new Error(`${code}: ${message}`);
  }
}

# Любой ответ — это конверт; парсите .ok и .error.code
curl -sS https://wallet.your-exchange.com/v1/public/deposits/by-order-id/ord-20260626-0042 \
  -H "X-Api-Id: $API_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
  | jq 'if .ok then .data else .error.code end'