退伍军人事务设施（独立出版商）（预览版）

美国退伍军人事务部（VA）设施服务提供有关弗吉尼亚州卫生、福利、墓地和兽医中心的综合详细信息，包括地点、联系信息和服务。数据来自实时记录和历史记录，确保用户有权访问最新的设施更新。身份验证通过对称令牌进行管理，该服务提供了一个可靠的框架，用于高效访问 VA 设施信息。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	理查德·威尔逊
URL	https://www.richardawilson.com/
Email	richard.a.wilson@microsoft.com

连接器元数据
发布者	理查德·威尔逊
Website	https://developer.va.gov/explore/api/va-facilities
隐私策略	https://department.va.gov/privacy/
类别	人力资源

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
VA API 密钥	securestring	此 API 的 VA API 密钥	True
环境	字符串	要使用的 VA API 环境（生产或沙盒）	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

列出所有设施 ID	为所有设施 ID 提供批量下载选项，并能够按设施类型进行筛选以获取更多目标结果。
列出特定设施的服务	查询设施提供的服务，其中包含用于优化结果的可选参数。支持独立或组合使用 `serviceIds` 和 `serviceType` 筛选。
列出设施	包含可选搜索参数的组合的查询设施。
列出附近的所有设施	从给定位置检索指定驱动器时间内的所有设施，并按服务进行可选筛选。
按 ID 获取设施	返回有关特定设施的详细信息，该设施由其唯一 ID 标识。
获取设施中特定服务的详细信息	检索由设施提供的特定服务的详细信息，该服务由设施 ID 和服务 ID 标识。

列出所有设施 ID

操作 ID:: GetFacilityIds

为所有设施 ID 提供批量下载选项，并能够按设施类型进行筛选以获取更多目标结果。

参数

名称	密钥	必需	类型	说明
设施类型	type		string	按设施类型（如健康、墓地、福利或兽医中心）进行搜索的筛选器。

提供 VA 设施的唯一标识符列表。

设施 ID 响应: FacilitiesIdsResponse

列出特定设施的服务

操作 ID:: GetFacilityServicesById

查询设施提供的服务，其中包含用于优化结果的可选参数。支持独立或组合使用 serviceIds 和 serviceType 筛选。

参数

名称	密钥	必需	类型	说明
设施 ID	facilityId	True	string	设施的唯一标识符，遵循格式 `<prefix>_<station>`，前缀指示设施类型（例如，卫生设施的“vha”，“vba”用于福利等）。
服务 ID	serviceIds		string	一个逗号分隔的服务 ID 列表，用于筛选搜索，无论是否使用参数 `serviceType` 。
服务类型	serviceType		string	用于筛选搜索的服务类型，无论是否 `serviceIds` 使用参数。

包含设施提供的详细服务列表的对象。

详细服务响应: DetailedServicesResponse

列出设施

操作 ID:: GetFacilities

包含可选搜索参数的组合的查询设施。

参数

名称	密钥	类型	说明
设施 ID	facilityIds	string	用于搜索的设施 ID 的逗号分隔列表。
邮政编码	zip	string	用于搜索设施的邮政编码，只考虑前五位数字。
State	state	string	设施搜索的状态，通常是两个字符的代码。
纬度	lat	float	WGS84 坐标中设施搜索的纬度。
经度	long	float	WGS84 坐标中设施搜索的经度。
半径	radius	float	从指定点到筛选设施搜索的径向距离（以英里为单位）。
边界框	bbox[]	string	地理区域内设施搜索的边界框坐标。
VISN	visn	number	VISN（退伍军人集成服务网络）代码进行设施搜索。
设施类型	type	string	用于筛选搜索结果的设施位置的类型。
提供的服务	services[]	string	一个逗号分隔的服务列表，用于按服务提供的服务筛选设施。
包括移动设施	mobile	boolean	用于在搜索结果中包含或排除移动设施的标志。
页码	page	integer	分页响应中要返回的结果的页码。
每页结果数	per_page	integer	分页响应中每页的结果数。

描述一个或多个 VA 设施的响应对象，包括数据、分页链接和元数据。

