bim.house · API Index · human + robot

API エンドポイント一覧

すべての /api/* エンドポイントは content negotiation 対応:
browser (Accept: text/html) → 人間向け HTML 表 or 専用 page
robot / curl / fetch (Accept: */*) → raw JSON
強制 JSON は ?format=json でも可
methodpath説明詳細
GET /api/spec.json OpenAPI 3.1 仕様 (自動生成) tool_defs から生成。openapi-generator で任意言語のクライアント生成可
POST /api/tool/:name MCP ツールを REST で実行 body=引数JSON。例 /api/tool/houki_check {"slug":"..."}。Bearer 認証
POST /mcp MCP (JSON-RPC 2.0) initialize・tools/list・tools/call。9 ツール (whoami/search_catalog/get_product/list_houses/get_house_bim/houki_check/material_quote/create_house/set_visibility)。使い方は /docs/mcp。書込は edit_token、whoami は Authorization: Bearer 任意
GET /login メールでログイン / 登録 パスワードレス magic link (登録兼用)
GET /console API コンソール (要ログイン) ブラウザから MCP ツールを実行 + APIキー表示
POST /api/account/key APIキー発行/取得 (要ログイン) メール認証後に bk_ キーを取得 → MCP/API 認証に使用
GET /scorecard 進化スコアカード 全物件の5軸評価 (安/機/美/環/楽) + 法規/構造判定 + 改善案
GET /api/houki/check/:slug 法規チェック JSON 建ぺい/容積/道路・北側斜線(天空率代替)/採光/換気/省エネUA
GET /json/:slug bim.json 取得 物件 BIM (project + elements)
GET /api/projects BIM 物件一覧 13 物件 (famous-*) を DB から返却
GET /api/projects/:slug/elements BIM 要素 取得 物件の elements (DB)
GET /api/projects/:slug/versions 変更ログ (版履歴) 一覧 保存ごとの append-only スナップショット。HTML は /property/:slug/changelog
GET /api/projects/:slug/diff/:from/:to 2 版の要素差分 added/removed/changed (フィールド単位 from/to)
GET /api/material/catalog?slug= 材料 SKU 一覧 55 SKU (KUNTAN/Cor-Ten/家具/設備/etc)
POST /api/material/catalog SKU upsert 新規追加 or 価格・supplier 更新
DELETE /api/material/catalog/:sku SKU 削除
GET /api/material/quote/:slug 見積実行 + DB 保存 BIM 要素 → 数量計算 → 税込総額
GET /api/material/quotes?slug= quote 履歴 過去 50 件
GET /api/material/rfq/:slug_or_quote/:supplier RFQ 生成 + DB 保存 正式見積依頼 email draft
GET /api/material/rfqs?quote_id= RFQ 一覧 status filter 可
POST /api/material/rfq/:rfq_id/status RFQ status 更新 draft/sent/responded/ordered/cancelled
POST /api/bim/validate JSON Schema 検証 errors + warnings 返却
POST /api/bim/repair JSON 自動修復 spec_version 補完 / 必須 field default / 重複 id rename
POST /api/image/photoreal-from-viewer Photoreal 生成 現在 3D view + 物件 spec → Gemini nanobanana
POST /api/signers Signer 登録 Ed25519 pubkey + role
GET /api/signers?role= Signer 一覧
POST /api/signatures 署名提出 + Ed25519 検証 valid のみ verified 保存
GET /api/signatures?slug= 署名一覧 browser → /trust/:slug にリダイレクト
GET /property/:slug 物件ダッシュボード (HTML) 8 SVG + cost + RFQ status
GET /trust/:slug Trust chain 公開 page 100 年後にも 再検証可
GET /viewer/:slug 3D Viewer Three.js + tools + AI
GET /permit/:slug 確認申請副本 PDF A3 印刷で 21 書類 化
# ロボット (curl) 例: 嶺 MINE の見積実行
curl http://127.0.0.1:3911/api/material/quote/famous-mine-kumaushi

# 人間 (browser) 例: 同じ URL を 開くと HTML table 表示
open http://127.0.0.1:3911/api/material/quote/famous-mine-kumaushi

# Trust chain 公開検証
http://127.0.0.1:3911/trust/famous-mine-kumaushi

# SKU 追加 (POST)
curl -X POST http://127.0.0.1:3911/api/material/catalog -H "Content-Type: application/json" \
  -d '{"sku":"NEW-SKU","project_slug":"famous-mine-kumaushi","name":"テスト","unit":"個","unit_price_jpy":1000}'
関連 page:
/property/famous-mine-kumaushi — 物件ダッシュボード (8 SVG + cost + RFQ)
/trust/famous-mine-kumaushi — Trust chain 公開検証
/viewer/famous-mine-kumaushi — 3D viewer
/api/projects — 全 BIM 物件 (browser: HTML / curl: JSON)
build r1.bdc37e6 · bim.house · 株式会社イネブラ · auto-generated