Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build

Поиск информации о пациенте

Метод предназначен для поиска информации о пациенте в ЦИСЗ.

Программные интерфейсы ЦИСЗ защищены сервером авторизации с использованием технологии OAuth 2.0 (см. вкладку “Авторизация в ЦИСЗ”). При каждом вызове метода клиентское приложение (МИС) должно передавать токен доступа (токен медицинского работника) в заголовке запроса.

Вызов метода для поиска информации о пациенте по параметрам поиска осуществляется с помощью HTTP GET команды:

GET [FHIR_BASE]/Patient?[queryParameters]

Примечание: Для корректной работы необходимо указать как минимум два поисковых параметра, один из которых должен быть _profile.

Входные данные метода:

Название Тип Описание
queryParameters Параметры поиска Для ознакомления с поддерживаемыми поисковыми параметрами, необходимо обратиться к списку поддерживаемых профилей ресурсов
patientId ID Пациента Идентификатор пациента

Выходные данные метода:

Название Профиль Описание
Bundle Bundle В случае успешного нахождения ресурса возвращается ответ типа Bundle, содержащий список ресурсов, удовлетворяющих условиям поиска. В случае, если ресурс не был найден, список будет пусой

Метод возвращает:

  • HTTP статус 200 ОК;

  • HTTP статус серии 4xx или 5xx: операция поиска не выполнена. К сбою операции могут привести ошибки в контенте (например, неверный набор символов, неверный JSON и т. д.).

При поиске ресурсов найденная информация возвращается постранично. По умолчанию одна страница содержит 10 записей. Для получения следующей страницы необходимо выполнить запрос, который указан в списке link с ключом relation со значением next.

Пример запроса на поиск пациента по идентификатору:

GET [FHIR_BASE]/Patient?_id=c80c1777-27ed-11ef-b9e5-0b8748c6aeb4

Пример запроса на поиск пациента по ФИО:

GET [FHIR_BASE]/Patient?name=Иванов Петр Иванович

Пример ответа на запрос поиска пациента по идентификатору:

{ "resourceType": "Bundle", "id": "769164ce-a8c0-4f20-ada4-f5807ba0939d", "meta": { "lastUpdated": "2024-06-11T14:55:02.7907223+00:00" }, "type": "searchset", "total": 1, "link": [ { "relation": "self", "url": "http://cisz.by/api/Fhir/Patient?_id=c80c1777-27ed-11ef-b9e5-0b8748c6aeb4" } ], "entry": [ { "resource": { "resourceType": "OperationOutcome", "id": "769164ce-a8c0-4f20-ada4-f5807ba0939d", "issue": [ { "severity": "warning", "code": "incomplete", "diagnostics": "Include result was truncated" } ] }, "search": { "mode": "outcome" } }, { "fullUrl": "http://cisz.by/api/Fhir/Patient/c80c1777-27ed-11ef-b9e5-0b8748c6aeb4", "resource": { "resourceType": "Patient", "id": "c80c1777-27ed-11ef-b9e5-0b8748c6aeb4", "meta": { "versionId": "1", "lastUpdated": "2024-06-11T12:29:49.457+00:00", "source": "Bundle/4b7ae21b-27ee-11ef-b79e-1d1a12177b23", "profile": [ "https://fhir.by/StructureDefinition/AnonymousPatientBy" ] }, "identifier": [ { "type": { "coding": [ { "system": "https://fhir.by/ValueSet/DocNumbersBy", "code": "ANO" } ] }, "value": "331121990999000", "period": { "start": "2024-12-31" }, "assigner": { "reference": "Organization/ecc51621-0af3-3b35-ac3e-8b1e34022e92" } } ], "active": true, "name": [ { "use": "anonymous", "family": "Иванов", "given": [ "Петр", "Сидорович" ] } ], "telecom": [ { "system": "phone", "value": "89001234567" } ], "birthDate": "1990-12-31", "deceasedBoolean": false }, "search": { "mode": "match" } } ] }

Пример ответа на запрос поиска пациента по ФИО:

