{
  "openapi": "3.1.0",
  "info": {
    "title": "API Data Terbuka SIPAGA Kaltim",
    "version": "1.0.0",
    "summary": "Kerawanan kebakaran gambut dan lahan serta titik panas satelit di Kalimantan Timur.",
    "description": "Data terbuka **SIPAGA Kaltim**: kerawanan kebakaran gambut dan lahan (indeks KBDI) untuk 210 wilayah pantau di Kalimantan Timur, serta titik panas satelit.\n\n- **Statis dan hanya-baca.** Setiap sumber daya adalah berkas yang dibuat ulang setelah pipeline berjalan: indeks pukul 06.15 dan 18.15 WITA, titik panas setiap jam. Tidak ada parameter kueri; saring di sisi Anda.\n- **Tanpa kunci.** Metode yang diterima hanya `GET`, `HEAD`, dan `OPTIONS`. CORS terbuka (`*`) tanpa kredensial.\n- **Batas laju:** 60 permintaan per menit per alamat IP, dengan cadangan hingga 40 permintaan beruntun. Melewatinya menghasilkan `429` dengan `Retry-After`. Pakai berkas gabungan (`wilayah.json`, `wilayah-riwayat.json`) alih-alih mengambil 210 berkas satu per satu.\n- **Cache:** kirim `If-None-Match` dengan `ETag` sebelumnya; jawaban `304` tidak berisi badan. Mengambil lebih sering dari 10 menit tidak memberi data yang lebih baru.\n- **Lisensi:** indeks CC BY 4.0; titik panas dan batas wilayah mengikuti sumbernya (lihat `meta.lisensi`). Cantumkan `meta.atribusi` saat memakai ulang.\n\nBukan produk resmi BMKG maupun Kementerian Kehutanan. Angka tinggi berarti lahan siap terbakar, bukan sedang terbakar.",
    "license": {
      "name": "CC BY 4.0 (data indeks)",
      "identifier": "CC-BY-4.0"
    },
    "contact": {
      "name": "Bontang Techno Hub",
      "url": "https://bontangtechnohub.com"
    }
  },
  "servers": [
    {
      "url": "https://sipaga.bontangtechnohub.com/api/v1",
      "description": "Produksi"
    }
  ],
  "externalDocs": {
    "description": "Dokumentasi lengkap dalam bahasa Indonesia",
    "url": "https://sipaga.bontangtechnohub.com/api/"
  },
  "tags": [
    {
      "name": "meta",
      "description": "Penemuan sumber daya"
    },
    {
      "name": "ringkasan",
      "description": "Gambaran seluruh provinsi"
    },
    {
      "name": "kabupaten",
      "description": "Sepuluh kabupaten/kota"
    },
    {
      "name": "wilayah",
      "description": "210 wilayah pantau: 16 KHG dan 194 petak 0,25°"
    },
    {
      "name": "titik-panas",
      "description": "Titik panas satelit"
    },
    {
      "name": "status",
      "description": "Kesegaran data dan jadwal pembaruan."
    }
  ],
  "paths": {
    "/": {
      "get": {
        "tags": [
          "meta"
        ],
        "summary": "Daftar sumber daya",
        "description": "Tautan ke setiap sumber daya, waktu pembaruan terakhir, lisensi, dan atribusi.",
        "operationId": "daftarSumberDaya",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/ringkasan.json": {
      "get": {
        "tags": [
          "ringkasan"
        ],
        "summary": "Ringkasan provinsi",
        "description": "Sebaran luas per kelas, peringatan meluas, dan kab/kota paling rawan.",
        "operationId": "ambilRingkasan",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "$ref": "#/components/schemas/Ringkasan"
                    }
                  }
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/kabupaten.json": {
      "get": {
        "tags": [
          "kabupaten"
        ],
        "summary": "Semua kabupaten/kota",
        "description": "Diurutkan dari persentase luas kelas Tinggi ke atas yang terbesar.",
        "operationId": "daftarKabupaten",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Kabupaten"
                      }
                    }
                  }
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/kabupaten.geojson": {
      "get": {
        "tags": [
          "kabupaten"
        ],
        "summary": "Kabupaten/kota sebagai GeoJSON",
        "description": "Poligon batas kab/kota beserta atribut yang sama dengan kabupaten.json.",
        "operationId": "kabupatenGeoJSON",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/KabupatenGeoJSON"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/kabupaten/{kode}.json": {
      "get": {
        "tags": [
          "kabupaten"
        ],
        "summary": "Satu kabupaten/kota",
        "description": "Beserta seluruh wilayah pantau yang menyentuhnya.",
        "operationId": "ambilKabupaten",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "$ref": "#/components/schemas/KabupatenRinci"
                    }
                  }
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          },
          "404": {
            "$ref": "#/components/responses/TidakDitemukan"
          }
        },
        "parameters": [
          {
            "name": "kode",
            "in": "path",
            "required": true,
            "description": "Kode Kemendagri, misalnya 64.74 untuk Kota Bontang.",
            "schema": {
              "type": "string",
              "pattern": "^64\\.\\d{2}$"
            },
            "example": "64.74"
          }
        ]
      }
    },
    "/wilayah.json": {
      "get": {
        "tags": [
          "wilayah"
        ],
        "summary": "Semua wilayah pantau",
        "description": "Angka terkini 210 wilayah, tanpa riwayat.",
        "operationId": "daftarWilayah",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Wilayah"
                      }
                    }
                  }
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/wilayah.geojson": {
      "get": {
        "tags": [
          "wilayah"
        ],
        "summary": "Wilayah pantau sebagai GeoJSON",
        "description": "Poligon 210 wilayah beserta atribut yang sama dengan wilayah.json.",
        "operationId": "wilayahGeoJSON",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/WilayahGeoJSON"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/wilayah/{id}.json": {
      "get": {
        "tags": [
          "wilayah"
        ],
        "summary": "Satu wilayah pantau",
        "description": "Angka terkini, riwayat 90 hari, dan prakiraan.",
        "operationId": "ambilWilayah",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "$ref": "#/components/schemas/WilayahRinci"
                    }
                  }
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          },
          "404": {
            "$ref": "#/components/responses/TidakDitemukan"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "id wilayah dari wilayah.json.",
            "schema": {
              "type": "string",
              "pattern": "^(khg|grid)-[0-9a-z_-]+$"
            },
            "example": "khg-64-02-08-01"
          }
        ]
      }
    },
    "/wilayah-riwayat.json": {
      "get": {
        "tags": [
          "wilayah"
        ],
        "summary": "Riwayat semua wilayah",
        "description": "Riwayat 90 hari dan prakiraan seluruh wilayah dalam satu berkas.",
        "operationId": "riwayatSemuaWilayah",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "riwayat": {
                            "type": "array",
                            "items": {
                              "$ref": "#/components/schemas/Titik"
                            }
                          },
                          "prakiraan": {
                            "type": "array",
                            "items": {
                              "$ref": "#/components/schemas/Titik"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/titik-panas.geojson": {
      "get": {
        "tags": [
          "titik-panas"
        ],
        "summary": "Titik panas 7 hari",
        "description": "Semua tingkat kepercayaan dari satelit MODIS, Suomi NPP, dan NOAA-20.",
        "operationId": "titikPanas7Hari",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/TitikPanasGeoJSON"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/titik-panas-24jam.geojson": {
      "get": {
        "tags": [
          "titik-panas"
        ],
        "summary": "Titik panas 24 jam",
        "description": "Kepercayaan sedang dan tinggi, sesuai hitungan di situs dan pelaporan nasional.",
        "operationId": "titikPanas24Jam",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/geo+json": {
                "schema": {
                  "$ref": "#/components/schemas/TitikPanasGeoJSON"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "tags": [
          "meta"
        ],
        "summary": "Spesifikasi ini",
        "description": "Dokumen OpenAPI 3.1 untuk API ini.",
        "operationId": "spesifikasi",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    },
    "/status.json": {
      "get": {
        "tags": [
          "status"
        ],
        "summary": "Kesegaran data",
        "description": "Kapan indeks dihitung, run model cuaca yang dipakai, kapan titik panas terakhir dicek dan berubah. Pantau berkas ini (tiap 5 menit sudah cukup) daripada mengunduh ulang berkas besar.",
        "operationId": "ambilStatus",
        "responses": {
          "200": {
            "description": "Berhasil.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Last-Modified": {
                "$ref": "#/components/headers/LastModified"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/CacheControl"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimitPolicy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Status"
                }
              }
            }
          },
          "304": {
            "$ref": "#/components/responses/TidakBerubah"
          },
          "429": {
            "$ref": "#/components/responses/TerlaluBanyak"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Meta": {
        "type": "object",
        "required": [
          "versi_api",
          "diperbarui",
          "dokumentasi",
          "lisensi",
          "atribusi"
        ],
        "properties": {
          "versi_api": {
            "type": "string",
            "const": "1"
          },
          "diperbarui": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Waktu angka utama sumber daya ini dihasilkan (indeks, atau titik panas pada sumber daya titik panas), dengan zona +08:00 (WITA)."
          },
          "titik_panas_diperbarui": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Waktu hitungan titik_panas_24jam diambil. Hanya ada pada sumber daya yang memuat hitungan itu; nilainya bisa lebih baru daripada diperbarui."
          },
          "tanggal_data": {
            "type": "string",
            "format": "date",
            "description": "Tanggal (WITA) yang diwakili angka terkini."
          },
          "jumlah": {
            "type": "integer"
          },
          "dokumentasi": {
            "type": "string",
            "format": "uri"
          },
          "lisensi": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "atribusi": {
            "type": "string",
            "description": "Teks atribusi yang wajib dicantumkan saat data dipakai ulang."
          }
        }
      },
      "Kelas": {
        "type": "string",
        "enum": [
          "Rendah",
          "Sedang",
          "Tinggi",
          "Sangat Tinggi"
        ],
        "description": "Kelas kerawanan: Rendah 0–75, Sedang 76–150, Tinggi 151–225, Sangat Tinggi 226–300 (batas atas inklusif)."
      },
      "LuasPerKelas": {
        "type": "object",
        "description": "Persentase luas daratan per kelas (jumlah ≈ 100).",
        "properties": {
          "Rendah": {
            "type": "number"
          },
          "Sedang": {
            "type": "number"
          },
          "Tinggi": {
            "type": "number"
          },
          "Sangat Tinggi": {
            "type": "number"
          }
        },
        "required": [
          "Rendah",
          "Sedang",
          "Tinggi",
          "Sangat Tinggi"
        ]
      },
      "Titik": {
        "type": "object",
        "required": [
          "tanggal",
          "nilai",
          "kelas"
        ],
        "properties": {
          "tanggal": {
            "type": "string",
            "format": "date"
          },
          "nilai": {
            "type": "number",
            "minimum": 0,
            "maximum": 300,
            "description": "Angka kerawanan KBDI, 0 (jenuh) sampai 300 (kering maksimum)."
          },
          "kelas": {
            "$ref": "#/components/schemas/Kelas"
          }
        }
      },
      "Wilayah": {
        "type": "object",
        "required": [
          "id",
          "nama",
          "jenis",
          "kabupaten",
          "lokasi",
          "luas_km2",
          "nilai",
          "kelas",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string",
            "examples": [
              "khg-64-02-08-01",
              "grid-117_50-0_25"
            ]
          },
          "nama": {
            "type": "string"
          },
          "jenis": {
            "type": "string",
            "enum": [
              "khg",
              "petak"
            ],
            "description": "khg = Kesatuan Hidrologis Gambut; petak = petak grid 0,25°."
          },
          "kode_khg": {
            "type": "string",
            "description": "Hanya untuk jenis khg; kode menurut SK MenLHK 129/2017."
          },
          "fraksi_gambut": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Hanya untuk jenis petak; bagian luas petak yang berupa KHG."
          },
          "kabupaten": {
            "type": "array",
            "description": "Kab/kota yang disentuh wilayah ini, terluas lebih dahulu.",
            "items": {
              "type": "object",
              "properties": {
                "nama": {
                  "type": "string"
                },
                "luas_km2": {
                  "type": "number"
                }
              }
            }
          },
          "lokasi": {
            "type": "object",
            "description": "Titik di dalam wilayah tempat data cuaca diambil.",
            "properties": {
              "lat": {
                "type": "number"
              },
              "lon": {
                "type": "number"
              }
            }
          },
          "luas_km2": {
            "type": "number"
          },
          "nilai": {
            "type": "number",
            "minimum": 0,
            "maximum": 300,
            "description": "Angka kerawanan KBDI, 0 (jenuh) sampai 300 (kering maksimum)."
          },
          "kelas": {
            "$ref": "#/components/schemas/Kelas"
          },
          "tren": {
            "type": "string",
            "enum": [
              "naik",
              "turun",
              "stabil",
              "belum cukup data"
            ],
            "description": "Perubahan dibanding 7 hari sebelumnya (±10 poin)."
          },
          "hujan_7hari_mm": {
            "type": "number"
          },
          "suhu_maks_c": {
            "type": "number"
          },
          "hujan_tahunan_normal_mm": {
            "type": "integer",
            "description": "Normal hujan tahunan 2020–2025 (R0 dalam rumus KBDI)."
          },
          "titik_panas_24jam": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Titik panas 24 jam, kepercayaan sedang–tinggi; null bila data titik panas tidak tersedia."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "hujan_12minggu_mm_per_hari": {
            "type": [
              "number",
              "null"
            ],
            "description": "Rata-rata hujan harian 12 minggu terakhir (mm/hari). Di bawah 4 mm/hari kebakaran dan asap meningkat tajam; di atas 6 mm/hari jarang terjadi (Field dkk. 2016)."
          }
        }
      },
      "WilayahRinci": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Wilayah"
          },
          {
            "type": "object",
            "required": [
              "riwayat",
              "prakiraan"
            ],
            "properties": {
              "riwayat": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Titik"
                },
                "description": "90 hari terakhir, termasuk hari data."
              },
              "prakiraan": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Titik"
                },
                "description": "Hari-hari berikutnya dari ramalan cuaca; makin jauh makin tidak pasti."
              }
            }
          }
        ]
      },
      "Kabupaten": {
        "type": "object",
        "required": [
          "kode",
          "nama",
          "nilai_tertinggi",
          "kelas_tertinggi",
          "luas_per_kelas_pct",
          "url"
        ],
        "properties": {
          "kode": {
            "type": "string",
            "pattern": "^64\\.\\d{2}$",
            "description": "Kode wilayah Kemendagri."
          },
          "nama": {
            "type": "string"
          },
          "luas_km2": {
            "type": "number"
          },
          "nilai_tertinggi": {
            "type": "number",
            "minimum": 0,
            "maximum": 300,
            "description": "Angka kerawanan KBDI, 0 (jenuh) sampai 300 (kering maksimum)."
          },
          "kelas_tertinggi": {
            "$ref": "#/components/schemas/Kelas"
          },
          "kelas_dominan": {
            "$ref": "#/components/schemas/Kelas"
          },
          "luas_per_kelas_pct": {
            "$ref": "#/components/schemas/LuasPerKelas"
          },
          "pct_tinggi_ke_atas": {
            "type": "number",
            "description": "Persen luas pada kelas Tinggi atau Sangat Tinggi."
          },
          "titik_panas_24jam": {
            "type": [
              "integer",
              "null"
            ]
          },
          "khg": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "id KHG yang berada di kab/kota ini."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "hujan_12minggu_mm_per_hari": {
            "type": [
              "number",
              "null"
            ],
            "description": "Rata-rata hujan harian 12 minggu terakhir (mm/hari). Di bawah 4 mm/hari kebakaran dan asap meningkat tajam; di atas 6 mm/hari jarang terjadi (Field dkk. 2016)."
          }
        }
      },
      "KabupatenRinci": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Kabupaten"
          },
          {
            "type": "object",
            "properties": {
              "wilayah": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "nama": {
                      "type": "string"
                    },
                    "jenis": {
                      "type": "string",
                      "enum": [
                        "khg",
                        "petak"
                      ]
                    },
                    "nilai": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 300,
                      "description": "Angka kerawanan KBDI, 0 (jenuh) sampai 300 (kering maksimum)."
                    },
                    "kelas": {
                      "$ref": "#/components/schemas/Kelas"
                    },
                    "luas_km2_di_kabupaten": {
                      "type": "number"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "Ringkasan": {
        "type": "object",
        "properties": {
          "tanggal_data": {
            "type": "string",
            "format": "date"
          },
          "luas_per_kelas_pct": {
            "$ref": "#/components/schemas/LuasPerKelas"
          },
          "kabupaten_terawan": {
            "type": [
              "object",
              "null"
            ]
          },
          "peringatan": {
            "type": [
              "object",
              "null"
            ],
            "description": "Terisi bila ≥50% luas daratan pada kelas Sangat Tinggi selama ≥5 hari berturut-turut (Taufik dkk. 2023).",
            "properties": {
              "judul": {
                "type": "string"
              },
              "isi": {
                "type": "string"
              },
              "wilayah": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "jumlah_petak": {
            "type": "integer"
          },
          "jumlah_khg": {
            "type": "integer"
          },
          "titik_panas_24jam": {
            "type": [
              "integer",
              "null"
            ]
          },
          "batas_kelas": {
            "type": "object"
          },
          "metode": {
            "type": "object"
          },
          "hujan_12minggu_mm_per_hari": {
            "type": [
              "number",
              "null"
            ],
            "description": "Rata-rata hujan harian 12 minggu terakhir (mm/hari). Di bawah 4 mm/hari kebakaran dan asap meningkat tajam; di atas 6 mm/hari jarang terjadi (Field dkk. 2016)."
          },
          "ambang_hujan_12minggu": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "kering": {
                "type": "number"
              },
              "basah": {
                "type": "number"
              },
              "sumber": {
                "type": "string"
              }
            }
          }
        }
      },
      "TitikPanas": {
        "type": "object",
        "properties": {
          "waktu_utc": {
            "type": "string",
            "format": "date-time"
          },
          "satelit": {
            "type": "string",
            "enum": [
              "MODIS",
              "SNPP",
              "NOAA-20",
              "NOAA-21"
            ]
          },
          "kepercayaan": {
            "type": "string",
            "enum": [
              "rendah",
              "sedang",
              "tinggi"
            ]
          },
          "kabupaten_kode": {
            "type": "string"
          },
          "kabupaten": {
            "type": [
              "string",
              "null"
            ]
          },
          "wilayah_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "di_dalam_khg": {
            "type": "boolean"
          },
          "sumber_tetap": {
            "type": "boolean",
            "description": "Berada di sel sumber panas tetap (tambang batu bara, suar gas/industri) menurut arsip FIRMS type 2. Tetap ditampilkan, tetapi tidak dihitung sebagai kebakaran hutan dan lahan dan tidak masuk titik-panas-24jam."
          },
          "asal": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "SiPongi+",
              "NASA FIRMS",
              null
            ],
            "description": "Dari mana deteksi ini diambil. SiPongi+ adalah sumber utama; NASA FIRMS melengkapi deteksi yang belum diterbitkan ulang SiPongi+ dan satelit NOAA-21."
          }
        }
      },
      "Poligon": {
        "type": "object",
        "required": [
          "type",
          "coordinates"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Polygon",
              "MultiPolygon"
            ]
          },
          "coordinates": {
            "type": "array"
          }
        }
      },
      "Titik2D": {
        "type": "object",
        "required": [
          "type",
          "coordinates"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "Point"
          },
          "coordinates": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "minItems": 2,
            "maxItems": 2,
            "description": "[bujur, lintang] dalam WGS 84, sesuai RFC 7946."
          }
        }
      },
      "Galat": {
        "type": "object",
        "required": [
          "galat"
        ],
        "properties": {
          "galat": {
            "type": "object",
            "required": [
              "kode",
              "pesan"
            ],
            "properties": {
              "kode": {
                "type": "integer"
              },
              "pesan": {
                "type": "string"
              },
              "dokumentasi": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        }
      },
      "WilayahGeoJSON": {
        "type": "object",
        "required": [
          "type",
          "metadata",
          "features"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "FeatureCollection"
          },
          "metadata": {
            "$ref": "#/components/schemas/Meta"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "type",
                "id",
                "geometry",
                "properties"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "Feature"
                },
                "id": {
                  "type": "string",
                  "description": "Sama dengan properties.id."
                },
                "geometry": {
                  "$ref": "#/components/schemas/Poligon"
                },
                "properties": {
                  "$ref": "#/components/schemas/Wilayah"
                }
              }
            }
          }
        }
      },
      "KabupatenGeoJSON": {
        "type": "object",
        "required": [
          "type",
          "metadata",
          "features"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "FeatureCollection"
          },
          "metadata": {
            "$ref": "#/components/schemas/Meta"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "type",
                "id",
                "geometry",
                "properties"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "Feature"
                },
                "id": {
                  "type": "string",
                  "description": "Sama dengan properties.kode."
                },
                "geometry": {
                  "$ref": "#/components/schemas/Poligon"
                },
                "properties": {
                  "$ref": "#/components/schemas/Kabupaten"
                }
              }
            }
          }
        }
      },
      "TitikPanasGeoJSON": {
        "type": "object",
        "required": [
          "type",
          "metadata",
          "features"
        ],
        "properties": {
          "type": {
            "type": "string",
            "const": "FeatureCollection"
          },
          "metadata": {
            "$ref": "#/components/schemas/Meta"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "type",
                "id",
                "geometry",
                "properties"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "Feature"
                },
                "id": {
                  "type": "string",
                  "description": "Stabil antar-pembaruan; pakai untuk membuang duplikat."
                },
                "geometry": {
                  "$ref": "#/components/schemas/Titik2D"
                },
                "properties": {
                  "$ref": "#/components/schemas/TitikPanas"
                }
              }
            }
          }
        }
      },
      "Status": {
        "type": "object",
        "description": "Kesegaran setiap jenis data. Ditulis ulang pada setiap pengecekan (tiap 10 menit), jadi berkas kecil ini yang sebaiknya dipantau; unduh berkas besar hanya bila waktunya berubah.",
        "required": [
          "dibuat"
        ],
        "properties": {
          "dibuat": {
            "type": "string",
            "description": "Waktu WITA (+08:00), presisi menit."
          },
          "indeks": {
            "type": "object",
            "properties": {
              "dihitung": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Kapan indeks terakhir dihitung (WITA)."
              },
              "tanggal_data": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date",
                "description": "Hari yang diwakili angka terkini; hari berjalan bersifat sementara."
              },
              "model": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "jalan_model_utc": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Waktu mulai run model cuaca yang dipakai (UTC)."
              },
              "model_tersedia": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Kapan run model itu terbit di Open-Meteo (WITA)."
              },
              "galat": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Pesan kegagalan terakhir; null bila pengecekan terakhir berhasil."
              },
              "gagal_pada": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Waktu WITA (+08:00), presisi menit."
              }
            }
          },
          "titik_panas": {
            "type": "object",
            "properties": {
              "diperiksa": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Pengecekan sumber titik panas terakhir (WITA)."
              },
              "berubah": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Terakhir kali ada deteksi baru (WITA)."
              },
              "sumber": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "deteksi_terbaru": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Waktu deteksi satelit terbaru (UTC); jendela 24 jam berakhir di sini."
              },
              "galat": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Pesan kegagalan terakhir; null bila pengecekan terakhir berhasil."
              },
              "firms_dicoba": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Waktu WITA (+08:00), presisi menit."
              }
            }
          }
        }
      }
    },
    "headers": {
      "ETag": {
        "description": "Penanda versi berkas; kirim kembali lewat If-None-Match.",
        "schema": {
          "type": "string"
        }
      },
      "LastModified": {
        "description": "Waktu berkas terakhir ditulis.",
        "schema": {
          "type": "string"
        }
      },
      "CacheControl": {
        "description": "public, max-age=300, must-revalidate",
        "schema": {
          "type": "string"
        }
      },
      "RateLimitPolicy": {
        "description": "Kebijakan batas laju (draf IETF RateLimit headers): 60 permintaan per 60 detik.",
        "schema": {
          "type": "string",
          "example": "\"api\";q=60;w=60"
        }
      },
      "RetryAfter": {
        "description": "Detik yang perlu ditunggu sebelum mencoba lagi.",
        "schema": {
          "type": "integer"
        }
      }
    },
    "responses": {
      "TidakBerubah": {
        "description": "Berkas tidak berubah sejak ETag yang dikirim; tanpa badan."
      },
      "TidakDitemukan": {
        "description": "Sumber daya tidak ada.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Galat"
            }
          }
        }
      },
      "TerlaluBanyak": {
        "description": "Batas laju terlampaui.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/RetryAfter"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Galat"
            }
          }
        }
      }
    }
  }
}
