Rannz API Factory

Masuk Buat akun

Rannz Public Data API | Rannz API Factory

Siap, belum diperiksaPremiumDibuat Rannz

Rannz Public Data API

Indikator pembangunan World Bank dengan deret waktu ter-normalisasi.

Lihat paket Premium

Tentang API ini

Deret waktu indikator World Bank (populasi, PDB, dll.) untuk hingga lima negara serta profil negara. Seluruh endpoint layanan ini Premium. Data diperbarui tahunan dan sering tertinggal beberapa tahun.

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: The World Bank Open Data
Dokumentasi resmi: Buka dokumentasi
Lisensi: Dataset CC BY 4.0: atribusi wajib dicantumkan.
Atribusi wajib: Data from The World Bank (CC BY 4.0)
Kategori: Data Publik

Endpoint (2)

Coba di API Explorer

GET/api/v1/public-data/indicatorPremiumcache 24 jam

Deret waktu indikator World Bank

Nilai tahunan sebuah indikator (contoh SP.POP.TOTL = populasi) untuk satu hingga lima negara. Data World Bank diperbarui tahunan dan sering tertinggal; nilai null berarti belum tersedia. Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
country	query	string	Ya	Kode ISO alpha-2/alpha-3, maksimal 5 dipisah koma.
indicator	query	string	Ya	Kode indikator World Bank.
start	query	integer	Tidak	Tahun mulai (bersama end). Rentang: 1960 - 2100.
end	query	integer	Tidak	Tahun akhir (bersama start). Rentang: 1960 - 2100.

Contoh request

curl "https://layananapirannz.web.id/api/v1/public-data/indicator?country=ID%2CMY&indicator=SP.POP.TOTL&start=2015&end=2023" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "series": [
      {
        "country": {
          "code": "IDN",
          "name": "Indonesia"
        },
        "indicator": {
          "id": "SP.POP.TOTL",
          "name": "Population, total"
        },
        "points": [
          {
            "year": 2022,
            "value": 275501339
          },
          {
            "year": 2023,
            "value": 277534122
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "publicdata.indicator",
    "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": "country",
        "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/public-data/country/:codePremiumcache 24 jam

Profil negara menurut World Bank

Wilayah, tingkat pendapatan, dan ibu kota menurut klasifikasi World Bank. Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
code	path	string	Ya	Kode ISO alpha-2 atau alpha-3.

Contoh request

curl "https://layananapirannz.web.id/api/v1/public-data/country/ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "code3": "IDN",
    "code2": "ID",
    "name": "Indonesia",
    "region": "East Asia & Pacific",
    "incomeLevel": "Upper middle income",
    "capital": "Jakarta",
    "latitude": -6.19752,
    "longitude": 106.83
  },
  "meta": {
    "requestId": "…",
    "endpoint": "publicdata.country",
    "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": "code",
        "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.