> ## Documentation Index
> Fetch the complete documentation index at: https://data.kushiro.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# k-Data

> 釧路市の公開情報を収集・整形して公開する preview API の概要。

`k-Data` は、釧路市が公開しているデータを継続的に収集し、公開向けに整形した read-only API です。
人口、公共施設、AED、避難場所、観光、財政、議会、産業などのデータを、数値データと施設・地点系データの 2 系統で公開します。

<Warning>
  この API / WebUI は preview service です。仕様、URL、レスポンス形式、公開データの範囲は予告なく変更される可能性があります。
</Warning>

## Base URL

```text theme={null}
https://data.kushiro.app
```

## 主なエンドポイント

| Endpoint                        | 用途                             |
| ------------------------------- | ------------------------------ |
| `GET /api/v1`                   | service metadata と endpoint 一覧 |
| `GET /api/v1/health`            | health check                   |
| `GET /api/v1/sources`           | 公開中の source 一覧                 |
| `GET /api/v1/sources/{id}`      | source ごとの件数・最新取得時刻・metric 内訳  |
| `GET /api/v1/metrics`           | 人口・観光客数などの数値データ                |
| `GET /api/v1/metrics/aggregate` | 数値データの facet 集計（町別・期間別ランキング等）  |
| `GET /api/v1/points`            | 施設・AED・避難場所などの施設・地点系データ        |
| `GET /api/v1/points/facets`     | 施設・地点系データの facet 集計            |
| `GET /api/v1/points/near`       | 中心座標から半径内の地点を距離順で検索            |
| `GET /api/terms`                | 利用規約・出典表記・注意事項                 |

## 認証と利用制限

現時点では認証は不要です。すべての JSON API は public / read-only として公開されています。
短時間の高頻度アクセスは避けてください。将来的に rate limit を導入する可能性があります。

## 出典追跡

各データには以下の出典追跡用フィールドが含まれます。

* `raw_blob_key`: 取得した原本を識別するキー
* `fetched_at`: 原本を取得した日時

重要な意思決定に使う場合は、API の値だけでなく一次出典である釧路市公式サイトの原本も確認してください。

## ライセンスと問い合わせ

利用条件は [`GET /api/terms`](https://data.kushiro.app/api/terms) を確認してください。
本 API は釧路市公式サービスではなく、市の公開データを再公開するボランタリな preview project です。
問い合わせは X の [`@riaf`](https://x.com/riaf) までお願いします。