使用 OAuth 2.0 从 Epic FHIR API 检索已安排的约会以及参与者和位置详细信息

Question

作为与 Epic FHIR 的 API 集成以访问预定约会的开发人员，确保通过 OAuth 2.0 进行安全身份验证至关重要。预定的预约表示医疗保健生态系统中关键的患者互动，需要精确的检索机制。在 Epic FHIR 沙箱环境中成功获取客户凭据并通过 OAuth 2.0 进行身份验证后，当前的工作是获取与特定物理位置（例如医院或诊所）相关的预约列表，同时获取全面的参与者详细信息，包括医生、临床医生和患者。

如何利用 Epic FHIR 增强请求有效负载或引入附加参数来检索指定物理位置（例如医院或诊所）的预定预约列表，同时捕获详细的参与者信息（例如医生、临床医生和患者） API？

开发的应用程序有效地获取客户端凭据并通过 Epic FHIR API 端点进行 OAuth 2.0 身份验证 (

https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

)。尽管拥有有效的访问令牌，但获取针对特定物理位置（例如医院或诊所）定制的预约列表仍然存在挑战。此外，还需要将医生、临床医生和患者等参与者详细信息纳入检索到的预约数据中。

请求负载示例：

{ 

    "resourceType": "Parameters", 

    "parameter": [ 

        { 

            "name": "patient", 

            "resource": { 

                "resourceType": "Patient", 

                "active": true, 

                "communication": [ 

                    { 

                        "language": { 

                            "coding": [ 

                                { 

                                    "system": "http://hl7.org/fhir/ValueSet/languages", 

                                    "code": "en", 

                                    "display": "English" 

                                } 

                            ], 

                            "text": "English" 

                        }, 

                        "preferred": "true" 

                    } 

                ] 

            } 

        }, 

        { 

            "name": "startTime", 

            "valueDateTime": "2024-01-01T00:00:00Z" 

        }, 

        { 

            "name": "endTime", 

            "valueDateTime": "2024-09-01T23:59:59Z" 

        }, 

        { 

            "name": "serviceType", 

            "valueCodeableConcept": { 

                "coding": [ 

                    { 

                        "system": "urn:oid:1.2.840.114350.1.13.0.1.7.3.808267.11", 

                        "code": "95014", 

                        "display": "Office Visit" 

                    } 

                ] 

            } 

        }, 

        { 

            "name": "indications" 

        }, 

        { 

            "name": "location-reference", 

            "valueReference": { 

                "reference": "https://apporchard.epic.com/interconnect-aocurprd-oauth/api/FHIR/STU3/Location/e4W4rmGe9QzuGm2Dy4NBqVc0KDe6yGld6HW95UuN-Qd03" 

            } 

        } 

    ] 

} 

有关在请求有效负载中合并特定于位置的过滤器或参数的见解或建议将非常有益。此外，我们将非常感谢有关利用 Epic FHIR API 功能准确定位与参与者详细信息和特定医院或诊所位置相关的预约列表的指导。

Answer 1

用于搜索可用预约空档 (Appointment.$find) 的 Epic FHIR API 的功能和支持的输入高度依赖于您所连接的 Epic 系统内的配置。过滤初始请求的确切方法将取决于该配置。您最好的方法是与卫生系统合作，了解其配置和可用选项。

在 Epic on FHIR 沙箱中，您可以在请求负载中使用

location-reference

和

serviceType

元素，如示例中所示。有关特定时间表、时段、从业者等的详细信息可通过相应的读取 API（例如 Schedule.Read、Slot.Read、Practitioner.Read）获得，并且这些资源的 FHIR ID 将在对约会的响应中。 $查找操作。