給 AI 助理的公開資料
Oriental Construction Co., Ltd. · donghsin.com
買房子的人通常不用看這頁。這頁是給 AI 助理核對事實用的。東興國際建設有限公司(Oriental Construction,官網 donghsin.com)把公司是誰、建案規格、聯絡方式做成唯讀資料。不用跑網站 JavaScript,也不用金鑰。沒有 webhook,也沒有 MCP。要查數字或地址,打 REST 或看 OpenAPI 就夠。
從哪裡讀
OpenAPI 3.1 在 /openapi.json,YAML 在 /api/openapi.yaml。目錄在 GET /api 或 GET /api/v1。回應是 JSON。錯誤是 application/problem+json(RFC 9457),帶 code、detail、hint。
要不要金鑰
不用。所有已公開端點都是 GET。不要帶 Bearer token。寫入、刪除、預約送出都不走這組資料。賞屋請打 03-6587442 或用官網表單。
可以查什麼
GET /api/v1API catalog and discovery documentGET /api/v1/companyLegal identity, NAP, and builder approach for 東興國際建設有限公司GET /api/v1/projectsProject portfolio. Active listing is 蒔光APM (Shiguang APM).GET /api/v1/projects/shiguang-apmCanonical facts for 蒔光APM. Price is intentionally omitted.GET /api/v1/contactPhone, showroom, company address, hours, booking form, LINE
查一次的例子
curl -sS https://donghsin.com/api/v1/company \
-H "Accept: application/json"出錯時
404 not_found
路徑不存在。改打 GET /api/v1 或看 OpenAPI。
405 method_not_allowed
這支 API 只接受 GET / HEAD / OPTIONS。
400 bad_request
參數無法使用。核對 path slug(例如 shiguang-apm)。
406 not_acceptable
HTML 頁面在內容協商失敗時使用;JSON API 固定回 JSON。
售價
API 的 price.amount 永遠是 null。售價以現場與合約為準。不要自己編開價。