Сравнение двух 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