共用方式為


退伍軍人事務設施(獨立出版商)(預覽版)

美國退伍軍人事務部 (VA) 設施服務提供有關退伍軍人事務部健康、福利、墓地和獸醫中心的全面詳細信息,包括位置、聯絡資訊和可用服務。 數據來自即時和歷史記錄,確保使用者能夠存取最新的設施更新。 身份驗證透過對稱令牌進行管理,該服務提供了一個強大的框架,用於有效存取 VA 設施資訊。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 理查德·威爾遜
URL https://www.richardawilson.com/
Email richard.a.wilson@microsoft.com
連接器中繼資料
Publisher 理查德·威爾遜
網站 https://developer.va.gov/explore/api/va-facilities
隱私策略 https://department.va.gov/privacy/
類別 人力資源

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
VA API 金鑰 securestring 此 API 的 VA API 金鑰
環境 字串 要使用的VA API環境(生產或沙箱)

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

列出所有設施識別碼

為所有設施 ID 提供批量下載選項,並能夠按設施類型過濾以獲得更有針對性的結果。

列出特定設施的服務

查詢設施提供的服務,並使用選用參數來精簡結果。 支援獨立或組合使用 serviceIdsserviceType 進行過濾。

列出附近所有設施

從指定位置擷取指定駕駛時間內的所有設施,並可選擇依服務進行篩選。

取得設施中特定服務的詳細資料

擷取設施所提供之特定服務的詳細資訊,由設施識別碼和服務識別碼。

清單設施

具有選用搜尋參數組合的查詢機能。

通過 ID 獲取設施

傳回特定設施的詳細資訊,由其唯一 ID 識別。

列出所有設施識別碼

為所有設施 ID 提供批量下載選項,並能夠按設施類型過濾以獲得更有針對性的結果。

參數

名稱 機碼 必要 類型 Description
設施類型
type string

篩選以依設施類型搜尋,例如健康、墳場、福利或獸醫中心。

傳回

提供 VA 設施的唯一識別碼清單。

設施 ID 回應
FacilitiesIdsResponse

列出特定設施的服務

查詢設施提供的服務,並使用選用參數來精簡結果。 支援獨立或組合使用 serviceIdsserviceType 進行過濾。

參數

名稱 機碼 必要 類型 Description
設施識別碼
facilityId True string

設施的唯一標識符,遵循格式 <prefix>_<station>,帶有指示設施類型的前綴(例如,“vha”代表醫療機構,“vba”代表福利等)。

服務標識碼
serviceIds string

以逗號分隔的服務 ID 清單,用於過濾搜尋,無論是否 serviceType 使用參數。

服務類型
serviceType string

服務類型來篩選搜尋,無論是否使用 serviceIds 參數。

傳回

包含設施所提供詳細服務清單的物件。

詳細服務回應
DetailedServicesResponse

列出附近所有設施

從指定位置擷取指定駕駛時間內的所有設施,並可選擇依服務進行篩選。

參數

名稱 機碼 必要 類型 Description
緯度
lat True float

計算行駛時間的緯度。

經度
long True float

計算行車時間的經度。

行車時間
drive_time integer

從該位置(包括設施)的最長駕駛時間(以分鐘為單位)。

服務篩選器
services[] string

要篩選的選擇性逗點分隔服務清單。

頁碼
page integer

要傳回的結果頁碼。

每頁結果
per_page integer

每頁要傳回的結果數目。

傳回

包含到達附近 VA 設施的最短和最長時間的響應對象。

附近設施回應
NearbyResponse

取得設施中特定服務的詳細資料

擷取設施所提供之特定服務的詳細資訊,由設施識別碼和服務識別碼。

參數

名稱 機碼 必要 類型 Description
設施識別碼
facilityId True string

設施的唯一標識符,結構為 <prefix>_<station>,其中前綴表示設施類型(例如,“vha”代表衛生設施,“vba”代表福利等)。

服務識別碼
serviceId True string

設施內特定服務的唯一識別碼。

傳回

包含設施所提供之特定服務的擴充詳細資料。

詳細服務回應
DetailedServiceResponse

清單設施

具有選用搜尋參數組合的查詢機能。

參數

名稱 機碼 必要 類型 Description
設施識別碼
facilityIds string

以逗號分隔的設施 ID 清單,用於搜尋。

郵遞區號
zip string

搜尋設施的郵遞區號,僅考慮前五位數字。

State
state string

設施搜尋的狀態,通常是兩個字元的代碼。

緯度
lat float

WGS84 座標中設施搜尋的緯度。

