API 與 Webhook 文件

企業版功能（企業版目前尚未開放訂購）。資料來源：經濟部商工登記公示資料，官方公布後才整理（通常有 1～2 天延遲）；只複述官方登記紀錄，不評分、不預測。

驗證

在帳號頁（企業版擁有者）建立 API 金鑰，格式是 ent_live_…，只會顯示一次，我們只保存雜湊；弄丟只能撤銷重建，每位擁有者最多 5 把有效金鑰。每個請求帶：

Authorization: Bearer ent_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

金鑰只能從你的伺服器端使用（不要放進網頁或手機 App）；API 不提供 CORS。

額度

• 每把金鑰每天 1,000 次請求（含錯誤請求；台灣時間 0 點重新計算），回應帶 X-RateLimit-Limit、X-RateLimit-Remaining。
• 會向官方即時查詢的請求（公司快照超過 24 小時）每把金鑰每天另限 100 次。

端點（唯讀）

GET /api/v1/company?taxId=12345678

公司或商號的基本資料（登記狀態、負責人、資本額、地址、設立日期、董監事…）。

curl -H "Authorization: Bearer $KEY" "https://enterprise-radar.com/api/v1/company?taxId=12345678"

GET /api/v1/events?taxId=12345678&days=90

這家公司本站有紀錄的事件（登記異動、解散、停業、歇業、新成立），新到舊，最多 100 筆；days 預設 90、最多 365。登記異動只有被人追蹤中的公司才比對，沒有紀錄不等於沒有變動。

GET /api/v1/watchlist

你的團隊共享的追蹤清單（最多 300 筆）：統編、名稱、登記狀態、分組、備註。

回應格式

{ "data": …, "meta": { "source": "經濟部商工登記公示資料…", … } }
{ "error": { "code": "rate_limited", "message": "…" } }

錯誤碼：invalid_key（401）、plan_inactive（403，方案已失效）、bad_request（400）、not_found（404）、rate_limited（429）、upstream_limited（429）、upstream_unavailable（503）、server_error（500）。

Webhook

你追蹤的公司有新的登記事件（異動、解散、停業、歇業）時，我們對你設定的網址送一個 POST（JSON）。一個團隊最多 3 個網址，在帳號頁設定；簽章密鑰 whsec_… 同樣只顯示一次。

{ "id": "…", "type": "company.events", "created": "2026-10-13T04:00:00.000Z",
  "events": [ { "id": "…", "type": "dissolved", "taxId": "12345678", "name": "…", "date": "2026-10-08", … } ] }

每次最多 100 筆事件；type 為 test 的是你按「測試」送的空事件。

驗證簽章

標頭 X-ER-Timestamp（秒）與 X-ER-Signature: v1=…。簽章是 HMAC-SHA256(密鑰, 時間戳 + "." + 原始 body) 的十六進位。請用原始 body 驗證，並確認時間戳在 5 分鐘內（防重放）：

const crypto = require('crypto')
function verify(secret, ts, rawBody, header) {
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false
  const mine = 'v1=' + crypto.createHmac('sha256', secret).update(ts + '.' + rawBody).digest('hex')
  return header.length === mine.length && crypto.timingSafeEqual(Buffer.from(header), Buffer.from(mine))
}

送達規則

• 回 2xx 才算成功；失敗最多共試 3 次（間隔約 1 秒、3 秒）；不跟隨轉址；逾時 5 秒。
• 連續 10 次整批投遞失敗會自動停用，在帳號頁按「測試」成功就會重新啟用。
• 投遞是盡力而為：重試仍失敗的事件不會再補送。請用 id 去重，並用 /api/v1/events 補查。
• 網址必須是 https:// 的公開網域、使用預設 443 埠；不接受 IP 位址、內部名稱，也不連到解析結果是私有或保留位址的網域。

服務範圍

資料有 1～2 天的官方延遲；本站只整理官方登記紀錄，不構成信用、投資或法律意見。API 與 Webhook 的規格若有調整會在本頁更新。問題請寄 service@enterprise-radar.com。