OEI API — документация | Аналитика ОЕИ

Для чего подходит API

Поиск поверок

Запросы по идентификатору, заводскому номеру, модификации и другим характеристикам.

Передача данных

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

Автоматизация

Сокращение ручного переноса данных и повторных действий при обработке записей.

Доступ и подключение

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

Адрес и метод: GET https://oei-analitika.ru/eapi/vri/

Ключ: передаётся параметром regkey. Не публикуйте действующий ключ; выполняйте запросы по HTTPS и храните ключ на сервере.

Объём: в предоставленном обработчике предусмотрено до 10 000 записей за запрос. Для разделения выборки можно задавать диапазоны идентификаторов; порядок выдачи не гарантирован.

Параметры запроса

Для запроса необходим regkey и хотя бы один фильтр. Фильтры можно сочетать. Имена параметров чувствительны к регистру.

Совместимость: в ранней документации встречаются прежние названия mit_number, mit_title и mit_notation. В описанной версии используются mitypeNumber, mitypeTitle и mitypeType. Перед внедрением проверьте совместимость с установленной версией API.

Параметр	Назначение	Правило из справки
`regkey`	Ключ доступа API	Персональный ключ; обязателен в предоставленной версии обработчика.
`vri_id`	Идентификатор записи	Точное значение идентификатора поверки.
`vri_id_from`	Нижняя граница ID	Идентификатор поверки не меньше указанного.
`vri_id_to`	Верхняя граница ID	Идентификатор поверки не больше указанного.
`mi_number`	Заводской номер СИ	Точное совпадение.
`mi_modification`	Модификация СИ	Точное совпадение.
`mitypeTitle`	Наименование типа СИ	Допускается часть наименования.
`mit_MPISI`	Межповерочный интервал	Текстовое значение; допускается часть фразы.
`mit_id`	ID типа СИ	Целое число; полное совпадение.
`mitypeType`	Обозначение типа СИ	Допускается часть обозначения.
`mitypeNumber`	Регистрационный номер типа СИ	Полное совпадение, например 23345-07.
`org_title`	Организация-поверитель	Допускается часть наименования.
`mi_manufactureYear`	Год выпуска СИ	Целое число; полное совпадение.
`mi_signCipher`	Шифр знака поверки	Полное совпадение.
`mi_Owner_name`	Владелец СИ	Допускается часть наименования.
`mit_owner_CountrySI`	Страна производства	Полное совпадение.
`mit_owner_SettlementSI`	Населённый пункт производства	Допускается часть названия.
`mit_owner_ManufacturerSI`	Производитель СИ	Допускается часть наименования.
`docTitle`	Документ о поверке	Допускается часть наименования.
`poverka_publication_date`	Дата публикации	ДД.ММ.ГГГГ.
`poverka_valid_date`	Дата окончания действия	ДД.ММ.ГГГГ.
`poverka_verification_date`	Дата поверки	ДД.ММ.ГГГГ.
`poverka_verification_month`	Месяц поверки	ММ.ГГГГ.
`poverka_verification_year`	Год поверки	ГГГГ.
`poverka_vriType`	Вид поверки	Значение 0, 1 или 2.
`perpage`	Максимум записей	От 1 до 10 000, по умолчанию 10 000.
`export_type`	Формат ответа	1 — текстовый массив, 2 — JSON, 3 — XML; по умолчанию 1.

Текстовые значения в URL следует кодировать. Тип совпадения для каждого фильтра указан в таблице. Неизвестные параметры вызывают ошибку 400.

Примеры запросов

Замените ВАШ_КЛЮЧ действующим ключом. Значения в примерах условные; фактический состав результатов зависит от данных и версии API.

По идентификатору поверки

Найти запись с известным идентификатором.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&vri_id=179725564

По заводскому номеру

Найти записи по точному заводскому номеру.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&mi_number=5328&export_type=2&perpage=10

По диапазону идентификаторов

Ограничить выборку заданным диапазоном.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&vri_id_from=120000000&vri_id_to=121000000

