api-doc
Постраниченое получение найденных ранее в поисковом запросе записей
/search/get/RecordsPage
- Request: Page
- Response: RecordsPage
Запрос выполняется после выполнения поискового запроса из группы /search/start/*.
Выполнение поискового запроса занимает время, которое зависит от величины выборки.
Поэтому, при попытке получения записей нужно дождаться, чтобы поле result.page.job.ready установилось в true.
При этом поле result.size будет содержать общее количество записей, которые попали в поисковый запрос.
Для получения самих записей необходимо указать номер страницы (начиная с 0) в offset и
количество записей на странице в size.
Структура сообщений ProtoBuffer
message Page {
required SearchJob job = 1; //идентификатор SearchJob, полученный из запроса группы `/search/start/*`
optional int32 offset = 2; //номер страницы, начиная с 0
optional int32 size = 3; //количество записей на странице
}
message SearchJob {
required string id = 1;
oneof status {
bool ready = 2; //признак готовности SearchJob. Если не true, то необходимо вновь повторить запрос
ErrorResult error = 3;
}
}
message RecordsPage {
required Page page = 1;
repeated Rc rc = 2; //массив записей, полученных в ответе
optional int32 size = 3; //общее количество записей, которые попали в поисковый запрос
}
message Rc {
optional string id = 1;
optional string class_name = 2;
optional string patient_id = 3;
optional string ehr_id = 4;
optional Published published = 5;
optional string org_unit_id = 6;
optional string summary = 10;
optional string time_rc = 11;
repeated DeletedAt deleted_status = 14;
repeated string attachment_id = 15;
optional string instance_status = 16;
message Published {
optional string user_id = 1;
optional string time = 2;
}
enum DeletedAt {
RC = 1;
EHR = 2;
PTN = 3;
}
oneof rc {
// ....
RcTm66Order rc_tm66_order = 301;
// ....
}
// ....
message RcTm66Order {
optional Tm66OrderPurpose purpose = 1; // Цель дистанционного экспертного заключения
optional Tm66DiagnosticsType diagnostics_type = 2; // Тип инструментальной диагностики
optional string description = 3; // Краткое описание
optional Tm66PrimaryDiagnosticsDoc primary_diagnostics_doc = 4; // Первичный протокол исследования
repeated Tm66Doc docs = 5; // Медицинские документы
optional MedResource client = 10; // Заказчик
optional MedOrganization client_mo = 11; // МО заказчика
optional MedOrganization expert_mo = 20; // МО исполнителя
message Tm66PrimaryDiagnosticsDoc {
optional Tm66DiagnosticsMethod method = 1; // Метод исследования
optional string date_time = 2; // Дата и время проведения исследования
optional string device = 3; // Аппарат, на котором проводилось исследование
optional string text = 4; // Описание
optional double dose_msv = 5; // Поглощенная доза (мЗв)
repeated string attachment_id = 15; // Приложения
}
message Tm66Doc {
optional string date_time = 2; // Дата и время документа
optional string name = 3; // Наименование документа
optional string description = 4; // Краткое описание
repeated string attachment_id = 15; // Приложения
}
}
// ....
}
Пример http
Request
POST https://demo.onco-reg.ru/api/1.0/json/search/get/RecordsPage HTTP/1.1
X-Oncor-API-Token:
Content-Type: application/json
{
"page":{
"job":{
"id":"e3585aea-cf1c-4766-aa4b-afcf93c2d6d5"
},
"offset":0,
"size":5
}
}
Response
Ответ - не нашли не одной записи
{
"result": [
{
"page": {
"job": {
"id": "e3585aea-cf1c-4766-aa4b-afcf93c2d6d5",
"ready": true
},
"offset": 0,
"size": 1
},
"size": 0
}
]
}
Ответ - записи найдены
{
"result": [
{
"page": {
"job": {
"id": "f79abe08-4a15-4d9a-982a-c2a21b6bc11b",
"ready": true
},
"offset": 0,
"size": 1
},
"rc": [
{
"id": "#1930:0",
"class_name": "RcTm66Order",
"patient_id": "#69:111",
"ehr_id": "#1053:111",
"published": {
"user_id": "#961:0",
"time": "2020-05-18 20:13:06"
},
"org_unit_id": "#999:28",
"time_rc": "2020-05-18 20:07:28",
"rc_tm66_order": {
"purpose": {
"id": "5",
"code": "ФОРМИРОВАНИЕ_ЭКСПЕРТНОГО_МНЕНИЯ",
"caption": "Формирование экспертного мнения по результатам диагностических исследований (МСКТ, МРТ, ПЭТ-КТ и т.п.)"
},
"diagnostics_type": {
"code": "КТ_ГРУДНОЙ_КЛЕТКИ",
"caption": "Компьютерная томография грудной клетки"
},
"description": "Текстовое краткое описание заявки",
"dz_icd10": {
"orid": "#844:138",
"code": "C34.0",
"caption": "Главного бронха"
},
"dz_text": "Текстовое поле расшифровки диагноза",
"primary_diagnostics_doc": {
"method": {
"code": "КТ",
"caption": "Компьютерная томография"
},
"date_time": "2020-05-04 20:09:00",
"device": "Аппарат первичного исследования",
"text": "Текстовое краткое описание первичного исследования",
"dose_msv": 4.0,
"attachment_id": [
"#1585:4537"
]
},
"docs": [
{
"date_time": "2020-05-07 20:11:00",
"name": "Прием онколога",
"description": "Краткое описание приема онколога",
"attachment_id": [
"#1586:4430"
]
}
],
"client": {
"id": "28402-660122-41(20190101)",
"code": "28402-660122-41",
"date_range": [
"20190101",
"29991231"
],
"name": "ДАВЫДАЧЕВА Т В",
"doctor_code": "28402",
"doctor_name": "ДАВЫДАЧЕВА Т В",
"med_org_code": "660122",
"med_spec_code": "41"
},
"client_mo": {
"id": "660122(20180906)",
"code": "660122",
"date_range": [
"20180906",
"29991231"
],
"name": "ЦГБ 7 Екатеринбург",
"mo_code": "122",
"long_name": "Муниципальное бюджетное учреждение \"Центральная городская больница № 7\"",
"med_org_code": "660122",
"terr_code": "1505",
"address": "г. Екатеринбург, ул. Вилонова, д. 33",
"phone": "8(343)3417318",
"ogrn": "1026604963219",
"chief_last_name": "Барац",
"chief_first_name": "Евгений",
"chief_patronymic": "Семенович"
},
"expert_mo": {
"id": "661768(20190823)",
"code": "661768",
"date_range": [
"20190823",
"29991231"
],
"name": "СООД Екатеринбург",
"mo_code": "1768",
"long_name": "Государственное автономное учреждение здравоохранения Свердловской области \"Свердловский областной онкологический диспансер\"",
"med_org_code": "661768",
"terr_code": "1502",
"address": "г. Екатеринбург, ул. Соболева, 29",
"phone": "8(343)3561505",
"ogrn": "1146658016614",
"chief_last_name": "Елишев",
"chief_first_name": "Владимир",
"chief_patronymic": "Геннадьевич"
}
}
}
],
"size": 1
}
]
}