Ошибки

Как 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:

CodeStatusDescription
unauthorized401Missing or invalid API key.
rate_limit_exceeded429Per-key rate limit hit.
storage_quota_exceeded402Plan storage quota would be exceeded.
validation_error422Request body or query parameter invalid.
invalid_image_content422File is not a valid image.
unsupported_media_type415File format not in JPEG/PNG/WebP/AVIF.
file_too_large413File exceeds 10 MB.
not_found_error404Resource not found or not owned by this key.