External API

WEMS Knowledge Crawler API 教學

所有端點都回傳一致 JSON envelope。會員頁面、登入、登出、加入會員、修改會員、付款頁與點數頁不在本專案處理；請跳轉到會員系統或 Payment Points System。

Base URL: https://knowledge.sun-bd.com
Response envelope:
{
  "success": true,
  "traceId": "...",
  "data": { }
}

知識爬蟲 API

GET

/api/v1/health

取得服務健康狀態、版本、公開 base URL 與 live crawl 是否啟用。

GET

/api/v1/sources

取得目前監控的知識來源清單、關鍵字與受影響文件。

GET

/api/v1/status

取得來源數、報告目錄、最新報告與待處理更新狀態。

GET

/api/v1/reports/latest

取得最新 crawl 報告；沒有報告時回傳 404 envelope。

GET

/api/v1/pending

取得 PENDING_UPDATE 狀態；沒有待處理更新時回傳 hasPendingUpdate: false。

POST

/api/v1/crawl/simulate

安全離線模擬，適合外部系統先驗證整合格式；不抓取外部網站、不寫報告。

外部會員與付款跳轉

GET

/api/v1/member/integration

取得外部會員系統、回到本專案的 URL、Payment Points 頁面與 API 教學資訊。本專案不提供會員頁、callback 頁、付款頁或點數頁。

curl https://knowledge.sun-bd.com/api/v1/member/integration

集中會員 API 教學頁：https://loginapi.sun-bd.com/docs/integration/member-login-logout.html

Payment Points 教學頁：https://pay.sun-bd.com/docs/payment-points-api.html

快速測試

建議先確認 health、sources、member integration，再測 crawler simulate 端點。會員與付款 UI 不在本專案測試。

curl https://knowledge.sun-bd.com/api/v1/health

curl https://knowledge.sun-bd.com/api/v1/sources

curl https://knowledge.sun-bd.com/api/v1/member/integration

curl -X POST https://knowledge.sun-bd.com/api/v1/crawl/simulate \
  -H "Content-Type: application/json" \
  -d "{\"scenario\":\"partner-check\",\"sourceLimit\":3}"