设施响应: FacilitiesResponse

列出附近的所有设施

操作 ID:: GetNearbyFacilities

从给定位置检索指定驱动器时间内的所有设施，并按服务进行可选筛选。

参数

名称	密钥	必需	类型	说明
纬度	lat	True	float	计算驱动器时间的纬度。
经度	long	True	float	计算驱动器时间的经度。
驱动器时间	drive_time		integer	从位置到包含设施的最大驱动器时间（以分钟为单位）。
服务筛选器	services[]		string	要筛选的服务的可选逗号分隔列表。
页码	page		integer	要返回的结果的页码。
每页结果数	per_page		integer	每页要返回的结果数。

包含到达附近 VA 设施的最小和最大时间的响应对象。

附近设施响应: NearbyResponse

按 ID 获取设施

操作 ID:: GetFacilityById

返回有关特定设施的详细信息，该设施由其唯一 ID 标识。

参数

名称	密钥	必需	类型	说明
设施 ID	facilityId	True	string	设施的唯一标识符，遵循格式 `<prefix>_<station>`，前缀为“vha”（卫生设施）、“vba”（福利）、“nca”（公墓）或“vc”（兽医中心）。

包含单个设施的详细数据。

设施读取响应: FacilityReadResponse

获取设施中特定服务的详细信息

操作 ID:: GetFacilityServiceById

检索由设施提供的特定服务的详细信息，该服务由设施 ID 和服务 ID 标识。

参数

名称	密钥	必需	类型	说明
设施 ID	facilityId	True	string	该设施的唯一标识符的结构为 `<prefix>_<station>`，其中前缀指示设施的类型（例如，用于卫生设施的“vha”、用于福利的“vba”等）。
服务编号	serviceId	True	string	设施中特定服务的唯一标识符。

包含设施提供的特定服务的扩展详细信息。

详细服务响应: DetailedServiceResponse

定义

地址

表示物理地址。

名称	路径	类型	说明
地址行 1	address1	string	地址的第一行，通常包括街道名称和号码。
地址行 2	address2	string	地址的第二行（如果适用），例如建筑物号或复数名称。
地址行 3	address3	string	地址的第三行（如果适用），例如单位或套件号。
City	city	string	地址的城市组件。
State	state	string	地址的状态代码组件。
邮政编码	zip	string	地址的邮政（ZIP）代码组件。

Addresses

保存设施的邮寄地址和物理地址。

名称	路径	类型	说明
邮件	mailing	Address	表示物理地址。
物理的	physical	Address	表示物理地址。

AppointmentPhoneNumber

包含用于安排约会的电话号码信息，包括扩展和标签。

名称	路径	类型	说明
Extension	extension	string	约会电话的分机号码。
标签	label	string	描述约会电话号码（例如“主电话”）的标签。
编号	number	string	约会的主要电话号码。
类型	type	string	联系人号码的类型，例如“tel”或“fax”。

DetailedService

提供有关设施提供的特定服务的详细信息，包括约会信息、服务可用性和联系人详细信息。

名称	路径	类型	说明
约会 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	指示在 VA 设施为新的和已建立的病人提供特定医疗保健服务的预期等待时间。

DetailedServiceAddress

特定服务位置的地址信息，包括街道、建筑和房间详细信息。

名称	路径	类型	说明
地址行 1	addressLine1	string	主要街道地址行。
地址行 2	addressLine2	string	其他地址信息，如建筑物编号。
生成名称/编号	buildingNameNumber	string	服务位置的建筑物的名称或编号。
City	city	string	服务位置的城市。
国家/地区代码	countryCode	string	服务位置的国家/地区代码。
State	state	string	服务位置的状态代码。
Wing/Floor/Room Number	wingFloorOrRoomNumber	string	服务位置的特定翼、楼层或房间数。
邮政编码	zipCode	string	服务位置的邮政编码。

DetailedServiceEmailContact

与特定设施服务相关的电子邮件联系人信息，包括电子邮件地址和标签。

