Rannz Image Metadata API

Metadata gambar dari data base64

Mengirim gambar sebagai base64 (boleh berupa data URL) dan menerima format, dimensi, ukuran, SHA-256, serta ada/tidaknya alpha. Hanya header yang dibaca; gambar tidak disimpan. Mendukung PNG, JPEG, GIF, WebP, BMP hingga 2 MiB.

Contoh request

curl -X POST "https://layananapirannz.web.id/api/v1/image/metadata" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"imageBase64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAA..."}'

Contoh respons sukses (200)

{
  "data": {
    "format": "png",
    "mimeType": "image/png",
    "width": 1,
    "height": 1,
    "sizeBytes": 68,
    "sha256": "a8e4e0a4a2c1f2ef8b2f1d5f1f7f0b9f6c0c8b0e8e4d6a1f6a8f6c3b2d1e0f9a",
    "hasAlpha": true
  },
  "meta": {
    "requestId": "…",
    "endpoint": "image.metadata",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "imageBase64",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

• 400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
• 401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
• 403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
• 403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
• 404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
• 429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
• 429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
• 502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
• 502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

Metadata gambar dari URL publik

Server Rannz mengunduh gambar dari URL https publik (maks 2 MiB, tanpa redirect, hanya port 443) lalu membaca metadatanya. Alamat privat/internal diblokir (proteksi SSRF). Endpoint Premium.

Contoh request

curl "https://layananapirannz.web.id/api/v1/image/metadata-from-url?url=https%3A%2F%2Fexample.com%2Flogo.png" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "url": "https://example.com/logo.png",
    "format": "png",
    "mimeType": "image/png",
    "width": 1,
    "height": 1,
    "sizeBytes": 68,
    "sha256": "a8e4e0a4a2c1f2ef8b2f1d5f1f7f0b9f6c0c8b0e8e4d6a1f6a8f6c3b2d1e0f9a",
    "hasAlpha": true
  },
  "meta": {
    "requestId": "…",
    "endpoint": "image.metadataFromUrl",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "url",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

• 400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
• 401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
• 403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
• 403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
• 404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
• 429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
• 429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
• 502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
• 502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.