ValidateCodeSystemCode

Summary

A REST operation implemented by the Terminology service that validates a code against a code system using terminology artifacts loaded in memory to support high performance.

The validation code operation complies with the FHIR Operation $validate-code on CodeSystem specification.

The implementation of this operation is almost identical to the $validate-code operation on ValueSet. The "system" parameter is not required, in this case, because the code system is explicitly identified in the URL.

Example Requests

Using query parameters with the CodeSystem identified in the path of the URL

POST {{terminology-api-base}}/api/terminology/fhir/CodeSystem/address-type/$validate-code?code=physical

Using query parameters

Note: The "url" query parameter often has special characters that must be URL-encoded, as in this example.

POST {{terminology-api-base}}/api/terminology/fhir/CodeSystem/$validate-code?url=http%3A%2F%2Fhl7.org%2Ffhir%2Faddress-type&code=physical

Example Response

Good/valid response

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "result",
            "valueBoolean": true
        }
    ]
}

Bad/invalid response

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "result",
            "valueBoolean": false
        },
        {
            "name": "message",
            "valueString": "Code not found in code system"
        }
    ]
}

flowchart LR
nValidateCodeSystemCode_20E1E2AA["Command: Validate CodeSystem Code"]
  nValidationService_6640600D["Service: ValidationService"] -->|sends| nValidateCodeSystemCode_20E1E2AA
  nValidateCodeSystemCode_20E1E2AA -->|handled by| nTerminologyService_2123EB9E["Service: TerminologyService"]
  subgraph nCompliance_11EAF98F_domain["Domain: Compliance"]
    nValidateCodeSystemCode_20E1E2AA
    nValidationService_6640600D
  end
  subgraph nKnowledgeArtifactManagement_6717624D_domain["Domain: Knowledge Artifact Management"]
    nTerminologyService_2123EB9E
  end

Relationships

flowchart LR
nValidateCodeSystemCode_20E1E2AA["Command: Validate CodeSystem Code"]
  nValidationService_6640600D["Service: ValidationService"] -->|sends| nValidateCodeSystemCode_20E1E2AA
  nValidateCodeSystemCode_20E1E2AA -->|handled by| nTerminologyService_2123EB9E["Service: TerminologyService"]
  subgraph nCompliance_11EAF98F_domain["Domain: Compliance"]
    nValidateCodeSystemCode_20E1E2AA
    nValidationService_6640600D
  end
  subgraph nKnowledgeArtifactManagement_6717624D_domain["Domain: Knowledge Artifact Management"]
    nTerminologyService_2123EB9E
  end