{ "resourceType": "Bundle", "id": "e2abf439-2d8b-4558-a968-c367fc0f92fd", "meta": { "lastUpdated": "2024-06-13T08:49:20.592386+00:00" }, "type": "searchset", "total": 1, "link": [ { "relation": "self", "url": "http://cisz.by/api/Fhir/Patient?name=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%20%D0%9F%D0%B5%D1%82%D1%80%20%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87" } ], "entry": [ { "resource": { "resourceType": "OperationOutcome", "id": "e2abf439-2d8b-4558-a968-c367fc0f92fd", "issue": [ { "severity": "warning", "code": "incomplete", "diagnostics": "Include result was truncated" } ] }, "search": { "mode": "outcome" } }, { "fullUrl": "http://cisz.by/api/Fhir/Patient/Patient01", "resource": { "resourceType": "Patient", "id": "ExamplePatienWithIDStudent", "meta": { "profile": [ "https://fhir.by/StructureDefinition/PatientWithIdentificationNumber" ] }, "extension": [ { "extension": [ { "url": "https://fhir.by/StructureDefinition/PatientArchiveBoolean", "valueBoolean": false } ], "url": "https://fhir.by/StructureDefinition/PatientArchive" }, { "extension": [ { "url": "https://fhir.by/StructureDefinition/ConsentPersonalDataBoolean", "valueBoolean": true }, { "url": "https://fhir.by/StructureDefinition/ConsentPersonalDataPeriod", "valuePeriod": { "start": "2024-08-01" } } ], "url": "https://fhir.by/StructureDefinition/ConsentPersonalData" }, { "extension": [ { "url": "https://fhir.by/StructureDefinition/PatientStudyPlace", "valueString": "БГУ, факультет журналистики" }, { "url": "https://fhir.by/StructureDefinition/PatientStudyKind", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/EducationKind", "code": "student", "display": "Студент очной формы обучения" } ] } }, { "url": "https://fhir.by/StructureDefinition/PatientTermOfStudy", "valuePeriod": { "start": "2024-09-01" } } ], "url": "https://fhir.by/StructureDefinition/PatientStudy" } ], "identifier": [ { "use": "usual", "type": { "coding": [ { "system": "https://fhir.by/ValueSet/PersonalDocumentType", "code": "INP" } ] }, "value": "7001112A009PB3" }, { "extension": [ { "extension": [ { "url": "https://fhir.by/StructureDefinition/PassportIssuedString", "valueString": "Центральным РУВД г Минска, 21.08.2021" }, { "url": "https://fhir.by/StructureDefinition/PassportIssuedDate", "valueDate": "2022-08-21" }, { "url": "https://fhir.by/StructureDefinition/PassportIssuedCode", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/OCAM", "code": "106" } ] } } ], "url": "https://fhir.by/StructureDefinition/PassportIssued" } ], "use": "usual", "type": { "coding": [ { "system": "https://fhir.by/ValueSet/PersonalDocumentType", "code": "Passport-RB" } ] }, "value": "MP1234560" } ], "active": true, "name": [ { "family": "Иванов", "given" : ["Петр", "Иванович"], ] } ], "telecom": [ { "extension": [ { "extension": [ { "url": "https://fhir.by/StructureDefinition/PatientNotificationType", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/PatientNotificationType", "code": "SMS", "display": "SMS" } ] } }, { "url": "https://fhir.by/StructureDefinition/PatientNotificationType", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/PatientNotificationType", "code": "messenger-WU", "display": "сообщения в мессенджере WatsUpp" } ] } }, { "url": "https://fhir.by/StructureDefinition/PatientConsentForNotification", "valueBoolean": true } ], "url": "https://fhir.by/StructureDefinition/PatientTelecomPurpose" } ], "system": "phone", "value": "89001234567" } ], "gender": "male", "birthDate": "2000-12-31", "deceasedBoolean": false, "address": [ { "extension": [ { "url": "https://fhir.by/StructureDefinition/CoutryForAddresses", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/CitizenshipCode", "code": "BY", "display": "Беларусь" } ] } }, { "url": "https://fhir.by/StructureDefinition/StreetGeoRegistry", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/StreetGeoRegistry", "code": "72609920778", "display": "Переулок Снежный" } ] } }, { "url": "https://fhir.by/StructureDefinition/ApartmetnRoom", "valueString": "кв. 11" } ], "use": "home", "text": "Могилевская область, г.Могилев, Переулок Гоголя, д.19", "postalCode": "212011" } ], "contact": [ { "name": { "family": "Иванов", "given": [ "Петр" ] }, "telecom": [ { "system": "phone", "value": "80299099990" } ] } ] } ] }, "search": { "mode": "match" } } ] }
▲ Вверх