[ 佐賀イベントスペース Saga Event Space ](/) [ イベント施設 ](/facilities) [ ホテル ](/hotels) [ 懇親会会場 ](/venues) テーマを切り替え JA 言語を切り替え [ 登録/ログイン ](/auth/login) メニューを開く [ イベント施設 ](/facilities) [ ホテル ](/hotels) [ 懇親会会場 ](/venues) [ 登録/ログイン ](/auth/login) REST API v1 # API リファレンス REST API の詳細仕様 ## 目次 [クイックアクセス ](#quick-access) [認証方法 ](#authentication) [エンドポイント一覧 ](#endpoints) [使用例 ](#examples) [レート制限 ](#rate-limit) ## クイックアクセス [ Swagger UI インタラクティブなAPI仕様書 ](/api/v1/docs) [ OpenAPI JSON OpenAPI 3.0仕様書 ](/api/v1/openapi.json) ## 認証方法 APIへのアクセスには Personal Access Token (PAT) を使用します。トークンは Authorization ヘッダーに Bearer トークンとして設定してください。 HTTP Header ``` Authorization: Bearer your_token_here ``` 重要 全てのAPIエンドポイントで認証が必須です。未認証のリクエストは401エラーを返却します。 ## エンドポイント一覧 | メソッド | パス | 説明 | 認証 | | ------ | ------------------------------ | ------------ | -- | | GET | /api/v1/search | 会場を検索 | 必要 | | GET | /api/v1/places/{id} | 会場詳細を取得 | 必要 | | POST | /api/v1/places | 会場を登録 | 必要 | | PATCH | /api/v1/places/{id} | 会場を更新 | 必要 | | DELETE | /api/v1/places/{id} | 会場を削除 | 必要 | | POST | /api/v1/address/normalize | 住所を正規化 | 必要 | | POST | /api/v1/geocoding/forward | 住所から座標を取得 | 必要 | | POST | /api/v1/geocoding/reverse | 座標から住所を取得 | 必要 | | GET | /api/v1/duplicates | 重複候補一覧を取得 | 必要 | | POST | /api/v1/duplicates/merge | 重複会場をマージ | 必要 | | GET | /api/v1/tokens | トークン一覧を取得 | 必要 | | POST | /api/v1/tokens | トークンを発行 | 必要 | | DELETE | /api/v1/tokens/{id} | トークンを削除 | 必要 | | POST | /api/v1/uploads/photos | 写真をアップロード | 必要 | | GET | /api/v1/announcements | お知らせ一覧を取得 | 必要 | | GET | /api/v1/release-notes | リリースノート一覧を取得 | 必要 | | GET | /api/v1/audit-logs | 監査ログを取得 | 必要 | | GET | /api/v1/audit-logs/stats | 統計情報を取得 | 必要 | | GET | /api/v1/users | ユーザー一覧を取得 | 必要 | | PATCH | /api/v1/users/{id}/role | ユーザーロールを変更 | 必要 | | GET | /api/v1/deletion-requests | 削除申請一覧を取得 | 必要 | | POST | /api/v1/deletion-requests | 削除申請を作成 | 必要 | | PATCH | /api/v1/deletion-requests/{id} | 削除申請を承認/却下 | 必要 | ## 使用例 ### 会場を検索（認証必須） GET cURL ``` curl -X GET "https://saga-event-space.midnight480.com/api/v1/search?q=佐賀&type=facility&limit=10" \ -H "Authorization: Bearer your_token_here" ``` Response ``` { "data": [ { "id": "uuid-here", "name": "佐賀市文化会館", "category": "facility", "address": "佐賀県佐賀市...", "capacity_seated": 500 } ], "meta": { "total": 15, "page": 1, "limit": 10 } } ``` ### 会場を登録（認証必要） POST cURL ``` curl -X POST "https://saga-event-space.midnight480.com/api/v1/places" \ -H "Authorization: Bearer your_token_here" \ -H "Content-Type: application/json" \ -d '{ "name": "新しい会場", "category": "facility", "address": "佐賀県佐賀市...", "capacity_seated": 100 }' ``` ## レート制限 APIには以下のレート制限が適用されます： 50 リクエスト / 分 / トークン 429 制限超過時のHTTPステータス Response Headers ``` X-RateLimit-Limit: 50 X-RateLimit-Remaining: 45 X-RateLimit-Reset: 1704067200 Retry-After: 30 ``` [ 佐賀イベントスペース Saga Event Space ](/) 佐賀県内のITコミュニティ支援で利用可能なイベントスペース・ホテル・懇親会会場の情報を集約・公開するシステム ### カテゴリ * [イベント施設 ](/facilities) * [ホテル ](/hotels) * [懇親会会場 ](/venues) ### 情報 * [ 佐賀県産業スマート化センター ](https://www.saga-smart.jp/community/) * [ Cross SAGA ](https://cross-saga.jp/) * [活動のヒント ](/docs/activity-tips) * [このサイトについて ](/about) * [API ドキュメント ](/docs/api) * [MCP ガイド ](/docs/mcp) * [リリースノート ](/release-notes) * [使い方ガイド ](/docs/guide) * [利用規約 ](/docs/terms) * [プライバシーポリシー ](/docs/privacy) * [免責事項 ](/docs/disclaimer) ### お問い合わせ * [ お問い合わせ ](/contact) © 2025 佐賀スマートコミュニティ有志 ※記載されている会社名、製品名、サービス名は各社の登録商標または商標です。 ## Cookieの使用について 本サイトでは、サービスの提供・改善のためにCookieを使用しています。 [詳しく見る ](/docs/privacy) 必須のみ許可 カスタマイズ すべて許可 ### カスタマイズ #### 必須Cookie 必須 サイトの基本機能に必要なCookieです。セッション管理、セキュリティ、言語設定などに使用されます。これらは無効にできません。 必須Cookie #### 分析Cookie サイトの利用状況を分析し、サービス改善に役立てるためのCookieです。Google Analyticsなどで使用されます。 分析Cookie #### 機能Cookie ユーザー体験を向上させるための追加機能に使用されるCookieです。 機能Cookie 設定を保存