Verification Relation PDS - Secrétaire

Général

Ce service permet de définir si un(e) secrétaire donnée travaille pour un Professionel de Santé donné

Mécanisme d'authentification

OIDC + MTLS

Path

/hpd/api/careteam/$checkPDS-Sec

Input

• L'identité de la secrétaire est récupérée via OIDC
• L'identité du professionnel de santé est fournie par un paramètre "participant.identifier" dans le body de la requête.
  La requête POST est soumise en "application/x-www-form-urlencoded"
  
  

Exemple:

participant.identifier=urn:oid:1.3.182.4.6|<code-CNS/gp-code>

⚠️ Attention : Le code CNS/GP code doit être fourni au format NNNNNN-NN

Exemple de trame HTTP:

POST /hpd/api/careteam/$checkPDS-Sec HTTP/1.1  
Content-Type: application/x-www-form-urlencoded  
User-Agent: PostmanRuntime/7.47.1  
Accept: */*  
Postman-Token: 1dc0fcf1-aacd-483f-962e-8c6ea6c025a1  
Host: <host>:<port>  
Accept-Encoding: gzip, deflate, br  
Connection: keep-alive  
Content-Length: 64  
  
participant.identifier=urn%3Aoid%3A1.3.182.4.6%7C%3CcodeCNS%3E  

Retour

En cas de réponse positive, un code HTTP-200 est retourné
En cas de réponse négative, un code HTTP-4xx est retourné

Dans les 2 cas, une resource FHIR OperationOutcome est retournée

Exemple de retour en cas de réponse positive

{
  "resourceType": "OperationOutcome",
  "meta": {
    "profile": [
      "https://www.esante.lu/fhir-spec/StructureDefinition/HPDCheckResult"
    ]
  },
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "details": {
        "text": "Verification successful"
      }
    }
  ]
}

Exemple de retour en cas de réponse négative

{
  "resourceType": "OperationOutcome",
  "meta": {
    "profile": [
      "https://www.esante.lu/fhir-spec/StructureDefinition/HPDCheckResult"
    ]
  },
  "issue": [
    {
      "severity": "error",
      "code": "security",
      "details": {
        "coding": [
          {
            "system": "https://www.esante.lu/fhir-spec/CodeSystem/ESanteOODetails",
            "code": "TO_BE_DEFINED"
          }
        ],
        "text": "Active link not found from PDS xxxxx and SEC xxxxxx"
      }
    }
  ]
}

Error

Principaux codes d'erreurs métiers: