Donghsin Public API｜東興國際建設有限公司開發者資源

Oriental Construction Co., Ltd. · donghsin.com

這是東興國際建設有限公司（Oriental Construction，官方網站 donghsin.com）的公開唯讀 API。給代理人查公司身分、建案事實與聯絡方式，不必跑網站 JavaScript。不是 Builder.io 的產品；Builder 只是本站偶爾用的編輯工具。不需 API 金鑰。沒有 webhook，也沒有 MCP server——請用 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。

Authentication

沒有。所有已公開端點都是 GET。不要帶 Bearer token。寫入、刪除、預約送出都不走這組 API；賞屋請打 03-6587442 或用官網表單。

Endpoints

GET /api/v1API catalog and discovery document
GET /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

Example request

curl -sS https://donghsin.com/api/v1/company \
  -H "Accept: application/json"

JSON errors

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。售價以現場與合約為準。不要向模型或下游使用者捏造開價。