Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Ricerca di risorse FHIR con POST
Puoi utilizzare l'searchinterazione FHIR con POST le richieste di ricerca in un archivio HealthLake dati. Quando si utilizzaPOST, HealthLake supporta i parametri di ricerca nell'URL o nel corpo di una richiesta, ma non è possibile utilizzarli entrambi in una singola richiesta.
Per le ricerche che coinvolgono informazioni di identificazione personale (PII) o informazioni sanitarie protette (PHI), le migliori pratiche di sicurezza richiedono l'utilizzo delle POST richieste, poiché PII e PHI vengono aggiunti come parte del corpo della richiesta e vengono crittografati durante il transito.
La procedura seguente è seguita da esempi che utilizzano l'interazione FHIR R4 search con per effettuare ricerche in un archivio dati. POST HealthLake Gli esempi mostrano come specificare i parametri di ricerca nel corpo della richiesta JSON.
Per effettuare ricerche in un archivio HealthLake dati con POST
-
Raccogli HealthLake region e datastoreId valorizza. Per ulteriori informazioni, consulta Ottenere le proprietà dell'archivio dati.
-
Determina il tipo di risorsa FHIR da cercare e raccogliere il id valore associato. Per ulteriori informazioni, consulta Tipi di risorsa.
-
Costruisci un URL per la richiesta utilizzando i valori raccolti per HealthLake region e. datastoreId Includi anche il Resource tipo e _search l'interazione FHIR. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante Copia.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/_search
-
Costruisci un corpo JSON per la richiesta, specificando i dati FHIR da cercare. Ai fini di questa procedura, cercherai Observation risorse per scoprire pazienti che non hanno mai fumato. Per specificare lo stato del codice medicoNever smoker, impostalo value-concept=266919005 nel corpo della richiesta JSON. Salva il file con nome search-observation.json.
value-concept=266919005
-
Inviare la richiesta . L'searchinterazione FHIR utilizza la GET richiesta con l'autorizzazione AWS Signature Version 4 o SMART on FHIR.
Quando si effettua una POST richiesta con parametri di ricerca nel corpo della richiesta, usala Content-Type: application/x-www-form-urlencoded come parte dell'intestazione.
L'curlesempio seguente effettua una richiesta di ricerca basata su POST sul tipo di Observation risorsa. La richiesta utilizza il parametro value-conceptdi ricerca per cercare il codice medico 266919005 che indichi il valoreNever smoker. Per visualizzare l'intero esempio, scorri il pulsante Copia.
- SigV4
-
Autorizzazione SIGv4
curl --request POST \
'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search' \
--aws-sigv4 'aws:amz:region:healthlake' \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
--header "x-amz-security-token:$AWS_SESSION_TOKEN" \
--header "Content-Type: application/x-www-form-urlencoded"
--header "Accept: application/json"
--data @search-observation.json
- SMART on FHIR
-
Esempio di autorizzazione SMART on FHIR per il tipo di dati IdentityProviderConfiguration.
{
"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\"]}"
}
Il chiamante può assegnare le autorizzazioni nella lambda di autorizzazione. Per ulteriori informazioni, consulta OAuth Cannocchiali 2.0.
Esempi: ricerca con POST
Le schede seguenti forniscono esempi per la ricerca su tipi di risorse FHIR specifici con. POST Gli esempi mostrano come specificare una richiesta in. URLs
La HealthLake console supporta solo l'autorizzazione SIGv4. L'autorizzazione SMART on FHIR è supportata tramite e. AWS CLI AWS SDKs
HealthLake supporta un sottoinsieme di parametri di ricerca FHIR R4. Per ulteriori informazioni, consulta Parametri di ricerca.
- Patient (age)
-
Sebbene l'età non sia un tipo di risorsa definito in FHIR, viene acquisita come elemento del tipo di risorsa. Patient Utilizzate l'esempio seguente per effettuare una richiesta di ricerca POST basata sul tipo di Patient risorsa. L'esempio di ricerca seguente utilizza il eq comparatore di ricerca per cercare persone nate nel 1997.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient/_search
Per specificare l'anno 1997 nella ricerca, aggiungete il seguente elemento al corpo della richiesta.
birthdate=eq1997
- Condition
-
Utilizzare quanto segue per effettuare una POST richiesta sul tipo di Condition risorsa. Questa ricerca consente di trovare le posizioni nell'archivio HealthLake dati che contengono il codice medico72892002.
È necessario specificare l'URL della richiesta e il corpo della richiesta. Ecco un esempio di URL di richiesta.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition/_search
Per specificare il codice medico da cercare, aggiungi il seguente elemento JSON al corpo della richiesta.
code=72892002
- DocumentReference
-
Per visualizzare i risultati dell'elaborazione integrata HealthLake del linguaggio naturale (NLP) quando si effettua una POST richiesta sul tipo di DocumentReference risorsa, formatta una richiesta come segue.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference/_search
Per specificare i parametri di DocumentReference ricerca a cui fare riferimento, vedere. Tipi di parametri di ricerca La seguente stringa di query utilizza più parametri di ricerca per cercare nelle operazioni dell'API Amazon Comprehend Medical utilizzate per generare i risultati NLP integrati.
_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
- Location
-
Usa l'esempio seguente per effettuare una POST richiesta sul tipo di risorsa. Location La ricerca trova le posizioni nell'archivio HealthLake dati che contengono il nome della città Boston come parte dell'indirizzo.
È necessario specificare un URL e un corpo della richiesta. Ecco un esempio di URL di richiesta.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location/_search
Per specificare Boston nella ricerca, aggiungi il seguente elemento al corpo della richiesta:
address=Boston
- Observation
-
Utilizzate l'esempio seguente per effettuare una richiesta di ricerca POST basata sul tipo di Observation risorsa. La ricerca utilizza il parametro value-concept di ricerca per cercare il codice medico, 266919005 che indicaNever smoker.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search
Per specificare lo statoNever smoker, imposta value-concept=266919005 nel corpo del file JSON.
value-concept=266919005
