Error Codes

Complete list of API error codes, their meanings, and how to handle them.

HTTP Status Codes

The RakuWP API uses standard HTTP status codes to indicate the result of a request:

Code	Meaning	When It Occurs
`200`	Success	Request was processed successfully
`400`	Bad Request	Missing or invalid parameters
`401`	Unauthorized	Invalid or missing license key
`403`	Forbidden	License is expired, suspended, or revoked
`404`	Not Found	Endpoint or resource does not exist
`429`	Too Many Requests	Rate limit exceeded
`500`	Server Error	Unexpected server-side error

Error Response Format

All error responses follow a consistent JSON structure:

{
    "success": false,
    "error": "Human-readable error message",
    "code": "ERROR_CODE"
}

Common Error Codes

License Errors

Code	Description	Resolution
`LICENSE_INVALID`	The license key is not recognized	Check for typos. Copy the key from the panel.
`LICENSE_EXPIRED`	The license has expired	Renew your subscription from the Billing page.
`LICENSE_SUSPENDED`	The license has been suspended	Contact support for assistance.
`SITE_LIMIT_REACHED`	Maximum number of active sites reached	Deactivate an existing site before adding a new one.
`SITE_NOT_REGISTERED`	The site URL is not registered	Add your site URL in the panel before activating.

Request Errors

Code	Description	Resolution
`MISSING_PARAMETER`	A required field is missing	Check the API documentation for required fields.
`INVALID_URL`	The provided URL is not valid	Ensure the site URL includes the protocol (https://).
`RATE_LIMITED`	Too many requests in a short period	Wait and retry. Implement exponential backoff.

Handling Errors in Your Code

Always check the success field in the response before processing data. Log error responses for debugging. The plugin handles most errors automatically, but custom integrations should implement proper error handling.