Развитие REST Api

Здравствуйте!
Необходима ли дополнительная настройка веб-служб, для доступа к новому REST API (/rest/v1/)?
Испытываю проблемы с авторизацией:

No HTTP resource was found that matches the request URI 'http://192.168.11.11/rest/v1/auth/Login'

И интересует вопрос о развитии функциональности данного API. Он как минимум будет дублировать SOAP? Сейчас стоит выбор, или писать шлюз или подождать реализации данного протокола. Спасибо.

Для доступа к веб-службе и новому REST API достаточно установить веб-интерфейс на компьютер.

No HTTP resource was found that matches the request URI '> http://192.168.11.11/rest/v1/auth/Login> ’

У вас появляется данная ошибка, т.к. ресурса по данному адресу не существует. Мы не публиковали документацию по новой авторизации, т.к. она еще не окончательна, и может меняться. По возможности используйте старую авторизацию, она совместима с новым REST API.

В данный момент функционал нового API сравним со старым по объему, он дублируется лишь частично, но по запросу мы можем быстро перенести функционал. Старый API мы планируем поддерживать и незначительно дорабатывать по запросам. Новый API мы используем в новом веб-интерфейсе, поэтому сейчас он часто меняется и активно развивается. Мы готовы добавлять новые функции по запросу.

В версии R24 будет изменен путь до ресурсов (названия в единственном числе заменены на множественное число).
Подробную информацию по новому REST API смотрите в предварительной документации REST Api (в разработке)
Возможно, нам стоит публиковать новости по разработке REST Api, например, в канале telegram. Интересно это кому-нибудь?

Сейчас в новом API есть работа со следующими ресурсами:

  • Аутентификация
  • Точки учета, потребление по ним и показания, детальное состояние, последние данные
  • Объекты учета, детальное состояние
  • Нештатные ситуации
  • Группы объектов учета
  • Уведомления (центр уведомлений)
  • Опрос текущих по точке учета
  • Экспорт отчетов в pdf
  • Подписка на уведомления об изменении объекта учета через библиотеку SignalR

Напишите какой еще вам нужен функционал.

Спасибо! С куки разобрался, авторизация прошла успешно. Можно и через Веб-интерфейс, и через СОАП получит сессию.
Планирую пока перенести текущий функционал со старой версии.

По предложениям: возможно у Вас запланировано, но хотелось бы побыстрее увидеть Api-root, как в СОАП или каком-нибудь django-rest-framework. Там же и ченжлог вести можно, всё в одном месте будет.

Спасибо за предложение, автоматически формируемая документация по новому Rest Api появится в 3.07 R24 и будет доступна по пути /rest
Пока она не содержит описание моделей, перечислений, но они одни и те же для двух веб-сервисов, поэтому вы можете найти по ним документацию в описании старого веб-сервиса.

Что станет с текущей реализацией Web Api, вы ее уберете?

Старый (текущий) API мы планируем продолжать поддерживать и незначительно дорабатывать по запросам.

Отлично, я вам предлагаю в таком случае посмотреть в сторону проекта, который включает себя инструменты и официальную спецификацию Open API для работы с REST
пример здесь: Swagger UI
Суть в том, что мы описываем посредством обычного JSON все входные и выходные точки, так же мы можем следить за методами которые удаляются (становятся deprecated) или наоборот добавляются, в примере можно увидеть.
Спецификация здесь: https://swagger.io/specification/

Сам работаю сейчас над реализацией для вашего API такого схемы в моем проекте. Помимо этого есть кодогенераторы, которые позволяют получать из этой схемы готовый код на любом языке (например GitHub - Azure/autorest: OpenAPI (f.k.a Swagger) Specification code generator. Supports C#, PowerShell, Go, Java, Node.js, TypeScript, Python)

Спасибо за ваше участие в обсуждении.

В версии 3.07 R24 файл описания нового REST Api cгенерированный по спецификации Open Api будет доступен по следующему пути /rest/docs/v1 (относительно вашего веб-интерфейса). Сформированная документация на основе этого файла будет доступна по пути /rest .

На данный момент можете ознакомиться по ссылке.

:co_ol: отлично, как видите работа с endpoint будет очень прозрачной и упростит интеграцию ЛЭРС Учет со сторонними проектами