API REFERENCE
ZEPETO World Open API

List of key Open API error codes

4min

When the API request value is invalid or an error occurs during the handling process, the JSON body with the following form will be returned with the HTTP status code.

JSON


The key error codes are as follows.



401

Occurs when authentication information, such as uri_hash or body_hash, is incorrect.

403

Occurs when the api for another person's World is called instead of yours.

429

Occurs when the api is requested more than 300 times in 1 minute.

500

Occurs when there is an error due to various reasons in the operation of the api.

Details of the error can be seen through the message field of the response.

API

Message

Description

Common

UNKNOWN

Unknown error. Please check whether you have used the api correctly.

Giving a Gift

item is not exist

There is no item to be sent as a gift.

Giving a Gift

possible after 30 days from account creation

You can send gifts after 30 days of creating an account.

Giving a Gift

receiver already have

The recipient already has this item.

Giving a Gift

message not appropriate

Invalid message.

Giving a Gift

can not send yourself

You cannot send gifts to yourself.

Giving a Gift

item is not valid

The item cannot be sent as a gift right now.

Giving a Gift

item price changed

The price of the item has been changed. Please try again.

Giving a Gift

receiver not allowed to accept gift

The recipient has not enabled gift receiving. Please guide them to change their settings to allow receiving gifts.