에러

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "사람이 읽을 수 있는 설명",
    "hint": "해결 방법 (선택)",
    "field": "specific.field.path (선택)"
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "제공된 API 키가 유효하지 않습니다",
    "hint": "API 키는 'bs_live_' 또는 'bs_test_'로 시작합니다"
  }
}

{
  "error": {
    "code": "missing_field",
    "message": "필수 필드 'saju.pillars.day'가 누락되었습니다",
    "field": "saju.pillars.day"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "요청 제한 초과. 42초 후에 다시 시도하세요.",
    "retryAfter": 42
  }
}

{
  "error": {
    "code": "ai_provider_error",
    "message": "AI 제공자가 에러를 반환했습니다",
    "hint": "다시 시도하거나 다른 모델을 사용하세요"
  }
}

class SajuClientError extends Error {
  constructor(
    public code: string,
    message: string,
    public requestId?: string,
    public retryAfter?: number
  ) {
    super(message);
    this.name = 'SajuClientError';
  }
}

async function callAPI(endpoint: string, body: object) {
  const response = await fetch(`https://api.sajuapi.dev${endpoint}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.BITHUMB_API_KEY!
    },
    body: JSON.stringify(body)
  });

  const data = await response.json();

  if (!data.success) {
    throw new SajuClientError(
      data.error.code,
      data.error.message,
      data.meta?.requestId,
      data.error.retryAfter
    );
  }

  return data;
}

// 에러 처리와 함께 사용
try {
  const fortune = await callAPI('/api/daily-fortune', { saju, userName });
  console.log(fortune.data);
} catch (error) {
  if (error instanceof SajuClientError) {
    switch (error.code) {
      case 'rate_limited':
        await sleep(error.retryAfter! * 1000);
        // 재시도...
        break;
      case 'invalid_api_key':
        console.error('API 키 설정을 확인하세요');
        break;
      default:
        console.error(`API 에러 [${error.code}]: ${error.message}`);
    }
  }
}

class SajuClientError(Exception):
    def __init__(self, code: str, message: str, request_id: str = None, retry_after: int = None):
        self.code = code
        self.message = message
        self.request_id = request_id
        self.retry_after = retry_after
        super().__init__(message)

def call_api(endpoint: str, body: dict):
    response = requests.post(
        f'https://api.sajuapi.dev{endpoint}',
        headers={
            'Content-Type': 'application/json',
            'X-API-Key': os.environ['BITHUMB_API_KEY']
        },
        json=body
    )

    data = response.json()

    if not data.get('success'):
        error = data.get('error', {})
        raise SajuClientError(
            code=error.get('code', 'unknown'),
            message=error.get('message', '알 수 없는 에러'),
            request_id=data.get('meta', {}).get('requestId'),
            retry_after=error.get('retryAfter')
        )

    return data

# 사용법
try:
    fortune = call_api('/api/daily-fortune', {'saju': saju, 'userName': '홍길동'})
except SajuClientError as e:
    if e.code == 'rate_limited':
        time.sleep(e.retry_after)
        # 재시도...
    else:
        print(f'API 에러 [{e.code}]: {e.message}')
        print(f'요청 ID: {e.request_id}')