Сравнение двух API
Новый API упрощен до всего одного запроса и уже обогащен всеми необходимыми данными. В предыдущей версии API нужно было сделать несколько запросов на обогащение справочных данных.
Ниже мы покажем примеры ответов и отличие в количестве запросов.
Узнать подробнее, задать вопросы или подключить API
Например, необходимо получить следующую информацию о SKU:
Название препарата:
- Общее наименование препарата
- Торговое наименование препарата
Информацию о производителе:
- Наименование производителя
- Страну производителя
- Адрес производителя
Краткое и полное описание упаковки:
- Лекарственную форму
- Действущее вещество (МНН)
- Дозировку (и единицы измерения)
- Общее количество
- Информацию о первичной упаковке
- Информацию о потребительской упаковке
Что нужно было ранее:
- Страну производителя
- Адрес производителя
Соответственно, для получения только этой информации требовалось выполнить не менее 8 запросов, причем некоторые из них последовательно, что дополнительно увеличивало время получения информации.
Что требуется теперь?
Сделать всего один запрос к новому API.
Данные, которые возвращает текущий API в сравнении со старым
Общее наименование
АНАЛЬГИН 500мг/мл x 2мл N10 р-р в/в и в/м введ ОЗОН
Новый API:
PRODUCT_NAME из запроса по SKU_ID
Старый API:
NORMALIZED_STRING из запроса по SKU_ID
Торговое наименование
Анальгин
Новый API:
TRADE_NAME из запроса по SKU_ID
Старый API:
TRADE_NAME из запроса по SKU_ID
Информация о производителе
Новый API:
Элемент MANUFACTURER в ответе на запрос по SKU_ID
{ "manufacturer":{ "company":{ "id":"b7383739-ec2e-4827-a294-4305c3ee757d", "name_short":"ОЗОН", "name_full":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ОЗОН\"" }, "address":{ "id":"9a791cbc-9da3-45e6-a98d-d2ab175ad090", "title":"445351, Самарская обл., г.Жигулёвск, ул.Гидростроителей, д.6", "country":{ "id":"e2c0eb1c-6e61-46eb-9040-57c8defe63ba", "name":"РОССИЯ" } } } }
Старый API:
Для получения этой же информации в старом API необходимо для id адреса из запроса по SKU последовательно выполнить запросы по справочнику компаний, после чего по полученным id компании и id страны получить данные об адресе, стране и компании-производителе:
Ответ на запрос информации по адресу (получаем id компании и страны):
{ "data":{ "id":"1ccbb934-6e60-4d08-898b-ff8ff278acaa", "company_id":"b7383739-ec2e-4827-a294-4305c3ee757d", "country_id":"e2c0eb1c-6e61-46eb-9040-57c8defe63ba", "title":"445351, Самарская обл., г.о.Жигулёвск, г.Жигулёвск, ул.Гидростроителей, д.6" } }
Ответы на запросы информации о стране и компании:
Информация о стране:
{ "data":{ "id":"e2c0eb1c-6e61-46eb-9040-57c8defe63ba", "name":"РОССИЯ", "full_name":"Российская Федерация", "code":"643", "alpha2":"RU", "alpha3":"RUS" } }
Информация о компании:
{ "data":{ "id":"b7383739-ec2e-4827-a294-4305c3ee757d", "original_name":null, "name_rus":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ОЗОН\"", "name_rus_short":"ОЗОН" } }
Краткое описание упаковки:
Элемент MEDICINES нового API
- Дозировка (указанная на упаковке)
- Информация о первичной упаковке
- Информация о потребительской упаковке
- Общее количество
- Лекарственная форма
- МНН
Новый API: Элемент в ответе на запрос по SKU_ID
{ "medicines":{ "packs":{ "primary":[ { "id":"8ddbd462-e0a3-4551-84ea-d98032ffef4e", "name":"ампула", "count":"10 шт" } ], "intermediate":null, "consumer":{ "id":"37d25638-0365-43b8-b87b-f1837a2b30b2", "name":"пачка картонная", "count":"1 шт" } }, "components":[ ], "dosage_forms":[ { "id":"c17dcb50-a39e-4578-9dcb-82df4dd1f56b", "name":"раствор для внутривенного и внутримышечного введения", "short_name":"р-р в/в и в/м введ", "count_text":"2 мл", "inn":[ { "id":"cf48db20-1c11-41ae-96a6-19cb6e83ddf3", "name_rus":"метамизол натрия", "name_eng":"metamizole sodium", "count_text":"500 мг/мл" } ] } ] } }
И аналогичный элемент FULLMEDICINES для расширенной информации об упаковке
Старый API:
Запрос по SKU_ID
Информация о лекарственной форме и МНН
{ "man_forms":[ { "inns":[ { "count":500, "count_end":null, "inn_id":"cf48db20-1c11-41ae-96a6-19cb6e83ddf3", "measure_unit_id":"4383f44b-4d32-4ea9-81a1-6732fabac813" } ], "dosage_form_id":"c17dcb50-a39e-4578-9dcb-82df4dd1f56b" } ] }
Запрос по id МНН:
{ "data":{ "id":"cf48db20-1c11-41ae-96a6-19cb6e83ddf3", "name_rus":"метамизол натрия", "name_eng":"metamizole sodium", "name_lat":"metamizolum natricum" } }
Запрос о единицах измерения:
{ "data": { "id": "4383f44b-4d32-4ea9-81a1-6732fabac813", "name": "миллиграмм на миллилитр", "sign": "мг/мл", … } }
Информация о первичной и потребительской упаковках:
{ "packs": [ { "level_type": "primary", "count": 10, "count_end": null, "type_id": "8ddbd462-e0a3-4551-84ea-d98032ffef4e", "man_form_packs": [ { "man_form_key": "c7fda1ca106eccded6717ec03b34e85519be48c061a19dd20166aabbe3cf6fd6", "count": 0.002, "count_end": null, "measure_unit_id": "fadb49f0-8e7b-4ce2-9e1c-26c11665c640" } ], "components": [] }, { "level_type": "consumer", "count": 1, "count_end": null, "type_id": "37d25638-0365-43b8-b87b-f1837a2b30b2", "man_form_packs": [], "components": [] } ] }
Запросы по типам упаковок (по одному для первичной и потребительской):
Первичная:
{ "data": { "id": "8ddbd462-e0a3-4551-84ea-d98032ffef4e", "name": "ампула", "code": "2", "is_primary": false } }
Пользовательская
{ "data": { "id": "37d25638-0365-43b8-b87b-f1837a2b30b2", "name": "пачка картонная", "code": "10622", "is_primary": false } }
Узнать подробнее, задать вопросы или подключить API