Если в документации к методу описаны только 200 и 500 ошибки — чего не хватает и что бы вы сделали?

Нужно уточнить контракт успешного ответа и ожидаемых ошибок: валидация, авторизация, отсутствие ресурса, конфликт и ограничения. 200 — успех, а не ошибка.

Составьте матрицу сценариев и согласуйте подходящие HTTP-статусы, структуру тела, стабильные коды ошибок и правила повторов. Не каждому методу необходимы все возможные статусы, но клиент должен различать исправимую ошибку ввода и временный сбой сервера. Добавьте примеры и контрактные проверки. Для 500 не публикуют stack trace и секретные детали; используют безопасное сообщение и идентификатор обращения для диагностики.