名称	路径	类型	说明
电子邮件地址	emailAddress	string	联系设施服务的电子邮件地址。
电子邮件标签	emailLabel	string	与电子邮件地址关联的标签或名称。

DetailedServiceHours

表示服务的作小时数，格式为描述性文本。小时数可能因假日或事件而异。

名称	路径	类型	说明
Friday	friday	string	星期五的工作时间。
Monday	monday	string	星期一的作小时数。
Saturday	saturday	string	星期六的工作时间。
星期日	sunday	string	周日的工作时间。
Thursday	thursday	string	周四的工作时间。
Tuesday	tuesday	string	周二的工作时间。
Wednesday	wednesday	string	周三的工作时间。

DetailedServiceLocation

提供有关提供服务的位置的特定详细信息，包括小时、联系信息和计划选项。

名称	路径	类型	说明
其他小时信息	additionalHoursInfo	string	有关因员工可用性而异的服务位置时间的详细信息。
电子邮件联系人	emailContacts	array of DetailedServiceEmailContact	设施服务的电子邮件联系人列表。
Office 名称	officeName	string	提供服务的特定办公室位置的名称。
联机计划可用性	onlineSchedulingAvailable	string	指示联机计划是否可用于该服务。
电话联系人	phones	array of AppointmentPhoneNumber	用于安排约会或进行查询的电话号码列表。
引荐要求	referralRequired	string	指示是否需要引荐才能访问服务。
详细服务地址	serviceAddress	DetailedServiceAddress	特定服务位置的地址信息，包括街道、建筑和房间详细信息。
详细服务小时数	serviceHours	DetailedServiceHours	表示服务的作小时数，格式为描述性文本。小时数可能因假日或事件而异。
已接受 Walk-Ins	walkInsAccepted	string	指示是否接受用于访问服务的演练。

DetailedServiceResponse

包含设施提供的特定服务的扩展详细信息。

名称	路径	类型	说明
详细服务	data	DetailedService	提供有关设施提供的特定服务的详细信息，包括约会信息、服务可用性和联系人详细信息。

DetailedServicesMetadata

保存有关详细服务的响应的元数据，包括分页详细信息。

名称	路径	类型	说明
分页数据	pagination	Pagination	详细说明响应的分页结构，包括当前页、总页数、每页条目数和条目总数。

DetailedServicesResponse

包含设施提供的详细服务列表的对象。

名称	路径	类型	说明
服务列表	data	array of DetailedService	详细说明提供的每个服务的列表。
页面链接	links	PageLinks	提供指向分页响应的第一页、最后一页、下一页和上一页的超链接，包括指向相关信息和当前页的链接。
详细服务元数据	meta	DetailedServicesMetadata	保存有关详细服务的响应的元数据，包括分页详细信息。

距离

表示使用十进制格式以英里为单位的设施的距离。

名称	路径	类型	说明
以英里为单位的距离	distance	number	设施的距离（以十进制格式表示）。
设施 ID	id	string	设施的标识符。

FacilitiesIdsResponse

提供 VA 设施的唯一标识符列表。

名称	路径	类型	说明
设施 ID	data	array of string	VA 设施标识符的数组。

FacilitiesMetadata

包含响应的元数据，包括分页和设施距离。

名称	路径	类型	说明
与设施的距离	distances	array of Distance	从给定位置到响应中列出的每个设施的距离数组。
分页数据	pagination	Pagination	详细说明响应的分页结构，包括当前页、总页数、每页条目数和条目总数。

FacilitiesResponse

描述一个或多个 VA 设施的响应对象，包括数据、分页链接和元数据。

名称	路径	类型	说明
设施数据	data	array of Facility	一组设施对象，提供有关每个设施的详细信息。
页面链接	links	PageLinks	提供指向分页响应的第一页、最后一页、下一页和上一页的超链接，包括指向相关信息和当前页的链接。
设施元数据	meta	FacilitiesMetadata	包含响应的元数据，包括分页和设施距离。

设施

详细介绍单个 VA 设施的属性、位置和服务。

