Skip to main content

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 は、釧路市が公開しているデータを継続的に収集し、公開向けに整形した read-only API です。 人口、公共施設、AED、避難場所、観光、財政、議会、産業などのデータを、数値データと施設・地点系データの 2 系統で公開します。
この API / WebUI は preview service です。仕様、URL、レスポンス形式、公開データの範囲は予告なく変更される可能性があります。

Base URL

https://data.kushiro.app

主なエンドポイント

Endpoint用途
GET /api/v1service metadata と endpoint 一覧
GET /api/v1/healthhealth check
GET /api/v1/sources公開中の source 一覧
GET /api/v1/sources/{id}source ごとの件数・最新取得時刻
GET /api/v1/metrics人口・観光客数などの数値データ
GET /api/v1/points施設・AED・避難場所などの施設・地点系データ
GET /api/terms利用規約・出典表記・注意事項

認証と利用制限

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

出典追跡

各データには以下の出典追跡用フィールドが含まれます。
  • raw_blob_key: 取得した原本を識別するキー
  • fetched_at: 原本を取得した日時
重要な意思決定に使う場合は、API の値だけでなく一次出典である釧路市公式サイトの原本も確認してください。

ライセンスと問い合わせ

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