# しおりん

> 旅行スケジュールを作成・共有できるWebアプリ。会員登録不要、URLを共有するだけ。

## 注意事項

作成されたしおりは公開URLで誰でも閲覧可能です。個人情報・機密情報（メールアドレス、電話番号、クレジットカード番号等）は絶対に含めないでください。

## API概要

REST APIでしおりの取得・更新ができます。しおりの作成・削除はWebから人が行います。

- ベースURL: https://shiolin.net
- 認証: Bearer トークン（パスワード認証で取得）
- 詳細仕様: /openapi.yaml

## エンドポイント

- GET /api/v1/trips/:id — しおり取得（認証不要）
- PUT /api/v1/trips/:id — しおり更新（要Bearer トークン）
- POST /api/v1/auth — パスワード認証でトークン取得

## 既存のしおりをAPIで編集する

Webで作成済みのしおりを、途中からAPIで引き継いで編集できます。

1. GET /api/v1/trips/:id で現在の内容を取得する（認証不要）
2. POST /api/v1/auth に trip_id と password を送ってトークンを取得する
3. PUT /api/v1/trips/:id にトークンを付けてスケジュールを更新する

```
# 1. 現在の内容を確認
GET /api/v1/trips/{trip_id}

# 2. トークンを取得
POST /api/v1/auth
{"trip_id": "{trip_id}", "password": "{password}"}
→ {"token": "..."}

# 3. スケジュールを更新
PUT /api/v1/trips/{trip_id}
Authorization: Bearer {token}
{"title": "...", "schedules": [...]}
```

## JSONフォーマット

しおり更新時のリクエスト例:

```json
{
  "title": "京都旅行 2026",
  "schedules": [
    {
      "date": "2026-03-20",
      "start_time": "10:00",
      "end_time": "12:30",
      "icon": "🚅",
      "title": "東京駅 → 京都駅",
      "location": "東海道新幹線",
      "memo": "のぞみ指定席"
    }
  ]
}
```

- date: 必須 (YYYY-MM-DD)
- title: 必須 (最大200文字)
- icon: 任意 (絵文字1文字)
- start_time, end_time: 任意 (HH:MM)
- location: 任意 (最大200文字、Google Maps検索に使用するため施設名や住所の正式名称を入力)
- memo: 任意 (最大1000文字)