# Errors

opsnow\.io는 API 요청의 성공 또는 실패를 나타내기 위해 표준 HTTP 응답 코드를 사용합니다. 일반적으로 다음과 같습니다:

### 1. 2xx: 성공

### 2. 4xx: 클라이언트 오류

* 부정확하거나 불완전한 매개변수를 나타냅니다.

| 코드  | 설명                                                                        |
| --- | ------------------------------------------------------------------------- |
| 400 | **잘못된 요청**: 클라이언트의 요청이 잘못되었거나 유효하지 않습니다.                                  |
| 401 | **인증되지 않음**: 클라이언트가 인증되지 않았거나 인증 토큰이 만료되었습니다.                             |
| 404 | **찾을 수 없음**: 요청한 리소스가 서버에 없습니다.                                           |
| 405 | **허용되지 않는 메서드**: 지원되지 않는 HTTP 메서드로 리소스에 접근하려고 했습니다.                       |
| 429 | **너무 많은 요청**: 클라이언트가 주어진 시간 내에 너무 많은 요청을 보냈습니다. 일반적으로 요청 제한을 초과했음을 나타냅니다. |

### 3. 5xx: 서버 오류

* opsnow\.io 서버에 오류가 있음을 나타냅니다.

| 코드  | 설명                                                                                 |
| --- | ---------------------------------------------------------------------------------- |
| 500 | **내부 서버 오류**: 서버에서 내부 오류가 발생했습니다. 서버 로그에서 구체적인 원인을 확인해야 합니다.                       |
| 503 | **서비스를 사용할 수 없음**: 서버가 일시적으로 요청을 처리할 수 없습니다. 예를 들어, 서버가 과부하 상태이거나 유지 보수 중일 수 있습니다. |
| 504 | **게이트웨이 시간 초과**: 게이트웨이 또는 프록시 역할을 하는 서버가 업스트림 서버로부터 적시에 응답을 받지 못했습니다.              |

opsnow\.io는 또한 JSON 형식으로 오류 메시지와 오류 코드를 출력합니다.

```
{
    "status": "fail",
    "error": {
        "code": 401,
        "message": "Unauthorized"
    }
}
```