Error Codes
In case of compilation failures or validation issues, the API returns JSON error responses.
| Status Code | Error Code | Title | Description |
|---|---|---|---|
| 200 OK | - | Success | PDF successfully built and streamed or stored. |
| 401 Unauthorized | HD-A003 | Unauthorized | Missing API keys or invalid token. |
| 402 Payment Required | HD-A002 | Insufficient Balance | Insufficient wallet credits for this conversion operation. |
| 404 Not Found | HD-A004 | Not Found | PDF file or task ID not found or unauthorized to access. |
| 422 Unprocessable | HD-A001 | Validation Failure | Syntax errors, missing parameters, or parameter limits (like file size/pages) exceeded. |
| 500 Server Error | HD-A000 | Render Crash / Error | Headless Chromium timeout, LibreOffice failure, or generic server errors. |