[Notice] Open API Error Code Reference
This notice provides information on potential error codes that may occur when using the Open API.
If a request fails while using the Open API, you can identify the issue by referring to the Response Code included in the response.
Below are the common error codes and their descriptions. Please refer to them for your development and operations.
■ Open API Error Code Mapping Table
| Error Code | Response code | Response name | Description |
| 1 | Success | 200 | Not included in actual REST API response |
| 2 | Invalid Arguments | 400 | Missing required parameters, data type errors, etc. |
| 3 | Target Not Found | 404 | Resource not found |
| 4 | Internal Error | 500 | Unexpected server processing error |
| 5 | Access Denied | 403 | No access permission |
| 6 | Unprocessable State | 412 | Request preconditions not met |
| 7 | Already Processed Request | 409 | Duplicate processing prevention |
| 8 | Unauthenticated | 401 | Missing authentication credentials |
| 9 | Expectation Failed | 417 | Server cannot meet client expectations |
| 10 | Rate Limit Exceeded | 429 | Rate limiting, request throttling |
| 11 | Request Cancelled | 408 | Client request cancelled or timeout |
| 1001 | Wallet Asset Approval Denied | 403 | Wallet approval permission error |
| 1002 | Insufficient On-chain Neso | 402 | Payment/asset shortage |
| 2002 | Synergy App Does Not Exist | 404 | Synergy app resource not found |
| 2003 | User Has Not Approved Synergy App | 403 | User approval required |
| 3001 | Invalid MSU Authentication Token | 401 | Token validation failed |
| 4001 | Token Expired | 401 | Token expired |
| 4002 | Expired by App from Same app_group | 401 | Token expired by another app |
| 0 | Default, Undefined Error | 500 | Development stage error, error code not set |
Thank you for your continued support and commitment to the MapleStory Universe Community.