# パソコンサポート ピシコ（Picico）オンライン予約

苫小牧市のパソコン・iPhone 修理店。予約は仮予約制で、店主が内容を確認したのち確定の連絡をします。

## AI エージェント向け予約 API
- 空き状況の照会、仮予約の作成、状態照会ができます。状態照会は POST /api/v1/reservations/{id}/status（本文に phone）を使ってください。電話番号を URL に入れる旧形式（GET）は非推奨です。
- OpenAPI 定義: https://yoyaku.picico.net/api/v1/openapi.json
- まず GET /api/v1/services でコースごとの必須項目と選択肢（メーカー・症状など）を取得してください。
- 予約前に POST /api/v1/reservations?dry_run=true で検証だけ試せます（予約は作成されません）。
- 直接 API で予約できるのは店舗持ち込み（service=store）のみです。出張修理をご希望のお客様には、お電話か予約フォーム（https://yoyaku.picico.net/）をご案内してください。
- iPhone は「初期化・各種検査」のみ直接 API で受け付けます。「液晶パネル・バッテリー交換・水没洗浄修理」は部品の在庫確認が必要なため、お電話か予約フォームをご案内してください。
- 下の記入済みリンクなら、直接 API で受け付けない内容（出張修理・iPhone の上記の修理など）でもフォームを入力済みで開けます（送信はお客様ご本人で、内容は店主が確認します）。
- 予約は仮予約として受け付けます。確定は店主の確認後です。お客様にはその旨を必ず伝えてください。
- 利用規約: https://yoyaku.picico.net/terms 。お客様本人が同意した場合にのみ terms_agreed: true を送ってください。
- お客様本人の指示と同意がある場合にのみ予約を作成してください。

### チャットだけのエージェント（API を呼べない・ブラウザを操作できない）向け: 記入済みリンク
- **API を呼ぶ必要はありません。** 次の形の URL を組み立ててお客様に渡すだけで、リンクを開いた予約フォームが入力済みになります（日本語は URL エンコードしてください）。
  https://yoyaku.picico.net/?course=store&date=2026-11-10&time=10:00&device=pc&maker=HP&symptoms=起動しない&note=昨夜から電源が入りません
- お客様はリンクを開き、お名前・電話・メールを入れて規約に同意し、送信するだけで仮予約になります。
- **お名前・電話番号・メール・住所は、エージェントが聞き取らないでください。** URL にも入れないでください（入れても無視されます）。リンクを開いたお客様ご本人が入力します。
- 日時が決まっていなければ time を省略してください（date だけでも構いません。お客様が選びます）。予約を受け付けている時間帯は 10:00〜19:00（30 分刻み、現在から 3 時間後以降）です。店舗の営業時間とは異なります。空いている枠は GET /api/v1/availability で確認できます。
- ブラウザを操作できるエージェントも、このリンクから開くと、残りの入力はお名前・連絡先・規約の同意だけになります。
- API を呼べるエージェント向けの任意の事前確認: 同じクエリで GET https://yoyaku.picico.net/api/v1/prefill を呼ぶと、マスタに照らして正規化し、枠の空きを確認して、渡すべき link を返します（予約は作成されません）。slot_ok が false なら alternatives に代わりの枠が入ります。
- **パラメータはすべて任意です。分からないものは省略してください**（省略しても、名前が少し違っても、予約フォームは開きます）。よく使われる別名も受け付けます（service・manufacturer・symptom・contact_preference・start など。日付は 2026/11/10、時刻は 10:00:00 の形でも可）。
- パラメータの一覧:
  - course: store（店舗持ち込み）/ onsite（出張修理）
  - date: YYYY-MM-DD ／ time: HH:MM（30 分刻み）
  - device: pc / iphone（store のみ。onsite は PC 固定）
  - maker: PC メーカー名（HP・Lenovo・NEC など）または ID ／ model: 型番（100 字まで）
  - pc_type: notebook / desktop / storage
  - symptoms: 症状名のカンマ区切り（例 起動しない,画面が映らない）
  - request_types: データ復旧,データ移行,初期設定 のカンマ区切り
  - iphone_model: iPhone 機種名または ID ／ iphone_repair: 液晶パネル / バッテリー交換 / 初期化 / 水没洗浄修理 / 各種検査
  - note: 相談内容（400 字まで）
  - goal: repair / data_only / replacement / estimate_first ／ threshold: 5000 / 10000 / 20000 / 30000
  - visit: first / returning / same_device
  - contact: phone / email / line（希望の連絡方法。電話番号・メールアドレス自体は入れない）

## 人間向け予約ページ
- https://yoyaku.picico.net/