New post
Question
· Feb 26, 2023

How can I know the patient id for a newly submitted Patient resource?

#FHIR #JSON #REST API #InterSystems IRIS for Health

Hi folks!

Playing with InterSystems FHIR server. 

You can easily install it in IRIS for Health using FHIR template:

zpm "install fhir-server"

NB! For now the IPM command mentioned above works for a namespace called FHIRSERVER only.

I have a FHIR server in a local docker container with endpoint:

localhost:52773/fhir/r4

I send the following Patient resource as a POST request to localhost:52773/fhir/r4/Patient:

 
Spoiler

And I'm getting 201 and no result.

How could I know what is the id of the patient I've just created?

Product version: IRIS 2022.3
Discussion (14)4
Log in or sign up to continue
Tani Frankel Feb 26, 2023 to Lorenzo Scalese

Indeed it is in the Location Header.

From the related FHIR docs:

The server returns a 201 Created HTTP status code, and SHALL also return a Location header which contains the new Logical Id and Version Id of the created resource version:

  Location: [base]/[type]/[id]/_history/[vid]

where [id] and [vid] are the newly created id and version id for the resource version. The Location header should be as specific as possible - if the server understands versioning, the version is included. If a server does not track versions, the Location header will just contain [base]/[type]/[id]. The Location MAY be an absolute or relative URL.

3 0
Evgeny Shvarov Feb 27, 2023 to Lorenzo Scalese

Hi @Lorenzo Scalese ! Yes! It is in Location header, as @Tani Frankel mentioned. 

This is what I received in headers:

http://localhost:52773/fhir/r4/Patient//1983/_history/1
So, the id is 1983.

It is a bit different from what the public FHIR server on hl7.org/fhir returns - it returns the id also in a response.

Not sure though what is the "standard" behavior but if find it convenient enough to have the id in the response.  

1 0
Guillaume Rongier · Mar 29, 2023

Another good way is to set the header :

Prefer: return=representation
Shell Session
Shell Session

The payload will be sent you back with the id.

Example :

POST http://localhost:33783/fhir/r4/Patient HTTP/1.1
Content-Type: application/json+fhir
Accept: application/json+fhir
Prefer: return=representation

{
  "resourceType": "Patient",
  "active": true,
  "name": [
    {
      "use": "official",
      "family": "Donald",
      "given": [
        "Duck"
      ]
    }
  ]
}
Shell Session
Shell Session

Response :

HTTP/1.1 201 Created
Date: Wed, 29 Mar 2023 12:13:40 GMT
Server: Apache
CACHE-CONTROL: no-cache
ETAG: W/"1"
EXPIRES: Thu, 29 Oct 1998 17:04:19 GMT
LAST-MODIFIED: Wed, 29 Mar 2023 12:13:40 GMT
LOCATION: http://localhost:33783/fhir/r4/Patient/2011/_history/1
PRAGMA: no-cache
CONTENT-LENGTH: 177
Connection: close
Content-Type: application/fhir+json; charset=UTF-8

{
  "resourceType": "Patient",
  "active": true,
  "name": [
    {
      "use": "official",
      "family": "Donald",
      "given": [
        "Duck"
      ]
    }
  ],
  "id": "2011",
  "meta": {
    "lastUpdated": "2023-03-29T12:13:40Z",
    "versionId": "1"
  }
}
ObjectScript
ObjectScript
2 0