Ошибки
Как FastPic возвращает ошибки и что ожидать от каждого статуса.
Все endpoint'ы FastPic API используют стандартные HTTP-статус-коды. Успешные запросы возвращают 2xx. Неуспешные возвращают 4xx или 5xx с JSON-телом, содержащим statusCode, message и errorStatusCode — машиночитаемый enum, по которому можно строить логику обработки.
Формат ответа с ошибкой
Каждый ответ с ошибкой следует единому формату:
error response
{ "statusCode": 401, "message": "Invalid API key", "errorStatusCode": "unauthorized"}Коды ошибок
FastPic использует следующие значения errorStatusCode в API:
| Code | Status | Description |
|---|---|---|
| unauthorized | 401 | Missing or invalid API key. |
| rate_limit_exceeded | 429 | Per-key rate limit hit. |
| storage_quota_exceeded | 402 | Plan storage quota would be exceeded. |
| validation_error | 422 | Request body or query parameter invalid. |
| invalid_image_content | 422 | File is not a valid image. |
| unsupported_media_type | 415 | File format not in JPEG/PNG/WebP/AVIF. |
| file_too_large | 413 | File exceeds 10 MB. |
| not_found_error | 404 | Resource not found or not owned by this key. |