Проверка if (!body.field) не определяет обязательность: она одинаково отвергает false и 0, но иногда пропускает пробелы, null после coercion или default из framework. Сначала перечислите допустимые состояния каждого поля. Для create отсутствие обычно ошибка; для PATCH отсутствие часто означает «не менять», а явный null — отдельную операцию только если контракт её разрешает.
Валидация на HTTP-границе должна остановить заведомо неверную форму запроса до business logic. Но база и domain model всё равно обязаны защищать критичные инварианты: другой entry point, background job или старая версия сервиса не должны создать объект без владельца, валюты или ключевого статуса.
Четыре payload выглядят похоже, но значат разное
| Вход | Смысл | Обычная политика |
|---|---|---|
| {} | Property отсутствует | Create: error; PATCH: оставить |
| {"enabled": null} | Явный null | Разрешить только nullable field |
| {"name": ""} | Пустая строка | Проверить minLength после trim policy |
| {"enabled": false} | Валидный boolean false | Не считать отсутствием |
| {"count": 0} | Валидный ноль | Проверить minimum, не truthiness |
Контракт делает отсутствие проверяемым
{
"type": "object",
"required": ["name", "enabled", "count"],
"properties": {
"name": { "type": "string", "minLength": 1 },
"enabled": { "type": "boolean" },
"count": { "type": "integer", "minimum": 0 }
},
"additionalProperties": false
}JSON Schema считает properties описанием известных свойств, но само по себе не делает их обязательными: для этого нужен массив required. Type string не запрещает пустую строку, поэтому добавлен minLength. Нужно отдельно решить, обрезает ли API пробелы: скрытая нормализация может менять подпись запроса, audit и данные клиента.
Request body и его properties имеют разные required
В OpenAPI флаг required у requestBody означает, что тело должно присутствовать. Обязательность name внутри JSON задаёт required в Schema Object. Если включить только первое, пустой объект останется допустимым; если включить только второе, поведение отсутствующего body зависит от operation и tooling. Проверяйте сгенерированную схему и реальный runtime validator вместе.
Не полагайтесь только на сгенерированный client: злоумышленник, старая версия приложения или обычный curl обходят UI и типы SDK. OWASP рекомендует валидировать как можно раньше и применять allowlist ожидаемых значений и форматов, а не пытаться вычёркивать известные плохие строки.
PATCH требует отдельной схемы намерения
- Отсутствующее поле означает «не изменять» и не подменяется default.
- Явный null разрешён только для операции очистки nullable значения.
- Immutable поля либо запрещены, либо игнорирование документировано — лучше вернуть ошибку.
- Хотя бы одно изменяемое поле должно присутствовать, если пустой PATCH не поддерживается.
- Условные требования описываются бизнес-правилом или if/then schema, а не truthy-проверкой.
- Версия ресурса или If-Match защищает от потери параллельного изменения.
Не переиспользуйте create DTO для PATCH, делая все поля optional и затем записывая null/default в отсутствующие колонки. Модель обновления должна хранить сам факт присутствия property. Иначе запрос, меняющий только title, может неожиданно сбросить enabled=false, owner или настройки доставки.
Ошибка указывает правило и путь без эха секретов
{
"type": "https://api.example.test/problems/validation",
"title": "Request validation failed",
"status": 422,
"errors": [
{ "pointer": "/name", "code": "required" }
]
}Адрес условный. Клиенту достаточно стабильного code и JSON Pointer; не возвращайте весь payload, regex внутреннего валидатора, stack trace или значение password/token. Выберите 400 или 422 согласно существующему контракту и применяйте его последовательно — смена статуса может сломать retry и UI клиентов.
Негативные тесты важнее одного валидного примера
- Отправить отсутствующее поле, null, пустую строку, false и 0 отдельно.
- Проверить лишнее неизвестное property и неверный тип.
- Повторить JSON с duplicate keys через используемый parser policy.
- Сравнить create, full replace и PATCH semantics.
- Убедиться, что отказ не оставил частичную запись или side effect.
- Вызвать тот же domain use case из background job.
- Сверить runtime response с OpenAPI contract test.
Приёмка без тихих defaults
Исправление готово, когда каждый недопустимый input получает предсказуемую ошибку до записи, false и 0 сохраняются без искажения, PATCH не стирает отсутствующие поля, а database constraint ловит обход application validation. Для ревью нужны OpenAPI/JSON Schema, четыре обезличенных payload, response status/body, mapping DTO → domain и список side effects; production-токены и реальные персональные данные не нужны.