名称	路径	类型	说明
设施属性	attributes	FacilityAttributes	描述设施的综合详细信息，包括其类型、提供的服务和位置详细信息。
设施 ID	id	string	设施的唯一标识符。
设施类型	type	string	指示设施的顶级类型（例如 VA 卫生设施）。

FacilityAttributes

描述设施的综合详细信息，包括其类型、提供的服务和位置详细信息。

名称	路径	类型	说明
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	包含设施服务的患者满意度分数，包括特定的医疗保健服务区域。
VA 设施服务	services	Services	VA 设施提供的所有服务的综合列表，按类型分类，如权益、运行状况和其他服务。
时区	timeZone	string	设施所在的时区。
退伍军人集成服务网络（VISN）	visn	string	设施所属的 VISN。
Website	website	string	设施的官方网站。

FacilityReadResponse

包含单个设施的详细数据。

名称	路径	类型	说明
设施	data	Facility	详细介绍单个 VA 设施的属性、位置和服务。

小时

详细说明一周中的每一天的标准工作时间。请注意，由于假日或事件，小时数可能会有所不同。

名称	路径	类型	说明
星期五小时	friday	string	周五的工作时间。
星期一小时	monday	string	周一的工作时间。
星期六小时	saturday	string	周六的工作时间。
星期日小时数	sunday	string	周日的工作时间。
星期四小时	thursday	string	周四的工作时间。
星期二小时数	tuesday	string	周二的工作时间。
星期三小时	wednesday	string	周三的工作时间。

名称	路径	类型	说明
带区版本	bandVersion	string	指示驱动器时间带数据集的版本。

附近

描述位于指定位置附近的 VA 设施，包括设施属性和标识符。

名称	路径	类型	说明
附近的设施时间属性	attributes	NearbyAttributes	提供到达附近设施所需的最短和最长时间。
设施 ID	id	string	附近设施的唯一标识符。
设施类型	type	string	指定附近设施的类型。

NearbyAttributes

提供到达附近设施所需的最短和最长时间。

名称	路径	类型	说明
最长时间	maxTime	integer	到达设施的最长时间（以分钟为单位）。
最短时间	minTime	integer	到达设施的最低时间（以分钟为单位）。

NearbyResponse

包含到达附近 VA 设施的最小和最大时间的响应对象。

名称	路径	类型	说明
附近的设施数据	data	array of Nearby	附近的 VA 设施阵列。
响应元数据	meta	Meta	包含有关响应的元数据，包括使用的数据集版本。

OperatingStatus

描述设施的当前作状态，指示正常作、有限的服务、关闭或特别通知。

名称	路径	类型	说明
其他信息	additionalInfo	string	提供有关设施作状态的进一步详细信息，例如特定的访问者通知。
状态代码	code	string	表示设施的总体作状态的代码。
补充状态	supplementalStatus	array of SupplementalStatus	提供有关设施作的更多详细信息的其他状态列表。

PageLinks

提供指向分页响应的第一页、最后一页、下一页和上一页的超链接，包括指向相关信息和当前页的链接。

名称	路径	类型	说明
第一页链接	first	string	响应的第一页的 URL。
最后一页链接	last	string	响应的最后一页的 URL。
下一页链接	next	string	响应下一页的 URL。
上一页链接	prev	string	响应上一页的 URL。
相关链接	related	string	响应的相关页面或信息的 URL。
当前页链接	self	string	响应的当前页的 URL。

分页

详细说明响应的分页结构，包括当前页、总页数、每页条目数和条目总数。

名称	路径	类型	说明
当前页	currentPage	integer	响应中的当前页数。
每页结果数	perPage	integer	每页显示的结果数。
总条目数	totalEntries	integer	与查询匹配的条目总数。
总页数	totalPages	integer	查询生成的页总数。

Parent

设施父组织的参考数据，包括 ID 和 API 链接。

名称	路径	类型	说明
父设施 ID	id	string	父设施的标识符。
父设施 API 链接	link	string	有关父设施的 API 请求的 URL。

PatientSatisfaction

退伍军人报告在弗吉尼亚州卫生设施的医疗保健服务的满意度分数。