經度
long float

WGS84 座標中設施搜尋的經度。

Radius
radius float

從指定點到過濾器設施搜尋的徑向距離,以英里為單位。

邊界方塊
bbox[] string

地理區域內設施搜尋的邊界框座標。

維斯恩
visn number

用於設施搜索的 VISN(退伍軍人綜合服務網絡)代碼。

設施類型
type string

要過濾搜尋結果的設施位置類型。

提供的服務
services[] string

以逗號分隔的服務清單,可依設施提供的服務篩選設施。

包括移動設施
mobile boolean

標記以在搜尋結果中包含或排除行動設施。

頁碼
page integer

要在編頁回應中傳回的結果頁碼。

每頁結果
per_page integer

編頁回應中每頁的結果數。

傳回

描述一或多個 VA 設施的回應物件,包括資料、分頁鏈結和中繼資料。

設施回應
FacilitiesResponse

通過 ID 獲取設施

傳回特定設施的詳細資訊,由其唯一 ID 識別。

參數

名稱 機碼 必要 類型 Description
設施識別碼
facilityId True string

設施的唯一標識符,遵循格式 <prefix>_<station>,前綴如“vha”(醫療機構)、“vba”(福利)、“nca”(墓地)或“vc”(獸醫中心)。

傳回

包含單一設施的詳細資料。

設施讀取回應
FacilityReadResponse

定義

Address

代表實體地址。

名稱 路徑 類型 Description
地址行 1
address1 string

地址的第一行,通常包括街道名稱和號碼。

地址行 2
address2 string

地址的第二行 (如果適用),例如建築物編號或複合區名稱。

地址行 3
address3 string

地址的第三行(如果適用),例如單位或套房號碼。

城市
city string

地址的城市部分。

State
state string

地址的州代碼元件。

郵遞區號
zip string

郵遞區號 (ZIP) 元件。

Addresses

保存設施的郵寄地址和實際地址。

名稱 路徑 類型 Description
郵寄
mailing Address

代表實體地址。

物理的
physical Address

代表實體地址。

預約電話號碼

包含用於排程約會的電話號碼資訊,包括分機和標籤。

名稱 路徑 類型 Description
Extension
extension string

約會電話的分機號碼。

標籤
label string

描述預約電話號碼的標籤(例如,“主電話”)。

Number
number string

約會的主要電話號碼。

類型
type string

聯絡號碼的類型,例如「tel」或「fax」。

詳細服務

提供有關設施提供的特定服務的詳細信息,包括預約信息、服務可用性和聯繫方式。

名稱 路徑 類型 Description
預約 Lead-In
appointmentLeadIn string

提供其他約會資訊,其中可能包含 HTML 或字串格式字元。

預約電話
appointmentPhones array of AppointmentPhoneNumber

用於安排與此服務相關的約會的電話號碼清單。

上次更新
lastUpdated date-time

最近更新詳細服務資訊的日期和時間。

服務名稱
name string

服務的名稱。

服務識別碼
serviceId string

服務的唯一識別碼。

服務詳細資料路徑
path string

頁面的 URL,其中包含有關該機構醫療保健系統內此服務的更多詳細資訊。

一般服務資訊
serviceInfo ServiceInfo

有關設施所提供服務的基本資訊,包括服務類型和識別碼。

服務地點
serviceLocations array of DetailedServiceLocation

提供服務的位置清單。

病人等待時間
waitTime PatientWaitTime

表示新患者和現有患者在退伍軍人管理局設施獲得特定醫療保健服務的預期等待時間。

詳細服務地址

特定服務位置的地址資訊,包括街道、建築物和房間詳細資料。

名稱 路徑 類型 Description
地址行 1
addressLine1 string

主要街道地址行。

地址行 2
addressLine2 string

其他地址資訊,例如建築物編號。

建築物名稱/編號
buildingNameNumber string

服務地點的建築物名稱或編號。

城市
city string

服務地點的城市。

國碼 (地區碼)
countryCode string

服務地點的國家/地區代碼。

State
state string

服務位置的州代碼。

翼樓/樓層/房間號
wingFloorOrRoomNumber string

服務地點的特定翼樓、樓層或房間號碼。

郵遞區號
zipCode string

服務地點的郵遞區號。

詳細服務電子郵件聯絡方式

與特定設施服務相關的電子郵件聯絡資訊,包括電子郵件地址和標籤。

名稱 路徑 類型 Description
電子郵件地址
emailAddress string

用於聯絡設施服務的電子郵件地址。

