Rannz Weather API

Cuaca saat ini untuk sebuah kota atau koordinat

Mengembalikan kondisi cuaca terkini (suhu, kelembapan, angin, curah hujan) yang sudah dinormalisasi. Data berasal dari model cuaca Open-Meteo dan diperbarui berkala; ini bukan pengamatan stasiun real-time.

Contoh request

curl "https://layananapirannz.web.id/api/v1/weather?city=Jakarta&country=ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "location": {
      "name": "Jakarta",
      "region": "Jakarta",
      "country": "Indonesia",
      "countryCode": "ID",
      "latitude": -6.21462,
      "longitude": 106.84513,
      "timezone": "Asia/Jakarta"
    },
    "current": {
      "time": "2026-10-17T22:45",
      "temperatureC": 28.4,
      "apparentTemperatureC": 32.1,
      "humidityPercent": 78,
      "precipitationMm": 0,
      "windSpeedKmh": 8.3,
      "windDirectionDeg": 110,
      "isDay": false,
      "weatherCode": 3,
      "condition": "Berawan"
    }
  },
  "meta": {
    "requestId": "…",
    "endpoint": "weather.current",
    "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": "city",
        "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.

Prakiraan cuaca harian hingga 16 hari

Prakiraan harian: kondisi, suhu min/maks, curah hujan, peluang hujan, dan angin maksimum. Endpoint Premium.

Contoh request

curl "https://layananapirannz.web.id/api/v1/weather/forecast?city=Jakarta&country=ID&days=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "location": {
      "name": "Jakarta",
      "region": "Jakarta",
      "country": "Indonesia",
      "countryCode": "ID",
      "latitude": -6.21462,
      "longitude": 106.84513,
      "timezone": "Asia/Jakarta"
    },
    "daily": [
      {
        "date": "2026-10-18",
        "condition": "Hujan ringan",
        "weatherCode": 61,
        "temperatureMinC": 25.1,
        "temperatureMaxC": 32.4,
        "precipitationMm": 3.2,
        "precipitationProbabilityPercent": 70,
        "windSpeedMaxKmh": 14.2
      }
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "weather.forecast",
    "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": "city",
        "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.