История изменений REST API
3.37
В этой версии мы отказались от возврата кода 204 (No Content) в случае успешного выполнения операции. Теперь успешное выполнение всегда отмечается кодом 200 (OK). Это является критическим изменением для систем, которые проверяли не просто успешный код возврата (2XX), а сравнивали результат с конкретным кодом 204.
Изменение связано с тем, что код возврата 204 требует дополнительных действий для поддержки в документации openapi, а код 200 подставляется автоматически. Соответственно, при использовании кода 204 остаётся больше возможностей для ошибки.
Чтобы документация и сгенерированный на её основе код всегда находился в правильном состоянии, принято решение использовать только код 200.
3.36
В версии API v1 тип атрибутов в записях с потреблением и интеграторами изменён с целого числа на массив. Это нужно для того, чтобы генераторы исходного кода не имели проблем с флаговыми значениями.
Кроме того, массивы гораздо понятнее показывают, что параметр может принимать несколько значений.
Запрос потребления тоже принимает массив флагов DeviceDataType вместо маски.
Поддержка прежней конечной точки связана с довольно большими трудозатратами, так что мы приняли решение пока не поздно изменить подход к использованию флагов.
Большое спасибо за понимание!