醫(yī)院藥品管理系統(tǒng)接口規(guī)范說明*狀態(tài)碼定義：*`200`：請求成功。*`4xx`：客戶端錯誤（如400請求參數(shù)錯誤，401未授權，403權限不足，404資源不存在）。*`5xx`：服務器端錯誤。*可根據(jù)業(yè)務需要定義更細致的自定義狀態(tài)碼，但應在接口文檔中詳細說明。*錯誤處理：當接口調用失敗時，`code`字段返回非200狀態(tài)碼，`message`字段返回具體的錯誤描述，`data`字段可包含更詳細的錯誤信息（如參數(shù)校驗失敗的字段列表）。3.5接口安全規(guī)范*認證與授權：*Token應具有有效期，并支持刷新機制。*針對不同的接口和用戶角色，應實現(xiàn)細粒度的權限控制。*接口訪問控制：可考慮實施IP白名單限制，僅允許指定IP地址的系統(tǒng)訪問接口。*請求頻率限制：為防止惡意請求和系統(tǒng)過載，應對接口調用頻率進行限制。*數(shù)據(jù)脫敏：對于返回結果中包含的敏感信息（如患者身份證號、聯(lián)系方式等），應進行脫敏處理。*日志審計：所有接口調用應記錄詳細日志，包括調用方、調用時間、請求參數(shù)、返回結果、IP地址等，以便審計和問題追溯。3.6接口性能與可靠性*響應時間：一般接口的平均響應時間應控制在幾百毫秒內，復雜業(yè)務接口也應盡可能優(yōu)化，避免長時間阻塞。*并發(fā)處理：接口應能支持預期的并發(fā)請求量，需進行充分的壓力測試。*超時處理：接口調用應設置合理的超時時間。服務端在處理超時后，應能妥善處理，避免資源泄露。*重試機制：對于非冪等性操作，客戶端不應隨意重試；對于冪等性操作（如查詢、更新已存在記錄），在網絡不穩(wěn)定等情況下可考慮合理的重試機制。*冪等性設計：關鍵業(yè)務接口（如創(chuàng)建訂單、扣減庫存）應設計為冪等的，即多次調用對系統(tǒng)的影響是一致的，以應對網絡重發(fā)等場景。可通過唯一請求ID等方式實現(xiàn)。4.核心業(yè)務接口規(guī)范4.1藥品基礎信息管理接口藥品基礎信息是HDMS的核心數(shù)據(jù)，需要與HIS等系統(tǒng)保持一致。4.1.1獲取藥品信息接口*功能描述：根據(jù)藥品編碼、名稱等條件查詢藥品的詳細信息。*請求方式：GET*請求參數(shù)：*`drugCode`(可選)：藥品編碼（院內碼或國標碼）*`drugName`(可選)：藥品名稱（支持模糊查詢）*`specification`(可選)：藥品規(guī)格*`manufacturer`(可選)：生產廠家*...(其他查詢條件)*返回數(shù)據(jù)：藥品列表，每個藥品信息包含編碼、名稱、規(guī)格、劑型、單位、生產廠家、批準文號、類別、醫(yī)保屬性、價格、是否處方藥、存儲條件等。4.1.2藥品信息同步接口*功能描述：當藥品基礎信息（如價格、規(guī)格、醫(yī)保屬性等）發(fā)生變更時，HDMS主動推送更新信息給相關系統(tǒng)，或相關系統(tǒng)從HDMS拉取最新信息。*請求方式：POST(推送)或GET(拉取，需指定更新時間戳)*請求參數(shù)：(推送時)變更的藥品信息列表，包含藥品編碼及變更字段；(拉取時)上次同步時間戳。*返回數(shù)據(jù)：操作結果，成功或失敗的藥品編碼及原因。4.2藥品采購管理接口4.2.1采購計劃接口*功能描述：HIS或相關系統(tǒng)向HDMS提交藥品采購計劃，或HDMS根據(jù)庫存預警生成采購計劃后通知采購部門系統(tǒng)。*請求方式：POST*請求參數(shù)：采購計劃單信息，包含計劃單號、申請部門、申請時間、藥品列表（藥品編碼、建議采購數(shù)量、預計到貨時間等）。*返回數(shù)據(jù)：采購計劃創(chuàng)建結果，計劃單號、狀態(tài)等。4.2.2采購訂單接口*功能描述：HDMS生成采購訂單后，可推送至供應商系統(tǒng)或院內采購執(zhí)行系統(tǒng)。*請求方式：POST*請求參數(shù)：采購訂單信息，包含訂單號、供應商信息、訂單日期、藥品列表（藥品編碼、采購數(shù)量、單價、金額、交貨地點等）。*返回數(shù)據(jù)：訂單接收結果。4.2.3藥品入庫接口*功能描述：藥品到貨后，HDMS完成入庫操作，并將入庫信息同步至HIS等系統(tǒng)，更新可用庫存。*請求方式：POST*請求參數(shù)：入庫單信息，包含入庫單號、供應商、入庫日期、操作員、藥品列表（藥品編碼、批次號、生產日期、有效期至、入庫數(shù)量、入庫單價、總成本等）。*返回數(shù)據(jù)：入庫操作結果，更新后的庫存信息（可選）。4.3藥品庫存管理接口4.3.1庫存查詢接口*功能描述：查詢指定藥品的當前庫存信息（如總庫存、可用庫存、各批次庫存分布等）。*請求方式：GET*請求參數(shù)：*`drugCode`(必填)：藥品編碼*`warehouseCode`(可選)：倉庫編碼，查詢特定倉庫庫存*返回數(shù)據(jù)：藥品庫存信息，包括總數(shù)量、可用數(shù)量、待出庫數(shù)量、各批次明細（批次號、有效期至、數(shù)量、存儲位置）等。4.3.2庫存預警通知接口*功能描述：當藥品庫存低于設定的下限閾值或高于上限閾值時，HDMS主動向相關系統(tǒng)（如HIS、采購系統(tǒng)）發(fā)送預警通知。*請求方式：POST(HDMS推送)*請求參數(shù)：預警藥品列表，包含藥品編碼、藥品名稱、當前庫存、預警類型（低庫存/高庫存）、閾值等。*返回數(shù)據(jù)：通知接收確認。4.3.3藥品調撥接口*功能描述：實現(xiàn)院內不同藥房或藥庫之間的藥品調撥，并同步調撥信息。*請求方式：POST*請求參數(shù)：調撥單信息，包含調撥單號、調出部門、調入部門、調撥日期、藥品列表（藥品編碼、批次號、調撥數(shù)量等）。*返回數(shù)據(jù)：調撥操作結果。4.3.4藥品報損/報溢接口*功能描述：處理藥品損耗或盤盈，并同步調整庫存。*請求方式：POST*請求參數(shù)：報損/報溢單信息，包含單據(jù)號、操作類型（報損/報溢）、原因、日期、藥品列表（藥品編碼、批次號、數(shù)量等）。*返回數(shù)據(jù)：操作結果，更新后的庫存信息（可選）。4.4藥品調劑管理接口4.4.1處方接收接口(門診/住院)*功能描述：HIS醫(yī)生工作站開具處方后，將處方信息發(fā)送至HDMS的藥房系統(tǒng)。*請求方式：POST*請求參數(shù)：處方信息，包含處方號、患者基本信息（ID、姓名、科室等）、開方醫(yī)生、開方時間、藥品列表（藥品編碼、規(guī)格、用法用量、頻次、數(shù)量、囑托等）、處方類型（門診/住院）、就診流水號等。*返回數(shù)據(jù)：處方接收確認，可包含預配藥建議或庫存不足提示。4.4.2藥品調配確認接口*功能描述：藥房完成藥品調配后，將調配信息反饋給HIS，支持收費或記錄調配狀態(tài)。*請求方式：POST*請求參數(shù)：調配信息，包含處方號、調配藥師、調配時間、藥品實際發(fā)放數(shù)量、批次信息（可選）等。*返回數(shù)據(jù)：調配信息接收結果。4.4.3藥品發(fā)藥接口*功能描述：患者取藥后，藥房確認發(fā)藥，HDMS扣減庫存，并通知HIS處方完成。*請求方式：POST*請求參數(shù)：發(fā)藥信息，包含處方號、發(fā)藥藥師、發(fā)藥時間、患者確認信息（可選）等。*返回數(shù)據(jù)：發(fā)藥操作結果，庫存扣減確認。4.4.4退藥接口*功能描述：處理患者退藥業(yè)務，HDMS接收退藥申請，確認后增加庫存，并通知HIS進行退費處理。*請求方式：POST*請求參數(shù)：退藥單信息，包含原處方號、退藥原因、退藥藥品列表（藥品編碼、數(shù)量、批次號等）、操作人等。*返回數(shù)據(jù)：退藥操作結果，庫存更新確認。5.接口文檔管理與版本控制*接口文檔：所有接口必須提供完整、準確、最新的接口文檔。文檔應包含接口功能描述、請求URL、請求方法、請求頭、請求參數(shù)（名稱、類型、是否必填、描述、示例）、返回參數(shù)（名稱、類型、描述、示例）、成功與失敗響應示例、錯誤碼說明、調用頻率限制等。*文檔工具：推薦使用Swagger、OpenAPI等主流API文檔生成和管理工具，支持在線調試。*版本控制：接口文檔的版本應與接口版本保持一致。每次接口變更后，需及時更新文檔，并記錄版本變更歷史和變更內容。*文檔共享：接口文檔應方便相關開發(fā)、測試、集成人員查閱。6.接口測試與驗收*測試環(huán)境：應建立獨立的接口測試環(huán)境，其配置應盡可能接近生產環(huán)境。*測試數(shù)據(jù)：準備充分的、覆蓋各種場景的測試數(shù)據(jù)，包括正常數(shù)據(jù)、邊界數(shù)據(jù)和異常數(shù)據(jù)。*測試方法：*單元測試：接口提供方應對每個接口進行單元測試，確保功能正確性。*集成測試：接口調用方與提供方聯(lián)合進行集成測試，驗證端到端流程。*性能測試：對關鍵接口進行性能測試，驗證其響應時間、并發(fā)處理能力。*安全測試：驗證接口的認證、授權、數(shù)據(jù)加密等安全措施的有效性。*驗收標準：明確接口驗收的標準，包括功能完整性、數(shù)據(jù)準確性、響應時間、安全性、兼容性等。只有通過驗收的接口才能正式上線。7.實施與運維建議*接口上線計劃：制定詳細的接口上線切換計劃，包括數(shù)據(jù)遷移策略（如首次全量同步，后續(xù)增量