Skip to main content
GET
https://sajuapi.dev
/
v1
/
status
서비스 상태 조회
curl --request GET \
  --url https://sajuapi.dev/v1/status \
  --header 'X-API-Key: <api-key>'
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
서비스의 상세 상태를 조회합니다. 각 컴포넌트(데이터베이스, 캐시, AI 모델)의 상태와 성능 지표를 확인할 수 있습니다.

​
Response

​
성공

서비스 상태 조회에 성공하면 ServiceStatus 객체가 반환됩니다.

​
실패

상태 코드에러 타입설명
401authentication_errorAPI 키가 유효하지 않음
429rate_limited요청 한도 초과

​
요청 예시

curl -X GET https://api.sajuapi.dev/v1/status \
  -H "X-API-Key: bs_live_xxx"

​
응답 예시

​
정상

{
  "status": "operational",
  "version": "1.2.3",
  "environment": "production",
  "timestamp": "2025-01-16T09:00:00Z",
  "components": {
    "api": {
      "status": "operational",
      "latency_ms": 12
    },
    "database": {
      "status": "operational",
      "latency_ms": 8,
      "connections": {
        "active": 15,
        "idle": 5,
        "max": 100
      }
    },
    "cache": {
      "status": "operational",
      "latency_ms": 2,
      "hit_rate": 78.5,
      "memory_usage_mb": 256
    },
    "ai_models": {
      "status": "operational",
      "haiku": {
        "status": "operational",
        "avg_latency_ms": 1200
      },
      "sonnet": {
        "status": "operational",
        "avg_latency_ms": 2800
      },
      "gpt4o": {
        "status": "degraded",
        "avg_latency_ms": 5500,
        "message": "Higher than normal latency"
      }
    }
  },
  "uptime": {
    "seconds": 864000,
    "human": "10 days"
  },
  "last_incident": {
    "id": "inc_abc123",
    "status": "resolved",
    "resolved_at": "2025-01-10T15:30:00Z",
    "message": "Database connection pool exhausted"
  }
}

​
부분 장애

{
  "status": "degraded",
  "version": "1.2.3",
  "environment": "production",
  "timestamp": "2025-01-16T09:00:00Z",
  "components": {
    "api": {
      "status": "operational",
      "latency_ms": 15
    },
    "database": {
      "status": "degraded",
      "latency_ms": 250,
      "message": "High latency detected",
      "connections": {
        "active": 95,
        "idle": 0,
        "max": 100
      }
    },
    "cache": {
      "status": "operational",
      "latency_ms": 3
    },
    "ai_models": {
      "status": "operational"
    }
  },
  "active_incidents": [
    {
      "id": "inc_xyz789",
      "status": "investigating",
      "started_at": "2025-01-16T08:45:00Z",
      "message": "Database performance degradation"
    }
  ]
}

​
ServiceStatus 객체

필드타입설명
statusstring전체 서비스 상태입니다. operational, degraded, outage 중 하나입니다.
versionstringAPI 버전입니다.
environmentstring환경입니다. production, staging 중 하나입니다.
timestampstring상태 확인 시간입니다.
componentsobject각 컴포넌트별 상태입니다.
uptimeobject서비스 가동 시간입니다.
last_incidentobject마지막 인시던트 정보입니다.
active_incidentsarray현재 진행 중인 인시던트 목록입니다.

​
상태 값

상태설명
operational모든 시스템이 정상적으로 작동 중입니다.
degraded일부 기능이 저하되었지만 서비스는 이용 가능합니다.
outage서비스를 사용할 수 없습니다.

​
모니터링 대시보드

서비스 상태를 주기적으로 모니터링하여 장애를 조기에 감지할 수 있습니다. 
// 상태 모니터링 예시
async function monitorStatus() {
  const response = await fetch('/v1/status', {
    headers: { 'X-API-Key': 'bs_live_xxx' }
  });

  const status = await response.json();

  // 전체 상태 확인
  if (status.status !== 'operational') {
    console.warn(`서비스 상태: ${status.status}`);

    // 문제 컴포넌트 확인
    for (const [name, component] of Object.entries(status.components)) {
      if (component.status !== 'operational') {
        console.error(`${name}: ${component.status} - ${component.message || ''}`);
      }
    }
  }

  // 캐시 히트율 확인
  if (status.components.cache.hit_rate < 50) {
    console.warn(`캐시 히트율 저하: ${status.components.cache.hit_rate}%`);
  }

  return status;
}

// 5분마다 모니터링
setInterval(monitorStatus, 5 * 60 * 1000);
상태 페이지는 공개적으로 접근 가능하지만, 상세 정보(연결 수, 메모리 사용량 등)는 인증된 요청에만 포함됩니다.