電子郵件標籤
emailLabel string

與電子郵件地址相關聯的標籤或名稱。

詳細服務時間

代表服務的運作時數,格式為描述性文字。 營業時間可能因節假日或活動而異。

名稱 路徑 類型 Description
星期五
friday string

週五營業時間。

星期一
monday string

週一營業時間。

星期六
saturday string

週六營業時間。

星期日
sunday string

週日營業時間。

星期四
thursday string

週四營業時間。

星期二
tuesday string

週二營業時間。

星期三
wednesday string

週三的營業時間。

詳細服務位置

提供有關提供服務的位置的具體詳細信息,包括時間、聯繫信息和日程安排選項。

名稱 路徑 類型 Description
其他營業時間信息
additionalHoursInfo string

有關服務地點時間的詳細信息可能會根據工作人員的可用性而有所不同。

電子郵件聯絡人
emailContacts array of DetailedServiceEmailContact

設施服務的電子郵件聯絡人清單。

辦公室名稱
officeName string

提供服務的特定辦公室位置的名稱。

線上安排可用性
onlineSchedulingAvailable string

指出線上排程是否適用於服務。

電話聯絡人
phones array of AppointmentPhoneNumber

用於安排約會或進行查詢的電話號碼列表。

推薦要求
referralRequired string

指出是否需要轉介才能存取服務。

詳細服務地址
serviceAddress DetailedServiceAddress

特定服務位置的地址資訊,包括街道、建築物和房間詳細資料。

詳細服務時間
serviceHours DetailedServiceHours

代表服務的運作時數,格式為描述性文字。 營業時間可能因節假日或活動而異。

Walk-Ins 接受
walkInsAccepted string

指出是否接受上門存取服務。

詳細服務回應

包含設施所提供之特定服務的擴充詳細資料。

名稱 路徑 類型 Description
詳細服務
data DetailedService

提供有關設施提供的特定服務的詳細信息,包括預約信息、服務可用性和聯繫方式。

DetailedServices中繼資料

保留詳細服務回應的中繼資料,包括分頁詳細資料。

名稱 路徑 類型 Description
分頁資料
pagination Pagination

詳細說明回應的分頁結構,包括目前頁面、總頁數、每頁的條目數,以及條目總數。

DetailedServices回應

包含設施所提供詳細服務清單的物件。

名稱 路徑 類型 Description
服務清單
data array of DetailedService

詳細說明所提供每項服務的清單。

頁面連結
links PageLinks

提供編頁回應的第一頁、最後一頁、下一頁和上一頁的超連結,包括相關資訊和目前頁面的連結。

詳細服務中繼資料
meta DetailedServicesMetadata

保留詳細服務回應的中繼資料,包括分頁詳細資料。

距離

使用小數格式表示到設施的距離(以英里為單位)。

名稱 路徑 類型 Description
距離(英里)
distance number

到設施的距離,以十進制格式表示。

設施識別碼
id string

設施的識別碼。

FacilitiesIds回應

提供 VA 設施的唯一識別碼清單。

名稱 路徑 類型 Description
設施識別碼
data array of string

VA 設施識別碼的陣列。

設施中繼資料

包含回應的中繼資料,包括分頁和到設施的距離。

名稱 路徑 類型 Description
到設施的距離
distances array of Distance

從給定位置到響應中列出的每個設施的距離陣列。

分頁資料
pagination Pagination

詳細說明回應的分頁結構,包括目前頁面、總頁數、每頁的條目數,以及條目總數。

設施回應

描述一或多個 VA 設施的回應物件,包括資料、分頁鏈結和中繼資料。

名稱 路徑 類型 Description
設施數據
data array of Facility

提供每個設施詳細資料的設施物件陣列。

頁面連結
links PageLinks

提供編頁回應的第一頁、最後一頁、下一頁和上一頁的超連結,包括相關資訊和目前頁面的連結。

設施元數據
meta FacilitiesMetadata

包含回應的中繼資料,包括分頁和到設施的距離。

設施

詳細說明單一 VA 設施的屬性、位置和服務。

名稱 路徑 類型 Description
設施屬性
attributes FacilityAttributes

描述設施的全面詳細信息,包括其類型、提供的服務和位置詳細資訊。

設施識別碼
id string

設施的唯一識別碼。

設施類型
type string

表示設施的頂層類型(例如,VA 醫療設施)。

設施屬性

描述設施的全面詳細信息,包括其類型、提供的服務和位置詳細資訊。

名稱 路徑 類型 Description
address
address Addresses

保存設施的郵寄地址和實際地址。

