The FASHUB API is a RESTful HTTP API. All requests and responses use JSON. Click any endpoint below to expand its documentation, parameters, and example requests.
Protected endpoints require a Bearer JWT token in the Authorization header. Obtain a token by calling .
Authorization: Bearer <your_jwt_token>
| Endpoint type | Limit | Window |
|---|---|---|
| All authenticated endpoints | 1000 | per hour per user |
| POST /api/auth/* | 20 | per 15 minutes per IP |
| POST /api/upload | 50 | per hour per user |
When rate limited, the API responds with 429 Too Many Requests and a Retry-After header.
| Code | Meaning | When it occurs |
|---|---|---|
| 200 | OK | Request succeeded, data returned |
| 201 | Created | Resource successfully created |
| 400 | Bad Request | Missing or invalid request parameters |
| 401 | Unauthorized | Missing or invalid Bearer token |
| 403 | Forbidden | Authenticated but not authorised for this action |
| 404 | Not Found | Resource does not exist |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Unexpected server error — contact support |
