{
	"info": {
		"_postman_id": "edf3b72e-dc10-4089-b211-481896de867d",
		"name": "ANS SMT Service FHIR de terminologies de santé",
		"description": "# **Exemples d'usage des APIs du serveur FHIR de terminologies de l'Agence du Numérique en Santé (ANS).**\n\nLes présents exemples sont en lien avec le doucment intitulé: \"Service FHIR® pour la gestion des terminologies en santé Guide d'implémentation de l’Agence Nationale de la e-Santé (ANS)\" accessible ici: [https://industriels.esante.gouv.fr/sites/default/files/media/document/Global_features_FHIR_Server_version_finale_v5.pdf](https://industriels.esante.gouv.fr/sites/default/files/media/document/Global_features_FHIR_Server_version_finale_v5.pdf)\n\n---\n\n_Crée par Abdelali Boussadi, PhD_",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
		"_exporter_id": "15284786"
	},
	"item": [
		{
			"name": "Opération au niveau d'une instance",
			"item": [
				{
					"name": "Lire l'état courant d'une instance de type CodeSystem",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/TRE-R217-ProtectionJuridique",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"TRE-R217-ProtectionJuridique"
							]
						}
					},
					"response": []
				},
				{
					"name": "Lire l’état d’une version spécifique d’une instance Codesystem",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/TRE-R217-ProtectionJuridique/_history/2",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"TRE-R217-ProtectionJuridique",
								"_history",
								"2"
							]
						}
					},
					"response": []
				},
				{
					"name": "Retrouver l’historique des différents états d’une instance d’une ressource de type CodeSystem",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/TRE-R217-ProtectionJuridique/_history",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"TRE-R217-ProtectionJuridique",
								"_history"
							]
						}
					},
					"response": []
				}
			]
		},
		{
			"name": "Opérations au niveau ressource",
			"item": [
				{
					"name": "Faire une recherche par type de ressource",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/?_elements=name,url",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								""
							],
							"query": [
								{
									"key": "_elements",
									"value": "name,url"
								}
							]
						}
					},
					"response": []
				},
				{
					"name": "Retrouver l’historique des différents états de toutes les instances",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/_history",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"_history"
							]
						}
					},
					"response": []
				}
			]
		},
		{
			"name": "Opération au niveau serveur",
			"item": [
				{
					"name": "Afficher les « capacités » du serveur fhir",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/metadata",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"metadata"
							]
						},
						"description": "Afficher les « capacités » du serveur fhir. Donner les détails des ressources FHIR gérées par le serveur. Donner les opérations possibles sur ces ressources. Donner les paramètres de recherche autorisés sur les différentes ressources hébergées par le serveur Afficher des « capabilities » spécifiques aux ressource de terminologies."
					},
					"response": []
				},
				{
					"name": "Afficher des « capabilities » spécifiques aux ressource de terminologies",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/metadata?mode=terminology",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"metadata"
							],
							"query": [
								{
									"key": "mode",
									"value": "terminology"
								}
							]
						}
					},
					"response": []
				},
				{
					"name": "Retrouver l’historique des différents états de toutes les instances de tous les types de ressource hébergées par le serveur",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/_history",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"_history"
							]
						}
					},
					"response": []
				}
			]
		},
		{
			"name": "Opérations spécifiques à la ressource CodeSystem",
			"item": [
				{
					"name": "Afficher les détails d’un concept d’une terminologie",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/$lookup?system=https://smt.esante.gouv.fr/terminologie-cim11-mms&code=4A40.00",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"$lookup"
							],
							"query": [
								{
									"key": "system",
									"value": "https://smt.esante.gouv.fr/terminologie-cim11-mms"
								},
								{
									"key": "code",
									"value": "4A40.00"
								}
							]
						}
					},
					"response": []
				},
				{
					"name": "Tester la présence d’un code concept dans une terminologie cible et éventuellement afficher certains détails du concept testé",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/$validate-code?url=https://smt.esante.gouv.fr/terminologie-cim-10&code=P02.0 ",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"$validate-code"
							],
							"query": [
								{
									"key": "url",
									"value": "https://smt.esante.gouv.fr/terminologie-cim-10"
								},
								{
									"key": "code",
									"value": "P02.0 "
								}
							]
						},
						"description": "### GET Request to Validate Code\n\n#### Description\n\nThis is an HTTP GET request to validate a code against a specific CodeSystem. It is used to check if a given code is valid within the specified CodeSystem.\n\n#### Request\n\n- URL: `https://smt.esante.gouv.fr/fhir/CodeSystem/$validate-code?url=https://smt.esante.gouv.fr/terminologie-cim-10&code=P02.0`\n    \n\n#### Response\n\nThe server responds with a status code of 200 and the content type is `application/fhir+json`. The response body contains a FHIR Parameters object with a boolean value indicating the validation result.\n\n#### Request Body\n\nThis request does not contain a request body.\n\n#### Response Body\n\n``` json\n{\n  \"resourceType\": \"\",\n  \"parameter\": [\n    {\n      \"name\": \"\",\n      \"valueBoolean\": true\n    }\n  ]\n}\n\n ```"
					},
					"response": []
				},
				{
					"name": "Tester une relation de subsumption entre deux codes de concepts données en entrée",
					"protocolProfileBehavior": {
						"disabledSystemHeaders": {
							"connection": true,
							"accept-encoding": true
						}
					},
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Host",
								"value": "smt.esante.gouv.fr",
								"type": "text"
							},
							{
								"key": "User-Agent",
								"value": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:135.0) Gecko/20100101 Firefox/135.0",
								"type": "text",
								"disabled": true
							},
							{
								"key": "Accept",
								"value": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
								"type": "text",
								"disabled": true
							},
							{
								"key": "Accept-Language",
								"value": "fr,fr-FR;q=0.8,en-US;q=0.5,en;q=0.3",
								"type": "text"
							},
							{
								"key": "Accept-Encoding",
								"value": "gzip, deflate, br, zstd",
								"type": "text"
							},
							{
								"key": "Connection",
								"value": "keep-alive",
								"type": "text"
							},
							{
								"key": "Cookie",
								"value": "_pcid=%7B%22browserId%22%3A%22lumfphrsi1663pt7%22%2C%22_t%22%3A%22maaumz8w%7Clumfphww%22%7D; _pctx=%7Bu%7DN4IgrgzgpgThIC4B2YA2qA05owMoBcBDfSREQpAeyRCwgEt8oBJAE0RXSwH18yBbQoTD8AXgE4AjAB9UIgGYAHABYAPSSAC%2BQA; cookielawinfo-checkbox-necessary=yes; CookieLawInfoConsent=eyJuZWNlc3NhcnkiOnRydWV9; viewed_cookie_policy=yes; PHPSESSID=55af3fe68ec8b3327f95179e1ba682cf",
								"type": "text"
							},
							{
								"key": "Upgrade-Insecure-Requests",
								"value": "1",
								"type": "text"
							},
							{
								"key": "Sec-Fetch-Dest",
								"value": "document",
								"type": "text"
							},
							{
								"key": "Sec-Fetch-Mode",
								"value": "navigate",
								"type": "text"
							},
							{
								"key": "Sec-Fetch-Site",
								"value": "none",
								"type": "text"
							},
							{
								"key": "Sec-Fetch-User",
								"value": "?1",
								"type": "text"
							},
							{
								"key": "host",
								"value": "smt.esante.gouv.fr",
								"type": "text"
							}
						],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=3738000&codeB=235856003",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"CodeSystem",
								"$subsumes"
							],
							"query": [
								{
									"key": "system",
									"value": "http://snomed.info/sct"
								},
								{
									"key": "codeA",
									"value": "3738000"
								},
								{
									"key": "codeB",
									"value": "235856003"
								}
							]
						},
						"description": "### GET /fhir/CodeSystem/$subsumes\n\nThis endpoint retrieves the subsumption relationship between two SNOMED CT codes.\n\n#### Request\n\nNo request body is required for this endpoint. The following query parameters should be included in the request URL:\n\n- `system`: The URI of the SNOMED CT code system.\n    \n- `codeA`: The first SNOMED CT code.\n    \n- `codeB`: The second SNOMED CT code.\n    \n\nExample:\n\n```\nhttps://smt.esante.gouv.fr/fhir/CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=3738000&codeB=235856003\n\n ```\n\n#### Response\n\nThe response for this request is in JSON format and follows the FHIR (Fast Healthcare Interoperability Resources) standard. The JSON schema for the response is as follows:\n\n``` json\n{\n  \"type\": \"object\",\n  \"properties\": {\n    \"resourceType\": {\n      \"type\": \"string\"\n    },\n    \"issue\": {\n      \"type\": \"array\",\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"severity\": {\n            \"type\": \"string\"\n          },\n          \"code\": {\n            \"type\": \"string\"\n          },\n          \"details\": {\n            \"type\": \"object\",\n            \"properties\": {\n              \"text\": {\n                \"type\": \"string\"\n              }\n            }\n          },\n          \"diagnostics\": {\n            \"type\": \"string\"\n          }\n        }\n      }\n    }\n  }\n}\n\n ```"
					},
					"response": []
				}
			]
		},
		{
			"name": "Opérations spécifiques à la ressource ValueSet",
			"item": [
				{
					"name": "Permet de créer à la volée des sous-ensembles de concepts à partir d’un objet VS donné en entrée et d’un ou de plusieurs filtres",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/ValueSet/vs-bdpm-all/$expand?filter=IBUPROFENE",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"ValueSet",
								"vs-bdpm-all",
								"$expand"
							],
							"query": [
								{
									"key": "filter",
									"value": "IBUPROFENE"
								}
							]
						},
						"description": "The endpoint [https://smt.esante.gouv.fr/fhir/ValueSet/vs-bdpm-all/$expand?filter=IBUPROFENE](https://smt.esante.gouv.fr/fhir/ValueSet/vs-bdpm-all/$expand?filter=IBUPROFENE) is used to expand the value set for the given filter \"IBUPROFENE\". The response is in JSON format and follows the FHIR standard.\n\n``` json\n{\n  \"type\": \"object\",\n  \"properties\": {\n    \"resourceType\": { \"type\": \"string\" },\n    \"url\": { \"type\": \"string\" },\n    \"version\": { \"type\": \"string\" },\n    \"name\": { \"type\": \"string\" },\n    \"status\": { \"type\": \"string\" },\n    \"experimental\": { \"type\": \"boolean\" },\n    \"expansion\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"identifier\": { \"type\": \"string\" },\n        \"timestamp\": { \"type\": \"string\" },\n        \"total\": { \"type\": \"integer\" },\n        \"parameter\": {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\": \"object\",\n            \"properties\": {\n              \"name\": { \"type\": \"string\" },\n              \"valueUri\": { \"type\": \"string\" }\n            }\n          }\n        },\n        \"contains\": {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\": \"object\",\n            \"properties\": {\n              \"system\": { \"type\": \"string\" },\n              \"code\": { \"type\": \"string\" },\n              \"display\": { \"type\": \"string\" }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n\n ```"
					},
					"response": []
				},
				{
					"name": "Tester la présence d’un code d’un concept dans un objet VS et éventuellement afficher certains détails du concept testé",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/ValueSet/vs-bdpm-all/$validate-code?system=https://smt.esante.gouv.fr/terminologie-bdpm&code=63691015 ",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"ValueSet",
								"vs-bdpm-all",
								"$validate-code"
							],
							"query": [
								{
									"key": "system",
									"value": "https://smt.esante.gouv.fr/terminologie-bdpm"
								},
								{
									"key": "code",
									"value": "63691015 "
								}
							]
						},
						"description": "This endpoint makes an HTTP GET request to validate a code against a specific ValueSet. The request URL is [https://smt.esante.gouv.fr/fhir/ValueSet/vs-bdpm-all/$validate-code](https://smt.esante.gouv.fr/fhir/ValueSet/vs-bdpm-all/$validate-code), with query parameters system and code. The system parameter specifies the system to validate against, and the code parameter contains the code to be validated.\n\n### Request Body\n\nThis request does not contain a request body.\n\n### Response Body\n\nThe response is in JSON format with a status code of 200 and a content type of application/fhir+json. The response body includes a resourceType field and a parameter array, where each parameter contains a name and a valueBoolean indicating the validation result."
					},
					"response": []
				}
			]
		},
		{
			"name": "Opérations spécifiques à la ressource ConceptMap",
			"item": [
				{
					"name": "Afficher les alignements possibles pour un code d’une terminologie donné en entrée",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://smt.esante.gouv.fr/fhir/ConceptMap/$translate?system=https://smt.esante.gouv.fr/terminologie-nuva&code=VAC0160 ",
							"protocol": "https",
							"host": [
								"smt",
								"esante",
								"gouv",
								"fr"
							],
							"path": [
								"fhir",
								"ConceptMap",
								"$translate"
							],
							"query": [
								{
									"key": "system",
									"value": "https://smt.esante.gouv.fr/terminologie-nuva"
								},
								{
									"key": "code",
									"value": "VAC0160 "
								}
							]
						},
						"description": "This endpoint makes an HTTP GET request to translate a code from one coding system to another. The request URL is [https://smt.esante.gouv.fr/fhir/ConceptMap/$translate](https://smt.esante.gouv.fr/fhir/ConceptMap/$translate) with the query parameters system and code. The system parameter specifies the source coding system, and the code parameter specifies the code to be translated.\n\n### Request Body\n\nThis request does not contain a request body.\n\n### Response Body\n\nThe response is in JSON format with a status code of 200 and a content type of application/fhir+json. The response body contains a resourceType field and a parameter array. The parameter array includes name and valueBoolean fields, where the name field is empty and the valueBoolean field is set to true."
					},
					"response": []
				}
			]
		}
	],
	"event": [
		{
			"listen": "prerequest",
			"script": {
				"type": "text/javascript",
				"packages": {},
				"exec": [
					""
				]
			}
		},
		{
			"listen": "test",
			"script": {
				"type": "text/javascript",
				"packages": {},
				"exec": [
					""
				]
			}
		}
	],
	"variable": [
		{
			"key": "baseUrl",
			"value": "https://smt.esante.gouv.fr/fhir",
			"type": "string"
		}
	]
}