FHIR Warehouse
Introduction
Posos provides read-only access to a FHIR warehouse containing scanned prescriptions.
This warehouse is hosted in France on secured infrastructures and its access is protected. It complies with the FHIR R4 standard.
This documentation does not aim to describe the exposed interface, which corresponds exactly to the protocol described by FHIR.
Here, we will discuss the connection modalities to the warehouse proposed by Posos and provide some content examples.
Reference to standard
Migration of Google Cloud Healthcare API
For existing users of our FHIR services via the Google Cloud Healthcare API, the following changes have been made:
- Change of the base URL
- Change of the access procedure to align with our APIs
For these users, prescriptions will be available within both services during the migration phase.
Access URL to the warehouse
The base URL is:
https://fhir.production.trusted.posos.co/fhir/r4/:slug| Parameter | Description |
|---|---|
slug | Name of the FHIR warehouse. It corresponds to the name communicated to you with the key. |
Obtaining an identity token
The API is accessible only to authenticated users. The authentication mechanism is the same as the one used to access our APIs (see Authentication by identity token).
The Client ID parameter is different for this service:
Client ID
589453732022-cmckhdp859mfacdfbisb7rm350ubrp3r.apps.googleusercontent.comRequests to the FHIR warehouse must then contain the previously obtained access token in their Authorization header according to the principle of the Bearer token. This would result in a header of the following form:
Authorization: Bearer <access token>Using the API
The next step is to use the warehouse’s REST API, either directly with a REST client or via a dedicated FHIR client. The only requirement is to be able to provide the Bearer token as described above.
Example
Retrieving a patient’s last scanned prescription with the httpie command.
Request
GET
curl --request GET \
--url "https://fhir.production.trusted.posos.co/fhir/r4/:slug/RequestGroup?subject:Patient.identifier=id://partner|3f76b58d-26ea-458a-8992-a0740aa0c0f4&_count=1&_sort=-_lastUpdated" \
--header 'Authorization : Bearer <token>'Output
{
"entry": [
{
"fullUrl": "https://fhir.production.trusted.posos.co/fhir/r4/:slug/RequestGroup/acfaed53-ea82-4970-be08-34ddd4385e65",
"ressource": {
"action": [
{
"resource": {
"reference": "#b8751a34-956a-4f7c-95f7-feb9f1b96b7f-0"
}
},
{
"resource": {
"reference": "#b8751a34-956a-4f7c-95f7-feb9f1b96b7f-1"
}
},
{
"resource": {
"reference": "#b8751a34-956a-4f7c-95f7-feb9f1b96b7f-2"
}
},
{
"resource": {
"reference": "#b8751a34-956a-4f7c-95f7-feb9f1b96b7f-3"
}
},
{
"resource": {
"reference": "#b8751a34-956a-4f7c-95f7-feb9f1b96b7f-4"
}
}
],
"author": {
"reference": "#author"
},
"authoredOn": "2022-05-12T18:16:03.467Z",
"contained": [
{
"code": {
"coding": [
{
"code": "ramipril",
"display": "ramipril",
"system": "http://posos.on.fhir/shortname"
},
{
"code": "ramipril",
"display": "ramipril",
"system": "http://posos.on.fhir/dci"
},
{
"code": "C09AA05",
"display": "RAMIPRIL",
"system": "http://www.whocc.no/atc"
},
{
"code": "60489841",
"display": "RAMIPRIL ZYDUS FRANCE 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "60834757",
"display": "RAMIPRIL BOUCHARA RECORDATI 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "62387714",
"display": "RAMIPRIL ZENTIVA 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "63386309",
"display": "RAMIPRIL SUN 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "63506242",
"display": "RAMIPRIL SANDOZ 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "64227441",
"display": "RAMIPRIL BIOGARAN 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "64687386",
"display": "RAMIPRIL EVOLUGEN 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "65542746",
"display": "RAMIPRIL EG 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "66216041",
"display": "RAMIPRIL CRISTERS 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "66285105",
"display": "RAMIPRIL VIATRIS 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "66487797",
"display": "RAMIPRIL ALTER 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "67791290",
"display": "RAMIPRIL ARROW LAB 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "68604085",
"display": "RAMIPRIL ALMUS 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "68929602",
"display": "RAMIPRIL ARROW GENERIQUES 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "69048652",
"display": "RAMIPRIL KRKA 2,5 mg, tablet",
"system": "http://bdpm/cis"
},
{
"code": "69868248",
"display": "RAMIPRIL TEVA SANTE 2,5 mg, divisible tablet",
"system": "http://bdpm/cis"
},
{
"code": "2,5 mg",
"display": "2,5 mg",
"system": "http://posos.on.fhir/dose"
},
{
"code": "tablet",
"display": "tablet",
"system": "http://posos.on.fhir/form"
}
]
},
"id": "UmFtaXByaWw=",
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"code": "ramipril",
"display": "ramipril",
"system": "http://posos.on.fhir/dci"
}
]
}
}
],
"resourceType": "Medication"
},
{
"code": {
"coding": [
{
"code": "monoprost",
"display": "monoprost",
"system": "http://posos.on.fhir/shortname"
},
{
"code": "latanoprost",
"display": "latanoprost",
"system": "http://posos.on.fhir/dci"
},
{
"code": "S01EE01",
"display": "LATANOPROST",
"system": "http://www.whocc.no/atc"
},
{
"code": "66287654",
"display": "MONOPROST 50 microgrammes/ml, collyre solution",
"system": "http://bdpm/cis"
},
{
"code": "67303969",
"display": "MONOPROST 50 microgrammes/ml, collyre solution in single-dose container",
"system": "http://bdpm/cis"
},
{
"code": "collyre en solution",
"display": "collyre solution",
"system": "http://posos.on.fhir/form"
}
]
},
"id": "TW9ub3Byb3N0",
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"code": "latanoprost",
"display": "latanoprost",
"system": "http://posos.on.fhir/dci"
}
]
}
}
],
"resourceType": "Medication"
},
{
"code": {
"coding": [
{
"code": "bromazepam",
"display": "bromazepam",
"system": "http://posos.on.fhir/shortname"
},
{
"code": "bromazepam",
"display": "bromazepam",
"system": "http://posos.on.fhir/dci"
},
{
"code": "N05BA08",
"display": "BROMAZEPAM",
"system": "http://www.whocc.no/atc"
},
{
"code": "61084408",
"display": "BROMAZEPAM ARROW 1,5 mg, tablet",
"system": "http://bdpm/cis"
},
{
"code": "1,5 mg",
"display": "1,5 mg",
"system": "http://posos.on.fhir/dose"
},
{
"code": "tablet",
"display": "tablet",
"system": "http://posos.on.fhir/form"
}
]
},
"id": "QnJvbWF6ZXBhbQ==",
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"code": "bromazepam",
"display": "bromazepam",
"system": "http://posos.on.fhir/dci"
}
]
}
}
],
"resourceType": "Medication"
},
{
"code": {
"coding": [
{
"code": "tamsulosine",
"display": "tamsulosine",
"system": "http://posos.on.fhir/shortname"
},
{
"code": "tamsulosine",
"display": "tamsulosine",
"system": "http://posos.on.fhir/dci"
},
{
"code": "G04CA02",
"display": "TAMSULOSINE",
"system": "http://www.whocc.no/atc"
},
{
"code": "65795735",
"display": "TAMSULOSINE ARROW LAB LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "65823679",
"display": "TAMSULOSINE BIOGARAN L.P. 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "65869609",
"display": "TAMSULOSINE SUN LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "66281345",
"display": "TAMSULOSINE ZENTIVA LAB LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "66305159",
"display": "TAMSULOSINE KRKA LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "67486011",
"display": "TAMSULOSINE ALMUS L.P. 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "68655083",
"display": "TAMSULOSINE TEVA LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "68735615",
"display": "TAMSULOSINE SANDOZ LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "68840153",
"display": "TAMSULOSINE MYLAN L.P. 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "68843466",
"display": "TAMSULOSINE EG L.P. 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "69181268",
"display": "TAMSULOSINE EVOLUGEN L.P. 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "69284407",
"display": "TAMSULOSINE ARROW LP 0,4 mg, extended-release capsule",
"system": "http://bdpm/cis"
},
{
"code": "0,4 mg",
"display": "0,4 mg",
"system": "http://posos.on.fhir/dose"
},
{
"code": "extended-release capsule",
"display": "extended-release capsule",
"system": "http://posos.on.fhir/form"
}
]
},
"id": "VGFtc3Vsb3NpbmU=",
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"code": "tamsulosine",
"display": "tamsulosine",
"system": "http://posos.on.fhir/dci"
}
]
}
}
],
"resourceType": "Medication"
},
{
"code": {
"coding": [
{
"code": "doliprane",
"display": "doliprane",
"system": "http://posos.on.fhir/shortname"
},
{
"code": "paracetamol",
"display": "paracetamol",
"system": "http://posos.on.fhir/dci"
},
{
"code": "N02BE01",
"display": "PARACETAMOL",
"system": "http://www.whocc.no/atc"
},
{
"code": "67119691",
"display": "DOLIPRANE 500 mg, capsule",
"system": "http://bdpm/cis"
},
{
"code": "500 mg",
"display": "500 mg",
"system": "http://posos.on.fhir/dose"
},
{
"code": "capsule",
"display": "capsule",
"system": "http://posos.on.fhir/form"
}
]
},
"id": "RG9saXByYW5l",
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"code": "paracetamol",
"display": "paracetamol",
"system": "http://posos.on.fhir/dci"
}
]
}
}
],
"resourceType": "Medication"
},
{
"dosageInstruction": [
{
"text": "SP 28 jour(s)."
}
],
"id": "b8751a34-956a-4f7c-95f7-feb9f1b96b7f-0",
"intent": "order",
"medicationReference": {
"reference": "#UmFtaXByaWw="
},
"resourceType": "MedicationRequest",
"status": "draft",
"subject": {
"reference": "Patient/cc508c17-051b-42e9-bf8e-4205ea6183d9"
},
"text": {
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Ramipril - SP 28 jour(s).</div>",
"status": "generated"
}
},
{
"dosageInstruction": [
{
"text": "recipient unidose le soir À partir du 30/11/2021"
}
],
"id": "b8751a34-956a-4f7c-95f7-feb9f1b96b7f-1",
"intent": "order",
"medicationReference": {
"reference": "#TW9ub3Byb3N0"
},
"resourceType": "MedicationRequest",
"status": "draft",
"subject": {
"reference": "Patient/cc508c17-051b-42e9-bf8e-4205ea6183d9"
},
"text": {
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Monoprost - recipient unidose le soir À partir du 30/11/2021</div>",
"status": "generated"
}
},
{
"dosageInstruction": [
{
"text": ""
}
],
"id": "b8751a34-956a-4f7c-95f7-feb9f1b96b7f-2",
"intent": "order",
"medicationReference": {
"reference": "#QnJvbWF6ZXBhbQ=="
},
"resourceType": "MedicationRequest",
"status": "draft",
"subject": {
"reference": "Patient/cc508c17-051b-42e9-bf8e-4205ea6183d9"
},
"text": {
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Bromazepam - </div>",
"status": "generated"
}
},
{
"dosageInstruction": [
{
"text": ""
}
],
"id": "b8751a34-956a-4f7c-95f7-feb9f1b96b7f-3",
"intent": "order",
"medicationReference": {
"reference": "#VGFtc3Vsb3NpbmU="
},
"resourceType": "MedicationRequest",
"status": "draft",
"subject": {
"reference": "Patient/cc508c17-051b-42e9-bf8e-4205ea6183d9"
},
"text": {
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Tamsulosine - </div>",
"status": "generated"
}
},
{
"dosageInstruction": [
{
"text": "IV. Paracetamol 500 mg capsule (DOLIPRANE 500MG capsule 100) 2 capsules orally in the morning at night if necessary From 30/11/2021 QSP 28 day(s)."
}
],
"id": "b8751a34-956a-4f7c-95f7-feb9f1b96b7f-4",
"intent": "order",
"medicationReference": {
"reference": "#RG9saXByYW5l"
},
"resourceType": "MedicationRequest",
"status": "draft",
"subject": {
"reference": "Patient/cc508c17-051b-42e9-bf8e-4205ea6183d9"
},
"text": {
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Doliprane - IV. Paracetamol 500 mg capsule (DOLIPRANE 500MG capsule 100) 2 capsules orally in the morning and at night if necessary From 30/11/2021 QSP 28 day(s).</div>",
"status": "generated"
}
},
{
"id": "author",
"identifier": [
{
"system": "id://partner",
"value": "john-doe"
},
{
"system": "id://posos",
"value": "3cc53d9f-c82c-4038-9869-a1b8b6d43ddf"
}
],
"resourceType": "Practitioner"
}
],
"id": "acfaed53-ea82-4970-be08-34ddd4385e65",
"identifier": [
{
"system": "id://posos",
"value": "b8751a34-956a-4f7c-95f7-feb9f1b96b7f"
}
],
"intent": "order",
"meta": {
"lastUpdated": "2022-05-12T18:16:06.503802+00:00",
"versionId": "MTY1MjM3OTM2NjUwMzgwMjAwMA"
},
"resourceType": "RequestGroup",
"status": "draft",
"subject": {
"reference": "Patient/cc508c17-051b-42e9-bf8e-4205ea6183d9"
},
"text": {
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><ul><li>Ramipril - SP 28 day(s).</li><li>Monoprost - single-dose container in the evening From 30/11/2021</li><li>Bromazepam - </li><li>Tamsulosine - </li><li>Doliprane - IV. Paracetamol 500 mg capsule (DOLIPRANE 500MG capsule 100) 2 capsules orally in the morning at night if necessary From 30/11/2021 QSP 28 day(s).</li></ul></div>",
"status": "generated"
}
},
"search": {
"mode": "match"
}
}
],
"link": [
{
"relation": "search",
"url": "https://fhir.production.trusted.posos.co/fhir/r4/:slug/RequestGroup/?_count=1&_sort=-_lastUpdated&subject%3APatient.identifier=id%3A%2F%2Fpartner%7C3f76b58d-26ea-458a-8992-a0740aa0c0f4"
},
{
"relation": "first",
"url": "https://fhir.production.trusted.posos.co/fhir/r4/:slug/RequestGroup/?_count=1&_sort=-_lastUpdated&subject%3APatient.identifier=id%3A%2F%2Fpartner%7C3f76b58d-26ea-458a-8992-a0740aa0c0f4"
},
{
"relation": "self",
"url": "https://fhir.production.trusted.posos.co/fhir/r4/:slug/RequestGroup/?_count=1&_sort=-_lastUpdated&subject%3APatient.identifier=id%3A%2F%2Fpartner%7C3f76b58d-26ea-458a-8992-a0740aa0c0f4"
}
],
"resourceType": "Bundle",
"total": 1,
"type": "searchset"
}