04 апр. 2023
СТАТЬИ

Сравнение двух API

Новый API упрощен до всего одного запроса и уже обогащен всеми необходимыми данными. В предыдущей версии API нужно было сделать несколько запросов на обогащение справочных данных.

Ниже мы покажем примеры ответов и отличие в количестве запросов.

Узнать подробнее, задать вопросы или подключить API Pharm-ID+ — свяжитесь с нами любым удобным способом.

Например, необходимо получить следующую информацию о SKU:

Название препарата:

  • Общее наименование препарата
  • Торговое наименование препарата

Информацию о производителе:

  • Наименование производителя
  • Страну производителя
  • Адрес производителя

Краткое и полное описание упаковки:

  • Лекарственную форму
  • Действущее вещество (МНН)
  • Дозировку (и единицы измерения)
  • Общее количество
  • Информацию о первичной упаковке
  • Информацию о потребительской упаковке

Что нужно было ранее:

1. Выполнить запрос общей информации об упаковке, получив множество id параметров SKU
2. Для полученных данных из общей информации:
2.1. Выполнить запрос для получения справочной информации о производителе
2.2. После для полученных id двумя запросами получить
  • Страну производителя
  • Адрес производителя
3. Для получения данных о МНН, лекарственной форме надо выполнить еще 2 запроса. Взять id МНН и id единиц измерения:
3.1. Запросить по информацию о МНН
3.2. Запросить информацию о единицах измерения
4. Для получения информации данных об упаковке, выполняем очередные 2 запроса, взяв id из первого запроса:
4.1. Запрос данных о первичной упаковке
4.2. Запрос данных о потребительской упаковке

Соответственно, для получения только этой информации требовалось выполнить не менее 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 Pharm-ID+ — свяжитесь с нами любым удобным способом.

Информация на сайте предназначена для медицинских специалистов. Проконсультируйтесь с врачом, перед приёмом лекарственных препаратов.