По номеру и диапазону

Совместить условия в одном запросе.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&mi_number=5328&vri_id_from=120000000&vri_id_to=121000000

По модификации СИ

Найти записи по точному обозначению модификации.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&mi_modification=WFW2

По номеру типа СИ

Найти поверки СИ по регистрационному номеру типа.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&mitypeNumber=23345-07

По месяцу поверки

Отобрать записи за указанный месяц и получить JSON.

GET https://oei-analitika.ru/eapi/vri/?regkey=ВАШ_КЛЮЧ&poverka_verification_month=11.2026&export_type=2

Пример ответа JSON

Схематический пример: значения вымышлены и показаны только для пояснения структуры. Фактическая выдача содержит больше полей. Для JSON укажите export_type=2.

[
  {
    "id": 0,
    "vri_id": "179725564",
    "mi_number": "5328",
    "mitypeNumber": "23345-07",
    "mitypeTitle": "Счётчик воды",
    "verification_date": "15.01.2026",
    "valid_date": "15.01.2032"
  }
]

Какие сведения возвращаются

В предоставленном обработчике сформированы перечисленные ниже поля. Наличие и заполнение отдельных значений зависят от исходных данных. Формат задаётся параметром export_type: 1 — текстовый массив (по умолчанию), 2 — JSON, 3 — XML.

Поле	Содержание
`id`	Порядковый номер элемента в выдаче; отсутствует в XML.
`vri_id`	Идентификатор записи о поверке.
`mi_number`	Заводской номер СИ.
`mi_modification`	Модификация СИ.
`mi_manufactureYear`	Год выпуска СИ.
`mi_signCipher`	Условный шифр знака поверки.
`mi_Owner_name`	Наименование владельца СИ.
`org_title`	Наименование организации-поверителя.
`fsa_ral_regNumbers_regNumber`	Регистрационный номер аттестата аккредитации.
`mitypeNumber`	Регистрационный номер типа СИ.
`mitypeTitle`	Наименование типа СИ.
`mitypeType`	Обозначение типа СИ.
`mitypeURL`	Ссылка на тип СИ в реестре.
`mit_id`	Идентификатор типа СИ.
`mit_owner_CountrySI`	Страна производства.
`mit_owner_SettlementSI`	Населённый пункт производства.
`mit_owner_ManufacturerSI`	Наименование производителя.
`mit_MP_doc`	Сведения о методике поверки.
`mit_MP_link`	Ссылка на методику поверки.
`mit_MPISI`	Межповерочный интервал.
`docTitle`	Наименование документа о поверке.
`verification_date`	Дата поверки.
`valid_date`	Дата окончания действия результатов поверки.
`publication_date`	Дата публикации записи.
`vriType`	Вид поверки.
`result_docnum`	Номер документа о результате.
`result_doc_type`	Тип документа о результате.
`additional_info`	Дополнительные сведения.
`means_npe`	Применённые государственные первичные эталоны.
`means_uve`	Применённые эталоны единиц величин.
`means_mieta`	Сведения об СИ, используемых в качестве эталонов.
`means_ses`	Применённые стандартные образцы.
`means_mis`	Применённые средства измерений.
`means_reagent`	Сведения о применённых реагентах.

В прежней справке те же сведения о типе СИ назывались mit_number, mit_title, mit_notation, mit_link; в предоставленном обработчике используются mitypeNumber, mitypeTitle, mitypeType, mitypeURL. Для интеграции сверяйте названия с установленной версией.

Ответы при ошибках

Код	Значение
`400`	Некорректный запрос или параметры.
`403`	Ключ недействителен или оплаченный срок доступа истёк.
`405`	Неподдерживаемый метод запроса.
`503`	Не удалось выполнить запрос; повторите позднее.

Коды приведены по предоставленной версии обработчика. Для конкретной установки могут потребоваться дополнительные условия обработки ошибок.

Нужна помощь с подключением?

Обсудите доступ и интеграцию с командой «Аналитики ОЕИ».

Связаться с нами Посмотреть тарифы →