docs/status_code.md

# Error Codes Reference

## 🔹 Summary Table

| Code | Message                                               | Description                                |
| ---- | ----------------------------------------------------- | ------------------------------------------ |
| 400  | Text must contain at least two words                  | Input text too short                       |
| 400  | Text should be less than 10,000 characters            | Input text too long                        |
| 404  | The file is empty or only contains whitespace         | File has no usable content                 |
| 404  | Invalid file type. Only .docx, .pdf, and .txt allowed | Unsupported file format                    |
| 403  | Invalid or expired token                              | Authentication token is invalid or expired |
| 413  | Text must contain at least two words                  | Text too short (alternative condition)     |
| 413  | Text must be less than 10,000 characters              | Text too long (alternative condition)      |
| 413  | The image error (preprocessing)                       | Image size/content issue                   |
| 500  | Error processing the file                             | Internal server error while processing     |

---

## 🔍 Error Details

### `400` - Bad Request

- **Text must contain at least two words**  
  The input text field is too short. Submit at least two words to proceed.

- **Text should be less than 10,000 characters**  
  Input text exceeds the maximum allowed character limit. Consider truncating or summarizing the content.

---

### `404` - Not Found

- **The file is empty or only contains whitespace**  
  The uploaded file is invalid due to lack of meaningful content. Ensure the file has readable, non-empty text.

- **Invalid file type. Only .docx, .pdf, and .txt are allowed**  
  The file format is not supported. Convert the file to one of the allowed formats before uploading.

---

### `403` - Forbidden

- **Invalid or expired token**  
  Your access token is either expired or incorrect. Try logging in again or refreshing the token.

---

### `413` - Payload Too Large

- **Text must contain at least two words**  
  The text payload is too small or malformed under a large upload context. Add more content.

- **Text must be less than 10,000 characters**  
  The payload exceeds the allowed character limit for a single request. Break it into smaller chunks if needed.

- **The image error**  
  The uploaded image is too large or corrupted. Try resizing or compressing it before retrying.

---

### `500` - Internal Server Error

- **Error processing the file**  
  An unexpected server-side failure occurred during file analysis. Retry later or contact support if persistent.

---

> 📌 **Note:** Always validate inputs, check token status, and follow file guidelines before making requests.