Rannz Public Data API

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.

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.

Profil negara menurut World Bank

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

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.