Classification
classification string

設施的子類型,進一步描述設施類型。

設施類型
facilityType string

設施的類別,例如健康、福利、墓地或獸醫中心。

營業時間
hours Hours

詳細說明一週中每一天的標準營業時間。 請注意,營業時間可能會因節假日或活動而有所不同。

緯度
lat float

設施的地理緯度。

經度
long float

設施的地理經度。

移動設施
mobile boolean

指示設施是移動 (true) 還是靜止 (false)。

設施名稱
name string

設施的正式名稱。

營運狀況
operatingStatus OperatingStatus

描述設施目前的運作狀態,指示正常運作、有限服務、關閉或特別通知。

特別營業時間
operationalHoursSpecialInstructions array of string

有關營業時間的特別說明,包括例外情況。

母設施
parent Parent

設施上層組織的參考資料,包括 ID 和 API 連結。

設施聯絡電話
phone Phone

該設施的電話號碼集合,涵蓋各種服務和部門。

患者滿意度分數
satisfaction Satisfaction

包含設施服務的患者滿意度分數,包括特定的醫療保健服務區域。

退伍軍人事務部設施服務
services Services

退伍軍人事務部設施提供的所有服務的完整列表,按福利、健康和其他服務等類型分類。

時區
timeZone string

設施所在的時區。

退伍軍人綜合服務網絡 (VISN)
visn string

設施所屬的 VISN。

網站
website string

該設施的官方網站。

FacilityRead回應

包含單一設施的詳細資料。

名稱 路徑 類型 Description
設施
data Facility

詳細說明單一 VA 設施的屬性、位置和服務。

小時

詳細說明一週中每一天的標準營業時間。 請注意,營業時間可能會因節假日或活動而有所不同。

名稱 路徑 類型 Description
週五營業時間
friday string

週五營業時間。

星期一營業時間
monday string

營業時間為週一。

週六營業時間
saturday string

週六的營業時間。

週日營業時間
sunday string

週日營業時間。

週四營業時間
thursday string

週四的營業時間。

週二營業時間
tuesday string

週二的營業時間。

週三營業時間
wednesday string

週三營業時間。

Meta

包含有關回應的中繼資料,包括所使用資料集的版本。

名稱 路徑 類型 Description
樂隊版本
bandVersion string

指出行駛時間區間資料集的版本。

附近

描述位於指定位置附近的 VA 設施,包括設施屬性和識別碼。

名稱 路徑 類型 Description
附近設施時間屬性
attributes NearbyAttributes

提供到達附近設施所需的最短和最長時間。

設施識別碼
id string

附近設施的唯一識別碼。

設施類型
type string

指定附近設施的類型。

附近屬性

提供到達附近設施所需的最短和最長時間。

名稱 路徑 類型 Description
最長時間
maxTime integer

到達設施的最長時間 (以分鐘為單位)。

最短時間
minTime integer

到達設施的最短時間(以分鐘為單位)。

附近回應

包含到達附近 VA 設施的最短和最長時間的響應對象。

名稱 路徑 類型 Description
附近設施數據
data array of Nearby

附近的一系列退伍軍人事務部設施。

回應中繼資料
meta Meta

包含有關回應的中繼資料,包括所使用資料集的版本。

運作狀態

描述設施目前的運作狀態,指示正常運作、有限服務、關閉或特別通知。

名稱 路徑 類型 Description
其他資訊
additionalInfo string

提供有關設施運營狀態的更多詳細信息,例如具體的訪客通知。

狀態代碼
code string

代表設施整體運作狀態的代碼。

補充狀態
supplementalStatus array of SupplementalStatus

提供有關設施運營的更多詳細信息的其他狀態列表。

頁面連結

提供編頁回應的第一頁、最後一頁、下一頁和上一頁的超連結,包括相關資訊和目前頁面的連結。

名稱 路徑 類型 Description
首頁鏈接
first string

回應第一頁的URL。

最後一頁鏈接
last string

回應最後一頁的URL。

下一頁鏈接
next string

回應下一頁的 URL。

上一頁連結
prev string

回應上一頁的 URL。

相關連結
related string

相關頁面的 URL 或回應資訊。

目前頁面連結
self string

回應目前頁面的URL。

分頁

詳細說明回應的分頁結構,包括目前頁面、總頁數、每頁的條目數,以及條目總數。

名稱 路徑 類型 Description
當前頁面
currentPage integer

回應中目前頁面的編號。

每頁結果
perPage integer

每頁顯示的結果數目。

條目總數
totalEntries integer

