Это проектная спецификация, а не работающее API: реализации ещё нет, адреса могут измениться.

Страница ещё не написана. Ниже — что об этом уже известно

Ошибки

Как выглядит ошибка #

Код HTTP отражает результат, тело — детали. Никаких 200 OK с success: false внутри.

Что означает каждый и что с ним делать клиенту.

Массив ошибок валидации вместо «исправляйте по одной».

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