API ドキュメント
PolicyDiffのRESTful APIを使って、政策データにプログラムからアクセスできます。 すべてのエンドポイントはCORS対応済みです。
ベースURL
http://localhost:3002/apiGET
/api/policies政策一覧を取得
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
party | string | 政党名でフィルタ |
category | string | カテゴリでフィルタ |
status | string | ステータスでフィルタ (DRAFT|PUBLISHED|ARCHIVED) |
page | number | ページ番号 (default: 1) |
limit | number | 1ページあたりの件数 (default: 20, max: 100) |
GET
/api/policies/:id政策詳細を取得(政党情報・変更提案を含む)
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
id | string | 政策ID (path parameter) |
GET
/api/parties政党一覧を取得(各カテゴリの政策件数付き)
GET
/api/compare政策比較(同カテゴリの複数政党の政策を取得)
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
category | string | カテゴリ名 (required) |
parties | string | 政党名のカンマ区切り |
GET
/api/proposals政策変更提案一覧を取得
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
status | string | ステータスでフィルタ (OPEN|UNDER_REVIEW|ACCEPTED|REJECTED|WITHDRAWN) |
page | number | ページ番号 |
limit | number | 1ページあたりの件数 |
GET
/api/categoriesカテゴリ一覧を取得(各カテゴリの政策件数付き)
レスポンス形式
ページネーション付きのエンドポイントは以下の形式でレスポンスを返します。
{
"data": [...],
"pagination": {
"page": 1,
"limit": 20,
"total": 100,
"totalPages": 5
}
}