Стандарты
AI-разработки

Понятные правила для людей и AI-агентов. С примерами, причинами и условиями применения.

Найти правилоСкачать всё .md111 правил · 15 разделов

Правила 8

APIОбязательно

HTTP-статусы

Клиент, прокси и мониторинг должны видеть результат запроса без разбора произвольного JSON.

Проверено 9 ноября 2026 г.
APIОбязательно

HTTP-методы

GET и HEAD читают; изменение бизнес-состояния должно иметь соответствующий метод.

Проверено 9 ноября 2026 г.
APIРекомендуется

Problem Details

Ошибка должна помогать исправить запрос без раскрытия внутреннего устройства сервера.

Проверено 9 ноября 2026 г.
APIОбязательно

Идемпотентность API

После потери ответа повторный запрос не должен создавать вторую оплату или заказ.

Проверено 9 ноября 2026 г.
APIРекомендуется

Оптимистическая блокировка

Проверяйте версию записи перед сохранением, если пользователь может перезаписать чужую работу.

Проверено 9 ноября 2026 г.
APIРекомендуется

Пагинация

Договоритесь о размере страницы, сортировке, фильтрах и продолжении списка.

Проверено 9 ноября 2026 г.
APIРекомендуется

HTTP-заголовки

Статус, формат содержимого и кеширование описываются стандартными средствами HTTP.

Проверено 9 ноября 2026 г.
Кеш и фоновые задачиОбязательно

Изоляция кеша

Ключ кеша и HTTP-политика должны учитывать пользователя, организацию и права.

Проверено 9 ноября 2026 г.

Недавно проверено

Границы задачиЕдиный источник истиныКонтракты компонентовВертикальный сценарий