Table of Contents

3.37

В этой версии мы отказались от возврата кода 204 (No Content) в случае успешного выполнения операции. Теперь успешное выполнение всегда отмечается кодом 200 (OK). Это является критическим изменением для систем, которые проверяли не просто успешный код возврата (2XX), а сравнивали результат с конкретным кодом 204.

Изменение связано с тем, что код возврата 204 требует дополнительных действий для поддержки в документации openapi, а код 200 подставляется автоматически. Соответственно, при использовании кода 204 остаётся больше возможностей для ошибки.

Чтобы документация и сгенерированный на её основе код всегда находился в правильном состоянии, принято решение использовать только код 200.

3.36

В версии API v1 тип атрибутов в записях с потреблением и интеграторами изменён с целого числа на массив. Это нужно для того, чтобы генераторы исходного кода не имели проблем с флаговыми значениями.

Кроме того, массивы гораздо понятнее показывают, что параметр может принимать несколько значений.

Запрос потребления тоже принимает массив флагов DeviceDataType вместо маски.

Поддержка прежней конечной точки связана с довольно большими трудозатратами, так что мы приняли решение пока не поздно изменить подход к использованию флагов.

Большое спасибо за понимание!