Dokumentasi API

Dokumentasi lengkap Magentod API

Error Handling

Memahami kode error dan cara menangani kesalahan dalam API Magentod

API Magentod menggunakan kode status HTTP standar dan format error yang konsisten untuk memudahkan debugging.

Format Error Response

Semua error response mengikuti format yang konsisten

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Deskripsi error yang dapat dibaca manusia",
    "details": {
      "field": "Informasi tambahan tentang error"
    },
    "request_id": "req_1234567890"
  }
}

HTTP Status Codes

400

Bad Request

Request tidak valid atau parameter yang diperlukan hilang

401

Unauthorized

API key tidak valid atau tidak ada

403

Forbidden

Tidak memiliki izin untuk mengakses resource

404

Not Found

Resource yang diminta tidak ditemukan

429

Too Many Requests

Rate limit terlampaui

500

Internal Server Error

Kesalahan server internal

Common Error Codes

INVALID_API_KEY

API key yang diberikan tidak valid atau sudah kedaluwarsa

VALIDATION_ERROR

Data yang dikirim tidak memenuhi validasi yang diperlukan

RESOURCE_NOT_FOUND

Resource dengan ID yang diberikan tidak ditemukan

INSUFFICIENT_PERMISSIONS

API key tidak memiliki izin untuk melakukan operasi ini