This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3
Vocabulary Work Group | Maturity Level: N/A | Ballot Status: Informative |
Definition for Code System FHIR Restful Interactions
<CodeSystem xmlns="http://hl7.org/fhir"> <id value="restful-interaction"/> <meta> <lastUpdated value="2019-10-24T11:53:00+11:00"/> </meta> <text> <status value="generated"/> <div xmlns="http://www.w3.org/1999/xhtml"> <h2> FHIR Restful Interactions</h2> <div> <p> The set of interactions defined by the RESTful part of the FHIR specification.</p> </div> <p> This code system http://hl7.org/fhir/restful-interaction defines the following codes:</p> <table class="codes"> <tr> <td> <b> Lvl</b> </td> <td> <b> Code</b> </td> <td> <b> Display</b> </td> <td> <b> Definition</b> </td> </tr> <tr> <td> 1</td> <td> read <a name="restful-interaction-read"> </a> </td> <td> read</td> <td> Read the current state of the resource.</td> </tr> <tr> <td> 1</td> <td> vread <a name="restful-interaction-vread"> </a> </td> <td> vread</td> <td> Read the state of a specific version of the resource.</td> </tr> <tr> <td> 1</td> <td> update <a name="restful-interaction-update"> </a> </td> <td> update</td> <td> Update an existing resource by its id (or create it if it is new).</td> </tr> <tr> <td> 1</td> <td> patch <a name="restful-interaction-patch"> </a> </td> <td> patch</td> <td> Update an existing resource by posting a set of changes to it.</td> </tr> <tr> <td> 1</td> <td> delete <a name="restful-interaction-delete"> </a> </td> <td> delete</td> <td> Delete a resource.</td> </tr> <tr> <td> 1</td> <td> history <a name="restful-interaction-history"> </a> </td> <td> history</td> <td> Retrieve the change history for a particular resource, type of resource, or the entire system.</td> </tr> <tr> <td> 2</td> <td> history-instance <a name="restful-interaction-history-instance"> </a> </td> <td> history-instance</td> <td> Retrieve the change history for a particular resource.</td> </tr> <tr> <td> 2</td> <td> history-type <a name="restful-interaction-history-type"> </a> </td> <td> history-type</td> <td> Retrieve the change history for all resources of a particular type.</td> </tr> <tr> <td> 2</td> <td> history-system <a name="restful-interaction-history-system"> </a> </td> <td> history-system</td> <td> Retrieve the change history for all resources on a system.</td> </tr> <tr> <td> 1</td> <td> create <a name="restful-interaction-create"> </a> </td> <td> create</td> <td> Create a new resource with a server assigned id.</td> </tr> <tr> <td> 1</td> <td> search <a name="restful-interaction-search"> </a> </td> <td> search</td> <td> Search a resource type or all resources based on some filter criteria.</td> </tr> <tr> <td> 2</td> <td> search-type <a name="restful-interaction-search-type"> </a> </td> <td> search-type</td> <td> Search all resources of the specified type based on some filter criteria.</td> </tr> <tr> <td> 2</td> <td> search-system <a name="restful-interaction-search-system"> </a> </td> <td> search-system</td> <td> Search all resources based on some filter criteria.</td> </tr> <tr> <td> 1</td> <td> capabilities <a name="restful-interaction-capabilities"> </a> </td> <td> capabilities</td> <td> Get a Capability Statement for the system.</td> </tr> <tr> <td> 1</td> <td> transaction <a name="restful-interaction-transaction"> </a> </td> <td> transaction</td> <td> Update, create or delete a set of resources as a single transaction.</td> </tr> <tr> <td> 1</td> <td> batch <a name="restful-interaction-batch"> </a> </td> <td> batch</td> <td> perform a set of a separate interactions in a single http operation</td> </tr> <tr> <td> 1</td> <td> operation <a name="restful-interaction-operation"> </a> </td> <td> operation</td> <td> Perform an operation as defined by an OperationDefinition.</td> </tr> </table> </div> </text> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-ballot-status"> <valueString value="Informative"/> </extension> <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm"> <valueInteger value="0"/> </extension> <url value="http://hl7.org/fhir/restful-interaction"/> <name value="FHIR Restful Interactions"/> <status value="draft"/> <publisher value="FHIR Project"/> <description value="The set of interactions defined by the RESTful part of the FHIR specification."/> <caseSensitive value="true"/> <valueSet value="http://hl7.org/fhir/ValueSet/restful-interaction"/> <hierarchyMeaning value="is-a"/> <content value="complete"/> <concept> <code value="read"/> <display value="read"/> <definition value="Read the current state of the resource."/> </concept> <concept> <code value="vread"/> <display value="vread"/> <definition value="Read the state of a specific version of the resource."/> </concept> <concept> <code value="update"/> <display value="update"/> <definition value="Update an existing resource by its id (or create it if it is new)."/> </concept> <concept> <code value="patch"/> <display value="patch"/> <definition value="Update an existing resource by posting a set of changes to it."/> </concept> <concept> <code value="delete"/> <display value="delete"/> <definition value="Delete a resource."/> </concept> <concept> <code value="history"/> <display value="history"/> <definition value="Retrieve the change history for a particular resource, type of resource, or the entire system."/> <concept> <code value="history-instance"/> <display value="history-instance"/> <definition value="Retrieve the change history for a particular resource."/> </concept> <concept> <code value="history-type"/> <display value="history-type"/> <definition value="Retrieve the change history for all resources of a particular type."/> </concept> <concept> <code value="history-system"/> <display value="history-system"/> <definition value="Retrieve the change history for all resources on a system."/> </concept> </concept> <concept> <code value="create"/> <display value="create"/> <definition value="Create a new resource with a server assigned id."/> </concept> <concept> <code value="search"/> <display value="search"/> <definition value="Search a resource type or all resources based on some filter criteria."/> <concept> <code value="search-type"/> <display value="search-type"/> <definition value="Search all resources of the specified type based on some filter criteria."/> </concept> <concept> <code value="search-system"/> <display value="search-system"/> <definition value="Search all resources based on some filter criteria."/> </concept> </concept> <concept> <code value="capabilities"/> <display value="capabilities"/> <definition value="Get a Capability Statement for the system."/> </concept> <concept> <code value="transaction"/> <display value="transaction"/> <definition value="Update, create or delete a set of resources as a single transaction."/> </concept> <concept> <code value="batch"/> <display value="batch"/> <definition value="perform a set of a separate interactions in a single http operation"/> </concept> <concept> <code value="operation"/> <display value="operation"/> <definition value="Perform an operation as defined by an OperationDefinition."/> </concept> </CodeSystem>
Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.