Reference: OperationOutcome Errors
Understand FHIR OperationOutcome responses returned by DDFS endpoints.
OperationOutcome Responses
DDFS returns a FHIR OperationOutcome when an error response has a FHIR-formatted body. Review issue.severity, issue.code, details, and diagnostics to identify the cause.
FHIR canonical definition: http://hl7.org/fhir/StructureDefinition/OperationOutcome
Common HTTP Status Codes
| Status | Typical meaning |
|---|---|
| 400 | Malformed input, an unsupported parameter value, or a malformed If-Match header. |
| 401 | Missing, expired, or invalid bearer token. |
| 403 | The token does not grant the required scope. |
| 404 | The requested resource was not found or is not visible to the caller. |
| 409 | The request conflicts with the current resource state. |
| 410 | The requested resource has been deleted. |
| 412 | The supplied If-Match condition does not match the current resource version or requires a resource that does not exist. The PUT is not applied. Read the current resource, reconcile the intended change, and retry with its current ETag. |
| 422 | The resource violates validation or business rules. |
| 429 | The request was throttled. |
| 500 | An unexpected server error occurred. |
| 503 | The service is temporarily unavailable. |
Example
(application/fhir+json)
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "invalid",
"details": {
"text": "Invalid parameter value."
}
}
]
}