External API

WEMS Knowledge Crawler API 教學

所有端點都回傳一致 JSON envelope。會員登入、登出、加入會員、修改會員與權限查詢不在本專案處理，請使用集中會員 API。

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

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

集中會員 API 對接

GET

/api/v1/member/integration

取得本專案的集中會員 API 對接資訊，包含 loginapi.sun-bd.com 端點、回傳網址、必要權限與已停用的本機會員操作。

POST

/api/v1/member/callback/simulate

模擬集中登入完成後回到本專案的資料處理方式。敏感 token 類欄位會被列為拒收，不會建立本機會員或本機 session。

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

curl -X POST https://knowledge.sun-bd.com/api/v1/member/callback/simulate \
  -H "Content-Type: application/json" \
  -d "{\"state\":\"demo\",\"returnedFields\":{\"memberId\":\"demo-001\",\"loginId\":\"demo.user\",\"companyId\":\"co-prod\"}}"

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

快速測試

建議先確認 health、sources、member integration，再測 simulate 端點。

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}"