Помилки

Як 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.