Fonctionnement du FHIR R4 $attribution-status pour HealthLake - AWS HealthLake
EndpointParamètres de demandeExemple de demandeRéponseGestion des erreursAutorisation et sécurité

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Fonctionnement du FHIR R4 $attribution-status pour HealthLake

Récupère le statut d'attribution d'un membre spécifique, renvoyant un bundle contenant toutes les ressources d'attribution liées au patient. Cette opération fait partie de la mise en œuvre de la version 2.1.0 de la liste d'attribution des membres FHIR (ATR) List IG.

Endpoint

POST [base]/Group/[id]/$attribution-status

Paramètres de demande

L'opération accepte les paramètres facultatifs suivants :

Paramètre Type Description
memberId Identifiant Le MemberId membre pour lequel le statut d'attribution est demandé
Référence du patient Référence Référence à la ressource pour les patients dans le système du producteur
Note

L'un memberId ou l'autre patientReference peut être fourni, ou les deux à des fins de validation.

Exemple de demande

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "memberId",
      "valueIdentifier": {
        "system": "http://example.org",
        "value": "MBR123456789"
      }
    },
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/patient-123",
        "display": "John Doe"
      }
    }
  ]
}

Réponse

Renvoie un bundle contenant des ressources d'attribution liées au patient :

Ressource Cardinalité Emplacement
Patient 1..1 Groupe.membre/entité
Couverture 0,1 Group.Member.Extension : CoverageReference
Organization/Practitioner/PractitionerRole 0,1 group.member.extension : fournisseur attribué
N'importe quelle ressource 0,1 group.member.extension : données associées

Exemple de réponse

{
  "resourceType": "Bundle",
  "id": "bundle-response",
  "meta": {
    "lastUpdated": "2014-08-18T01:43:33Z"
  },
  "type": "collection",
  "entry": [
    {
      "fullUrl": "http://example.org/fhir/Patient/12423",
      "resource": {
        "resourceType": "Patient",
        "id": "12423",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2014-08-18T01:43:31Z"
        },
        "active": true,
        "name": [
          {
            "use": "official",
            "family": "Chalmers",
            "given": ["Peter", "James"]
          }
        ],
        "gender": "male",
        "birthDate": "1974-12-25"
      }
    },
    {
      "fullUrl": "http://example.org/fhir/Coverage/123456",
      "resource": {
        "resourceType": "Coverage",
        "id": "1"
        // ... additional Coverage resource details
      }
    },
    {
      "fullUrl": "http://example.org/fhir/Organization/666666",
      "resource": {
        "resourceType": "Organization",
        "id": "2"
        // ... additional Organization resource details
      }
    }
  ]
}

Gestion des erreurs

L'opération gère les conditions d'erreur suivantes :

Erreur État du protocole HTTP Description
Demande d'opération non valide 400 Paramètres ou structure de demande non conformes
Ressource de groupe introuvable 404 L'ID de groupe spécifié n'existe pas
Ressource pour les patients introuvable 404 La référence du patient spécifiée n'existe pas

Autorisation et sécurité

Exigences relatives à SMART Scope

Les clients doivent disposer des privilèges appropriés pour lire les ressources du groupe et les ressources d'attribution associées

Les mécanismes d'autorisation FHIR standard s'appliquent à toutes les opérations