Problem Details
Ошибка должна помогать исправить запрос без раскрытия внутреннего устройства сервера.
Проверено Изменено
Плохо
{"error":"SQL exception at /private/app/main.go:42"}
Хорошо
{"type":"https://example.com/problems/validation",
"title":"Проверьте поля", "status":422,
"errors":[{"field":"email","message":"Неверный формат"}]}
Почему это важно
Стек вызовов и SQL не помогают пользователю и могут раскрыть лишние сведения.
Когда применять
Problem Details задаёт общую основу; errors и request_id — документируемые расширения, а не обязательные поля RFC.
Кто что делает
Человек
Определяет понятные пользователю коды ошибок и допустимые детали ответа.
AI-агент
Реализует серверный контракт и проверяет успешный запрос, неверный ввод и повторное обращение.
Контроль результата:
- Можно ли понять ошибку? Нет ли секретов и внутренних путей?
Как проверить у себя
- Можно ли понять ошибку? Нет ли секретов и внутренних путей?
Первоисточники
История изменений на GitHubДата проверки отражает содержательную сверку. Синхронизация сайта не обновляет её автоматически.