符合查詢的項目總數。

總頁數
totalPages integer

查詢所產生的頁面總數。

Parent

設施上層組織的參考資料,包括 ID 和 API 連結。

名稱 路徑 類型 Description
上層設施 ID
id string

母項設施的識別碼。

上層設施 API 連結
link string

有關父設施的 API 請求的 URL。

患者滿意度

退伍軍人報告的退伍軍人管理局醫療機構醫療保健服務的滿意度得分。

名稱 路徑 類型 Description
初級保健程序
primaryCareRoutine float

常規初級保健滿意度分數。

初級保健緊急
primaryCareUrgent float

緊急初級保健滿意度分數。

專科護理程序
specialtyCareRoutine float

常規專科護理的滿意度分數。

專科護理緊急
specialtyCareUrgent float

緊急專科護理的滿意度分數。

患者等待時間

表示新患者和現有患者在退伍軍人管理局設施獲得特定醫療保健服務的預期等待時間。

名稱 路徑 類型 Description
生效日期
effectiveDate string

這些等待時間的生效日期。

確定的患者等待時間
established number

尋求非緊急預約的既定患者的平均等待時間。

新患者等待時間
new number

尋求非緊急預約的新患者的平均等待時間。

電話

該設施的電話號碼集合,涵蓋各種服務和部門。

名稱 路徑 類型 Description
下班後
afterHours string

正常營業時間以外提供聯絡電話。

招生協調員
enrollmentCoordinator string

直接聯繫該設施的註冊協調員。

傳真
fax string

設施的傳真號碼。

退伍軍人事務部健康通
healthConnect string

VA Health Connect 服務的聯絡電話。

主要聯絡人
main string

設施的主要電話號碼。

心理健康診所
mentalHealthClinic string

心理健康診所服務的聯繫電話。

患者倡導者
patientAdvocate string

直接聯繫該機構的患者倡導者。

藥房
pharmacy string

藥房服務的聯絡電話。

滿意度

包含設施服務的患者滿意度分數,包括特定的醫療保健服務區域。

名稱 路徑 類型 Description
生效日期
effectiveDate string

上次更新滿意度分數的日期。

患者滿意度
health PatientSatisfaction

退伍軍人報告的退伍軍人管理局醫療機構醫療保健服務的滿意度得分。

服務福利服務

提供有關設施提供的特定福利服務的信息。

名稱 路徑 類型 Description
服務連結
link string

有關福利服務的詳細資訊的 URL。

服務名稱
name string

所提供福利服務的名稱。

服務識別碼
serviceId string

福利服務的唯一識別碼。

服務健康服務

詳細說明該設施提供的特定健康服務,包括服務名稱、唯一識別碼和更多資訊的連結。

名稱 路徑 類型 Description
服務連結
link string

有關健康服務的更多資訊的完整連結。

服務名稱
name string

設施提供的健康服務的名稱。

服務識別碼
serviceId string

健康情況服務的唯一識別碼,可用來以程式設計方式參考服務。

ServiceInfo

有關設施所提供服務的基本資訊,包括服務類型和識別碼。

名稱 路徑 類型 Description
服務名稱
name string

所提供服務的名稱。

服務識別碼
serviceId string

服務的唯一識別碼。

服務類型
serviceType string

所提供服務的類別(例如,健康、福利)。

服務其他服務

提供有關該機構提供的其他類型服務的信息,這些服務不屬於標準健康或福利類別。

名稱 路徑 類型 Description
服務連結
link string

連結至服務詳細資訊的 URL。

服務名稱
name string

所提供服務的名稱。

服務識別碼
serviceId string

服務的唯一識別碼。

Services

退伍軍人事務部設施提供的所有服務的完整列表,按福利、健康和其他服務等類型分類。

名稱 路徑 類型 Description
福利服務
benefits array of ServiceBenefitsService

與設施提供的福利相關的服務集合。

健康服務
health array of ServiceHealthService

該設施提供的一系列健康相關服務。

上次更新
lastUpdated string

服務資訊最近更新的日期。

服務連結
link string

用於存取有關設施服務詳細資訊的基本 URL。

其他服務
other array of ServiceOtherService

該機構提供的不屬於健康或福利的其他服務清單。

補充狀態

VA 設施的其他狀態信息,提供基本運營狀態之外的更具體的詳細信息。

名稱 路徑 類型 Description
狀態標識碼
id string

補充狀態的唯一識別碼。

狀態標籤
label string

補充狀態的描述性標籤,以人類可讀的術語解釋其含義。