System API (latest)
Purpose
This specification describes service endpoints, resources and operations as well as details of requests and responses that interacts with System openEHR API in a RESTful manner.
Related Documents
Prerequisite documents for reading this document include:
Related documents include:
- The openEHR Global Class Index
- The XML-Schemas (XSD)
- The JSON-Schemas and Simplified Data Template (SDT)
- The openEHR Platform Abstract Service Model
Status
This specification is in the STABLE state, and can be downloaded as OpenAPI specification file (in YAML format) for validation, or for code generators.
Users are encouraged to comment on and/or advise on these paragraphs as well as the main content.
The development version of this document can be found at https://specifications.openehr.org/releases/ITS-REST/development/system.html.
Options and Conformance
The OPTIONS HTTP method allows a client to determine the options and/or requirements associated with a resource, service or with the system, without implying a resource action.
Services SHOULD respond to this method with the appropriate HTTP codes, headers and potentially with a payload revealing more details about themselves.
Another use-case for this method is related to exposing service capabilities for a conformance manifest.
Responses
Response samples
- 200
{- "solution": "openEHRSys",
- "solution_version": "v1.0",
- "vendor": "My-openEHR",
- "restapi_specs_version": "1.1.0",
- "conformance_profile": "STANDARD",
- "endpoints": [
- "/ehr",
- "/demographic",
- "/definition",
- "/query"
]
}