Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mencari sumber daya FHIR dengan GET
Anda dapat menggunakan GET permintaan untuk mencari penyimpanan HealthLake data. Saat menggunakanGET, HealthLake mendukung penyediaan parameter pencarian sebagai bagian dari URL, tetapi bukan sebagai bagian dari badan permintaan. Untuk informasi selengkapnya, lihat Parameter pencarian FHIR R4 untuk HealthLake.
Untuk pencarian yang melibatkan informasi identitas pribadi (PII) atau informasi kesehatan yang dilindungi (PHI), praktik terbaik keamanan memerlukan penggunaan POST permintaan, karena PII dan PHI ditambahkan sebagai bagian dari badan permintaan dan dienkripsi dalam perjalanan. Untuk informasi selengkapnya, lihat Mencari sumber daya FHIR dengan POST.
Prosedur berikut diikuti oleh contoh yang digunakan GET untuk mencari penyimpanan HealthLake data.
Untuk mencari penyimpanan HealthLake data dengan GET
-
Kumpulkan HealthLake region dan datastoreId nilai. Untuk informasi selengkapnya, lihat Mendapatkan properti penyimpanan data.
-
Tentukan jenis sumber daya FHIR untuk mencari dan mengumpulkan id nilai terkait. Untuk informasi selengkapnya, lihat Jenis sumber daya.
-
Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake region dandatastoreId. Juga termasuk Resource jenis FHIR dan parameter pencarian yang didukung. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol Salin.
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
-
Kirim GET permintaan dengan AWS Signature Version 4 atau SMART pada otorisasi FHIR. curlContoh berikut mengembalikan jumlah total sumber Patient daya dalam penyimpanan HealthLake data. Untuk melihat seluruh contoh, gulir ke atas tombol Salin.
- SigV4
-
Otorisasi SiGv4
curl --request GET \
'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?_total=accurate' \
--aws-sigv4 'aws:amz:region:healthlake' \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
--header "x-amz-security-token:$AWS_SESSION_TOKEN" \
--header 'Accept: application/json'
- SMART on FHIR
-
SMART pada contoh otorisasi FHIR untuk tipe IdentityProviderConfigurationdata.
{
"AuthorizationStrategy": "SMART_ON_FHIR",
"FineGrainedAuthorizationEnabled": true,
"IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
"Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}
Penelepon dapat menetapkan izin di lambda otorisasi. Untuk informasi selengkapnya, lihat OAuth 2.0 cakupan.
- AWS Console
-
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
1. Masuk ke halaman Jalankan kueri di HealthLake Konsol.
2. Di bawah bagian Pengaturan kueri, buat pilihan berikut.
-
ID Penyimpanan Data — pilih ID penyimpanan data untuk menghasilkan string kueri.
-
Jenis kueri - pilihSearch
with GET.
-
Jenis sumber daya - pilih jenis sumber daya FHIR untuk dicari.
-
Parameter pencarian — Pilih parameter pencarian atau kombinasi parameter pencarian untuk memfokuskan kueri Anda pada catatan tertentu.
3. Pilih Run query (Jalankan kueri).
Contoh: cari dengan GET
Tab berikut memberikan contoh untuk mencari pada jenis sumber daya FHIR tertentu dengan. GET Contoh menunjukkan cara menentukan parameter pencarian dalam permintaan URLs.
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
HealthLake mendukung subset parameter pencarian FHIR R4. Untuk informasi selengkapnya, lihat Parameter pencarian.
- Patient (age)
-
Meskipun usia bukan tipe sumber daya yang ditentukan di FHIR, ia ditangkap sebagai elemen dalam tipe Patientsumber daya. Gunakan contoh berikut untuk membuat permintaan pencarian GET berbasis pada jenis Patientsumber daya menggunakan elemen BirthDate dan pembanding eq pencarian untuk mencari individu yang lahir pada tahun 1997.
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
- Condition
-
Gunakan contoh berikut untuk membuat GET permintaan pada jenis Conditionsumber daya. Pencarian menemukan kondisi di penyimpanan HealthLake data Anda yang berisi kode medis SNOMED72892002, yang diterjemahkan menjadi. Normal pregnancy
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
- DocumentationReference
-
Contoh berikut menunjukkan cara membuat GET permintaan pada jenis DocumentReferencesumber daya untuk Patient (s) dengan diagnosis streptokokus dan yang juga telah diresepkan amoksisilin.
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference?_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
- Location
-
Gunakan contoh berikut untuk membuat GET permintaan pada jenis Locationsumber daya. Pencarian berikut menemukan lokasi di toko HealthLake data Anda yang berisi nama kota Boston sebagai bagian dari alamat.
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
- Observation
-
Gunakan contoh berikut untuk membuat permintaan pencarian GET berbasis pada jenis Observationsumber daya. Pencarian ini menggunakan parameter value-concept pencarian untuk mencari kode medis266919005, yang diterjemahkan menjadiNever smoker.
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
