Azure API for FHIR에서 FHIR API 테스트

아티클
12/04/2024

Important

Azure API for FHIR은 2026년 9월 30일에 사용 중지됩니다. 해당 날짜까지 마이그레이션 전략에 따라 Azure Health Data Services FHIR® 서비스로 전환합니다. Azure API for FHIR의 사용 중지로 인해 2025년 4월 1일부터 신규 배포가 허용되지 않습니다. Azure Health Data Services FHIR 서비스는 고객이 다른 Azure 서비스에 통합하여 FHIR, DICOM 및 MedTech 서비스를 관리할 수 있도록 하는 Azure API for FHIR의 진화된 버전입니다.

이전 자습서에서는 Azure API for FHIR®을 배포하고 클라이언트 애플리케이션을 등록했습니다. 이제 Azure API for FHIR을 테스트할 준비가 되었습니다.

capability 문 검색

먼저 Azure API for FHIR에 대한 기능 문을 가져옵니다.

Postman을 엽니다.
를 사용하여 GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadatacapability 문을 검색합니다. 아래 이미지에서 FHIR 서버 이름은 fhirserver입니다.

기능 문

다음으로 환자를 검색하려고 합니다. 환자를 GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient검색하려면 . 환자 데이터에 액세스할 수 있어야 한다는 것을 입증하지 못했기 때문에 오류가 발생 401 Unauthorized 합니다.

실패한 환자

FHIR 서버에서 환자 받기

액세스 권한을 얻으려면 액세스 토큰이 필요합니다.

Postman에서 권한 부여를 선택하고 형식을 OAuth2.0으로 설정합니다.
새 액세스 토큰 가져오기를 선택합니다.
필드를 입력하고 요청 토큰을 선택합니다. 아래에서 이 자습서의 각 필드에 대한 값을 확인할 수 있습니다.

필드	값
토큰 이름	토큰에 대한 이름
권한 부여 유형	인증 코드
콜백 URL	https://www.getpostman.com/oauth2/callback
인증 URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com
액세스 토큰 URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
클라이언트 ID	이전 단계에서 복사한 클라이언트 ID
클라이언트 암호	<BLANK>
범위	<BLANK>
State(상태)	1234
클라이언트 인증	본문에서 클라이언트 자격 증명 보내기

자격 증명을 사용하여 로그인하고 수락을 선택합니다.
결과에서 아래로 스크롤하고 토큰 사용을 선택합니다.
맨 위에서 다시 보내기를 선택하면 이번에는 결과가 표시됩니다.

성공 환자

FHIR 서버에 환자 게시

이제 액세스 권한이 있으므로 새 환자를 만들 수 있습니다. 다음은 FHIR 서버에 추가할 수 있는 간단한 환자 샘플입니다. Postman의 본문 섹션에 json을 입력합니다.

    {
        "resourceType": "Patient",
        "active": true,
        "name": [
            {
                "use": "official",
                "family": "Kirk",
                "given": [
                    "James",
                    "Tiberious"
                ]
            },
            {
                "use": "usual",
                "given": [
                    "Jim"
                ]
            }
        ],
        "gender": "male",
        "birthDate": "1960-12-25"
    }

이 POST는 FHIR 서버에 제임스 티베리어스 커크라는 이름의 새 환자를 만듭니다.

환자 게시

GET 명령을 사용하여 환자를 다시 검색하는 경우 출력에 제임스 Tiberious Kirk가 나열됩니다.

참고 항목

Azure API for FHIR에 요청을 보낼 때 content-type 헤더를 application/json으로 설정했는지 확인해야 합니다.

액세스 문제 해결

Postman에서 환자 리소스에 액세스하는 동안 403 오류가 발생했습니다.

FHIR 기여자 역할이 할당되었는지 확인합니다. 그렇지 않으면 Azure Health Data Services에 FHIR 기여자 역할을 추가합니다. AHDS에 대한 Azure RBAC 역할 구성

이러한 단계를 수행하는 동안 문제가 발생한 경우 Microsoft Entra ID 및 Azure API for FHIR에 대해 함께 제공된 문서를 검토하세요.

Microsoft Entra ID 및 Azure API for FHIR - 이 문서에서는 Microsoft Entra ID의 기본 원칙과 Azure API for FHIR과 상호 작용하는 방법을 설명합니다.
액세스 토큰 유효성 검사 - 이 방법 가이드는 액세스 토큰 유효성 검사 및 액세스 문제를 해결하기 위해 수행해야 하는 단계에 대한 구체적인 정보를 제공합니다.

다음 단계

이제 클라이언트 애플리케이션에 성공적으로 연결할 수 있으므로 웹 애플리케이션을 작성할 준비가 되었습니다.

웹 애플리케이션 작성