Rannz API Factory

Masuk Buat akun

Rannz Image Metadata API | Rannz API Factory

Siap, belum diperiksaFree + PremiumDibuat Rannz

Rannz Image Metadata API

Format, dimensi, dan hash gambar dari base64 atau URL publik.

Lihat paket Premium

Tentang API ini

Membaca header gambar (PNG, JPEG, GIF, WebP, BMP) tanpa menyimpannya. Metadata dari base64 gratis dan dihitung lokal. Metadata dari URL adalah Premium dan dilindungi dari SSRF (hanya https publik, port 443, tanpa redirect, maks 2 MiB).

Informasi

Status: Siap, belum diperiksaImplementasi tersedia tetapi belum lulus pemeriksaan operasional.
Pemeriksaan terakhir: Belum pernah diperiksa
Autentikasi sumber: Authorization: Bearer <API key Rannz>. Buat key di dashboard setelah login.
Batas pemakaian: Mengikuti paket Anda: Free atau Premium. Lihat header X-RateLimit-* dan X-Quota-* pada setiap respons.
Sumber data: Perhitungan lokal
Dokumentasi resmi: Buka dokumentasi
Lisensi: Tanpa sumber data pihak ketiga. Gambar tidak disimpan; hanya metadata yang dikembalikan.
Kategori: Gambar dan Media

Endpoint (2)

Coba di API Explorer

POST/api/v1/image/metadataFree

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.

Parameter	Lokasi	Tipe	Wajib	Keterangan
imageBase64	body JSON	string	Ya	Isi gambar dalam base64 (maks 2 MiB setelah decode).

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.

GET/api/v1/image/metadata-from-urlPremiumcache 10 menit

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.

Parameter	Lokasi	Tipe	Wajib	Keterangan
url	query	string	Ya	URL https gambar publik.

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.