avtocod/specs

Specifications repository

Maintainers

Details

github.com/avtocod/specs

Source

Issues

Installs: 41 747

Dependents: 1

Suggesters: 4

Security: 0

Stars: 6

Watchers: 8

Forks: 18

Open Issues: 3

Language:TypeScript

v3.160.0 2024-11-05 06:36 UTC

This package is auto-updated.

Last update: 2024-11-05 06:40:21 UTC


README

avtocod

Публичные спецификации проекта "Автокод"

Release version Release date Commits since latest release

Данный репозиторий содержит публичные спецификации, связанные с проектом "Автокод".

Поля данных отчёта (филды)

Поля данных (далее по тексту - филдлы) обладают следующими свойствами:

  • Филд имеет уникальный путь (path);
  • Пути (path) филдов являются фиксированными;
  • Имя филда данных состоит из букв латинского алфавита в нижнем регистре;
  • При необходимости разделить имя филда данных на составные слова используется символ "подчеркивания" (_);
  • Для группировки различных филдов используется нотация с помощью точки (.);
  • Глубина "вложенности" нотаций может быть произвольной;
  • Для указания того, что элемент пути филда является массивом используется обозначение [] (добавляется в конец группы филда).
  • Для указания типа данных, которые может содержать филд могут использоваться следующие ключевые слова - array, boolean, float, integer, object, string, null;
  • Каждый филд может быть null.

Пример нотации с помощью точки:

Имеется набор филдов: name, year, vin, owner_name. Все они относятся к базовым характеристикам ТС, кроме owner_name, который относится к данным владельца. В этом случае их именование будет иметь следующий вид: base.name, base.year, base.vin, owner.owner_name.

Пример использования указателя массива:

Отчёт содержит набор данных о датах и местах прохождения технического осмотра ТС. Филды этих данных имеют вид diagnostic_card.items[].date и diagnostic_card.items[].place соответственно. Это означает, что diagnostic_card.items[] - это массив, элементами которого являются объекты, имеющие ключи date и place.

Описание всех филдов вы можете найти в данном файле, json-schema отчёта располагается в этом файле.

Примеры отчётов: с данными, без данных.

Типы идентификаторов

Для создания отчёта необходимо передать тип и значение идентификатора (VIN-код, номер СТС и т.п.).

Поддерживаемые типы идентификаторов и их описания перечислены в данном файле.

Имена источников

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

  • Имя источника состоит из букв латинского алфавита в нижнем регистре;
  • Для группировки различных источников используется нотация с помощью точки (.);
  • Каждый источник наполняет данными фиксированный набор филдов;
  • Если несколько источников наполняют данными одни и те же филды - в отчёт попадают данные от того источника, который нами считается наиболее доверительным.

Со всеми поддерживаемыми нами источниками вы можете ознакомиться в данном файле.

Идентификаторы марок и моделей транспортных средств

Отчет может содержать данные о марках и моделях транспортных средств, включая их уникальные идентификаторы, состоящие из символов A-Z, цифр и символа _.

Со всеми поддерживаемыми нами идентификаторами вы можете ознакомиться в файлах марок и моделей.

Модели поделены по категориям типа ТС. Пример: models_bus.json - автобусы.

С идентификаторами типов моделей вы можете ознакомится в файле спецификации.

Обновления и версионирование

Данные, содержащиеся в данном репозитории обновляются с течением времени. Измененные состояния фиксируются с помощью тэгирования с присвоением соответствующего значения версии. Значения версий присваиваются в соответствии с правилами семантического версионирования.

На данный момент существуют 3 мажорные версии:

  • v1 - устаревшая (не поддерживается с 22 июня 2018 года);
  • v2 - устаревшая (не поддерживается с 19 февраля 2019 года);
  • v3 - актуальная.

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

SDK

Список SDK для удобного доступа к данным спецификациям:

Поддержка

Если у вас возникли какие-либо проблемы при работе с данным репозиторием, пожалуйста, создайте соответствующий issue перейдя по данной ссылке.