Dit lijstje bestaat al, nu te vinden op verschillende TO's (niet alle) en zou wat mij betreft beter naar de overkoepelende pagina kunnen om duplicatie te verminderen:

4.2.2 Handling errors[bewerken]

If the search fails (cannot be executed, not that there are no matches), the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

• 400 Bad Request - search could not be processed or failed basic FHIR validation rules

• 401 Not Authorized - authorization is required for the interaction that was attempted

• 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

• A parameter may refer to a non-existent resource e.g. GET [base]/Observation?subject=101, where "101" does not exist

• A parameter may refer to an unknown code e.g. GET [base]/Observation?code=loinc|1234-1, where the LOINC code "1234-1" is not known to the server

• A parameter may refer to a time that is out of scope e.g. GET [base]/Condition?onset=le1995, where the system only has data going back to 2001

• A parameter may use an illegal or unacceptable modifier e.g. GET [base]/Condition?onset:text=1995, where the modifier cannot be processed by the server

• A date/time parameter may have incorrect format e.g. GET [base]/Condition?onset=23%20May%202009

• A parameter may be unknown or unsupported

Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

De tekst op de hoofdpagina zou sterk kunnen aanmoedigen op correct gebruik van foutcodes én juiste manier van de OperationOutcome. Goed gebruik hiervan zal voor zowel DVP als DVZA ten goede komen. Hierbij kan gedacht worden aan het gebruik van een juiste .location.

Verdere aanvullingen vanuit VZVZ:

Daarnaast misschien ook handig om op een generieke pagina, consistent over alle gegevensdiensten heen, aan te geven wat een resource server moet doen in geval:

• een FHIR resource niet behoort tot de gegevensdienst of niet wordt ondersteund (OperationOutcome met foutcode "not supported").

• een FHIR zoekparameter niet is gespecificeerd binnen de gegevensdienst of niet wordt ondersteund (OperationOutcome met foutcode "not supported”).

• een verplichte FHIR zoekparameter ontbreekt (OperationOutcome met de foutcode "required").

• een FHIR zoekparameter een ongeldige waarde heeft (OperationOutcome met foutcode "value").

• gewenst gedrag bij niet ondersteuning van een zoekparameter

 __ 

De aanzet voor meer inhoud bij dit issue wordt via meetings die door VZVZ worden georganiseerd, vergaard.