🌐 한국어

Troubleshooting

Response code

Response codes include an HTTP status code indicating the status of the request and an error code about the error information. If the request is successful, the response body is returned with a status code of 200. If failed, an error code with the code and msg is returned.

HTTP status code

The HTTP status code is a 3-digit integer in the first line of a response message, indicating the request result (success or failure). The status codes are classified into five, and the first digit of the status code defines the types of response. Refer to RFC 2616 to see more about HTTP status code.

Here is the list of HTTP status codes.

Code	Status	Description
200 OK	Success	Indicates that the server has received and processed the client's request successfully. The format of the response body may differ depending on APIs. Refer to the detailed description of each API.
400 Bad Request	Fail	General error Indicates the state in which the server has detected a client error related to required parameters and cannot process the request.
401 Unauthorized	Fail	Authorization error (mostly related to tokens) Indicates that the request has failed because the client has no valid authorization credentials for the resource.
403 Forbidden	Fail	Permission Error Indicates that the server has received the client's request but rejected it because the client has no permission.
429 Too Many Request	Fail	Quota exceeded Indicates that the quota limit or the limit per second for the API has been exceeded.
500 Internal Server Error	Fail	System error 500 refers to the class of server errors, indicating that the server is in an unexpected situation while processing the request.
502 Bad Gateway	Fail	System error Indicates that communication is not working properly because a gateway converts to another wrong protocol or has something wrong with the converting protocol.
503 Service Unavailable	Fail	Undergoing maintenance Indicates that the server is not ready to process the request.

Common Error Codes

The following table lists the error codes that may occur for each API product. When an error occurs, check the corresponding code to identify the cause.

Example response (In case of an unexpected server error):

{ 
"code": -1, 
"msg": "internal server error"
}

Code	HTTP status code	Description
-1	500	Internal server error occurred during processing. Solution: Retry.
-2	400	Required parameters are missing, or values are of the wrong type or out of range. Solution: Check your request parameters.
-3	403	Required features (e.g., Simple Signup, Consent Items) are not enabled. Solution: Go to Kakao Developers > App > your app > Dashboard > Settings. Under the relevant item, click Set, and set Usage settings to On. After completing these steps, retry the API request.
-4	403	The account is restricted or is performing restricted actions.
-5	403	The app does not have permission to access the requested API. Solution: Request API review to obtain permission.
-7	500	The service is under maintenance or experiencing internal issues.
-8	400	The request was sent with invalid headers. Solution: Check and correct your request headers.
-9	400	The API you’re calling has been deprecated.
-10	400	API request quota exceeded. Solution: Check and adjust your usage within allowed limits.
-401	401	Invalid app key or access token, or mismatch between the calling app and the registered app. Solution: Verify app key or renew token, and check registered app info on the Kakao Developers.
-602	400	Uploaded image exceeds the maximum allowed file size.
-603	400	The request took too long to complete (e.g., image upload or scraping).
-903	400	The request was made using an unregistered developer’s app key or token.
-911	400	Unsupported image format
-9798	503	The service is currently under maintenance.