# 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"
    }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opsnow.io/dev-opsnow-developer-guide-kr/errors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.