Daftar Kode Error & Status HTTP

Struktur standar respons error JSON dan kamus lengkap error code API SmallPict.

Daftar Kode Error & Status HTTP

Seluruh respons error dari API SmallPict mengembalikan format JSON standar.

📦 Struktur JSON Error Standar

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Batas kuota optimasi gambar bulanan untuk akun Anda telah tercapai.",
    "details": {
      "current_bytes": 10737418240,
      "quota_bytes": 10737418240,
      "reset_at": "2026-09-01T00:00:00Z"
    }
  }
}

📋 Kamus Lengkap Kode Error

Status HTTP	ErrorCode Enum	Tipe Exception SDK	Deskripsi
400	`VALIDATION_FAILED`	`ValidationError`	Parameter payload tidak valid atau ada field wajib yang kosong.
400	`FILE_TOO_LARGE`	`FileTooLargeError`	Ukuran file melebihi batas upload maksimal pada paket langganan.
400	`UNSUPPORTED_FORMAT`	`UnsupportedFormatError`	Format file yang dikirim tidak didukung.
401	`UNAUTHORIZED`	`AuthenticationError`	Kredensial API key atau tanda tangan HMAC tidak valid.
401	`ERR_TIMESTAMP_DRIFT`	`AuthenticationError`	Timestamp request melebihi toleransi drift ±300 detik.
402	`QUOTA_EXCEEDED`	`QuotaExceededError`	Kuota pemrosesan gambar bulanan telah habis.
403	`FORBIDDEN`	`PermissionDeniedError`	API key telah dicabut (revoked) atau akun ditangguhkan.
403	`KEY_SCOPE_MISMATCH`	`ScopeMismatchError`	Menggunakan key WordPress pada endpoint SDK atau sebaliknya.
404	`NOT_FOUND`	`NotFoundError`	Sumber daya atau `job_id` tidak ditemukan.
429	`RATE_LIMIT_EXCEEDED`	`RateLimitError`	Frekuensi request melebihi batas kecepatan. Ikuti header `Retry-After`.
500	`INTERNAL_ERROR`	`ServerError`	Terjadi kesalahan internal di server cloud.