에러 사전

{
  "error": {
    "type": "invalid_request_error",
    "code": "refund_exceeds_remaining_amount",
    "message": "환불 누계가 원주문 금액을 초과합니다.",
    "param": "data.amount",
    "hint": "주문 '20260801-000123' 의 남은 환불 가능 금액은 40,000원입니다. GET /v1/orders/{order_id} 로 확인하세요.",
    "doc_url": "https://linkfarm.ai/developers/errors#refund_exceeds_remaining_amount",
    "request_id": "req_df953ce566e74a9e91a3f6c2",
    "retryable": false
  }
}

// 429·5xx·네트워크 오류만 재시도합니다. 4xx 는 재시도해도 같은 결과입니다.
for (let attempt = 0; attempt < 4; attempt++) {
  const res = await fetch(url, init);
  if (res.ok) return res.json();

  let error;
  try {
    ({ error } = await res.json());
  } catch {
    // 프록시·로드밸런서가 만든 응답은 JSON 봉투가 아닐 수 있습니다.
    // 그때는 상태코드로 판단합니다 — 재시도 규칙(429·5xx)은 동일합니다.
    error = {
      code: `http_${res.status}`,
      message: res.statusText,
      retryable: res.status === 429 || res.status >= 500,
    };
  }
  if (!error?.retryable) throw new Error(`[${error.code}] ${error.message}`);

  await sleep(2 ** attempt * 250 + Math.random() * 250);  // 백오프 + 지터
}