---
title: Open API 주요 에러 코드 목록
slug: world-sdk-guide-kr/open-api
docTags: 
createdAt: 2024-09-02T08:34:13.134Z
---

API 요청 값이 유효하지 않거나 처리 과정 중 오류가 발생하면, 다음 형식의 JSON 본문이 HTTP 상태 코드와 함께 반환됩니다.

```json
{
	 "message": "<오류 메시지>"
}
```

주요 오류 코드는 다음과 같습니다.



## 401

uri\_hash 또는 body\_hash와 같은 인증 정보가 올바르지 않을 때 발생합니다.

## 403

다른 사람의 월드에 대한 API가 호출될 때 발생합니다.

## 429

1분에 API 요청이 300회 이상 발생할 때 발생합니다.

## 500

API 운영 중 다양한 이유로 오류가 발생할 때 발생합니다.

응답의 메시지 필드를 통해 오류의 세부 정보를 확인할 수 있습니다.

| **API** | **메시지**          | **설명**                                                      |
| ------- | ---------------- | ----------------------------------------------------------- |
| 일반      | 알 수 없음           | 알 수 없는 오류입니다.<br />API를 올바르게 사용했는지 확인하십시오.                  |
| 선물 주기   | 항목이 존재하지 않음      | 선물로 보낼 항목이 없습니다.                                            |
| 선물 주기   | 계정 생성 후 30일 후 가능 | 계정을 생성한 후 30일이 지나야 선물을 보낼 수 있습니다.                           |
| 선물 주기   | 수신자가 이미 보유하고 있음  | 수신자가 이미 이 항목을 가지고 있습니다.                                     |
| 선물 주기   | 메시지가 적절하지 않음     | 유효하지 않은 메시지입니다.                                             |
| 선물 주기   | 자신에게 보낼 수 없음     | 자신에게 선물을 보낼 수 없습니다.                                         |
| 선물 주기   | 항목이 유효하지 않음      | 현재 이 항목을 선물로 보낼 수 없습니다.                                     |
| 선물 주기   | 항목 가격이 변경됨       | 항목의 가격이 변경되었습니다. 다시 시도하십시오.                                 |
| 선물 주기   | 수신자가 선물을 받을 수 없음 | 수신자가 선물 수신을 활성화하지 않았습니다. 그들이 선물 수신을 허용하도록 설정을 변경하도록 안내하십시오. |