名称	路径	类型	说明
初级护理例程	primaryCareRoutine	float	常规初级护理的满意度分数。
初级护理紧急	primaryCareUrgent	float	紧急初级护理的满意度分数。
专业护理例程	specialtyCareRoutine	float	常规专业护理的满意度分数。
特殊护理紧急	specialtyCareUrgent	float	紧急特殊护理的满意度分数。

PatientWaitTime

指示在 VA 设施为新的和已建立的病人提供特定医疗保健服务的预期等待时间。

名称	路径	类型	说明
生效日期	effectiveDate	string	这些等待时间生效的日期。
已建立的病人等待时间	established	number	寻求非紧急预约的已建立患者的平均等待时间。
新患者等待时间	new	number	寻求非紧急预约的新病人的平均等待时间。

电话

设施的电话号码集合，涵盖各种服务和部门。

名称	路径	类型	说明
小时后	afterHours	string	在正常工作时间之外可用的联系人号码。
注册协调器	enrollmentCoordinator	string	直接连接到设施的注册协调器。
传真	fax	string	设施的传真号。
VA Health Connect	healthConnect	string	VA Health Connect 服务的联系人号码。
主联系人	main	string	设施的主要电话号码。
心理健康诊所	mentalHealthClinic	string	心理健康诊所服务的联系人号码。
患者倡导者	patientAdvocate	string	直接连接到该设施的病人倡导者。
药房	pharmacy	string	药房服务的联系人号码。

满意度

包含设施服务的患者满意度分数，包括特定的医疗保健服务区域。

名称	路径	类型	说明
生效日期	effectiveDate	string	上次更新满意度分数的日期。
患者满意度	health	PatientSatisfaction	退伍军人报告在弗吉尼亚州卫生设施的医疗保健服务的满意度分数。

ServiceBenefitsService

提供有关设施提供的特定权益服务的信息。

名称	路径	类型	说明
服务链接	link	string	有关权益服务的详细说明的 URL。
服务名称	name	string	提供的好处服务的名称。
服务编号	serviceId	string	权益服务的唯一标识符。

ServiceHealthService

详细介绍设施中提供的特定运行状况服务，包括服务名称、唯一标识符和指向详细信息的链接。

名称	路径	类型	说明
服务链接	link	string	指向有关运行状况服务的详细信息的完全限定链接。
服务名称	name	string	设施提供的运行状况服务的名称。
服务编号	serviceId	string	运行状况服务的唯一标识符，可用于以编程方式引用服务。

ServiceInfo

有关设施提供的服务的基本信息，包括服务类型和标识符。

名称	路径	类型	说明
服务名称	name	string	提供的服务的名称。
服务编号	serviceId	string	服务的唯一标识符。
服务类型	serviceType	string	提供的服务类别（例如健康、权益）。

ServiceOtherService

提供有关不属于标准运行状况或权益类别的设施提供的其他服务类型的信息。

名称	路径	类型	说明
服务链接	link	string	指向有关服务的详细信息的 URL。
服务名称	name	string	提供的服务的名称。
服务编号	serviceId	string	服务的唯一标识符。

Services

VA 设施提供的所有服务的综合列表，按类型分类，如权益、运行状况和其他服务。

名称	路径	类型	说明
Benefits Services	benefits	array of ServiceBenefitsService	与设施提供的好处相关的服务集合。
Health Services	health	array of ServiceHealthService	设施提供的与运行状况相关的服务的集合。
上次更新时间	lastUpdated	string	服务信息最近更新的日期。
服务链接	link	string	用于访问设施中有关服务的详细信息的基 URL。
其他服务	other	array of ServiceOtherService	该设施提供的其他服务列表，这些服务不属于健康或福利。

SupplementalStatus

VA 设施的其他状态信息，除了基本作状态之外，还提供更具体的详细信息。

名称	路径	类型	说明
状态 ID	id	string	补充状态的唯一标识符。
状态标签	label	string	补充状态的描述性标签，用人工可读术语解释其含义。

通过

退伍军人事务设施 （独立出版商） （预览版）