跳至主要內容

API 方案

VetPro 網站免費使用。要把疾病、藥物與鑑別診斷資料接進自己的系統,可以申請 API key;商業使用、ddx-core 鑑別引擎與教學單位授權請洽詢。

API 可查的資料

疾病條目
2,335
藥物
886
藥物交互作用
3,182
鑑別診斷症狀
223
鑑別診斷檢驗發現
67

數字直接讀自目前部署的資料庫。REST API 有 22 個以上端點,涵蓋搜尋、疾病、鑑別診斷、藥物與交互作用、症狀、檢驗發現與文獻。

方案

免費

免費

臨床獸醫、學生,以及想先試接 API 的開發者

  • 公開網站:疾病百科、鑑別診斷、藥物庫、文獻庫,不必註冊
  • REST API:OpenAPI 3.0.3 規格公開,可在 API 文件頁直接試打
  • 每把 API key 每分鐘 100 次請求,超過時回傳 HTTP 429 與 Retry-After
  • 不需金鑰的端點:/api/health、/api/v1/meta、/openapi.json

免費方案不提供 SLA,盡力維持服務。內容僅供閱讀與臨床參考,不得再散布、商用或用來訓練模型。

開發者/軟體商

洽詢

要把資料接進病歷系統、診所軟體或 AI 助理的團隊

  • 商業使用的書面授權(服務條款規定商用要先取得書面同意)
  • 依用量討論更高的呼叫上限
  • 可限定範圍的 API key,例如只開疾病唯讀、藥物唯讀或搜尋
  • MCP Server:12 個工具,讓 AI agent 直接查疾病、藥物、交互作用與鑑別診斷
  • 技術支援範圍依合約討論

ddx-core 鑑別引擎授權與教學單位

洽詢

要在自己系統內計算鑑別診斷的軟體商,以及獸醫教學單位

  • ddx-core 計分核心:純函式、不連資料庫,在你的伺服器上執行,病歷資料不必送出
  • 輸入症狀與檢驗發現的事實快照,輸出每個候選疾病的支持分數與支持、反對它的發現
  • 知識 release 分研究版與 clinical 版;clinical 版只收名冊獸醫核可的連結,規模還小
  • 固定版本安裝,升版時排名語義的變動有版本號可追
  • 教學與課程使用的授權方案

知識 release 目前只在上弦平台內使用,對外授權的範圍與條件需要個案評估。

怎麼拿到 API key

目前沒有自助申請,由管理員人工核發。

  1. 到 上弦動物生技洽詢頁,寫明單位、用途、預估用量與要用的端點。
  2. 核發後會收到 vp_ 開頭的 API key;key 為個人專用,不可轉讓或公開。
  3. 每次請求在 header 加上 x-api-key:
curl -H "x-api-key: vp_your_key" https://vetpro-nine.vercel.app/api/v1/diseases?limit=5

MCP Server(給 AI agent)

MCP Server 用同一把 API key 呼叫 VetPro API,提供 12 個工具,涵蓋:

  • 全文搜尋疾病與藥物
  • 疾病詳細資料與清單
  • 鑑別診斷(症狀+檢驗發現)
  • 藥物詳細資料、搜尋與交互作用
  • 症狀、檢驗發現與文獻查詢
  • 健康檢查與 API 統計

MCP 套件還沒有公開發佈到 npm,安裝方式會在核發 API key 時一併提供(支援 Claude Desktop、Claude Code 等 MCP 用戶端)。

常見問題

網站要付費嗎?
不用。疾病百科、鑑別診斷、藥物庫與文獻庫都免費開放,不必註冊。
免費 API 的上限是多少?
每把 API key 每分鐘 100 次請求,超過時回傳 HTTP 429。目前沒有另外設每日次數上限,但服務條款規定自動化批次下載每天不得超過 10,000 筆。
可以把 API 的資料用在商業產品嗎?
要先取得書面授權。服務條款規定內容不得未經同意再散布、商用或用來訓練模型,請透過洽詢頁說明用途。
鑑別診斷的分數是機率嗎?
不是。ddx-core 輸出的是未校正的支持分數,用來排序與列出支持、反對的發現;診斷仍要由獸醫依個案判斷。
資料多久更新一次?
PubMed 文獻每週自動掃描更新;疾病與藥物內容隨每次部署更新。API 的 /api/v1/meta 端點會回傳目前的資料版本與統計。

使用 API 即同意 服務條款;臨床資訊的限制見 免責聲明。