Cursor Rules для API: api.mdc без двойных заказов
Готовый api.mdc: контракт ответов, идемпотентность, ошибки внешних сервисов и пагинация
Какую задачу решает
Создавать устойчивые API с правилами для агента
Что будет на выходе
Правила Cursor для API: эндпоинты, авторизация, нагрузки
- Кому подойдёт
Вайбкодер в Cursor, которому нужны правила агента для темы «API»
- Тема
- Агенты и Claude Code
- Инструменты
- Cursor
Ты просишь Cursor подключить оплату или отправку заявок в CRM, и он пишет рабочий с виду код. Потом выясняется, что при повторе запроса заказ создаётся дважды, ошибка внешнего сервиса превращается в белый экран, а список клиентов отдаётся целиком, пока их пятьдесят, и падает, когда их становится десять тысяч.
Правила Cursor решают это заранее. Файл api.mdc в папке .cursor/rules/ подключается автоматически, когда агент работает с кодом API и интеграций. Ниже промпт, который соберёт полное содержимое этого файла под твой проект: формат ответов, повторы без дублей, обработку ошибок и постраничную выдачу.
Перечисляешь свои эндпоинты и внешние сервисы, получаешь api.mdc с правилами: единый формат ответа и ошибок, защита от двойных операций, таймауты и повторы для внешних API, пагинация для списков. Cursor применяет их каждый раз, когда трогает этот код.
Что получишь
- 📐Контракт ответов
Один формат для успеха и ошибки, понятные коды ответа, правило: поля в существующих ответах не переименовываются и не удаляются без тебя.
- 🔁Повтор без дублей
Операции, которые создают заказ, списывают деньги или отправляют письмо, защищены ключом идемпотентности: повтор запроса не создаёт вторую запись.
- 🧯Ошибки внешних сервисов
Таймаут на каждый внешний запрос, ограниченное число повторов, понятное сообщение пользователю и запись в лог без ключей и личных данных.
- 📄Пагинация
Ни один список не отдаётся целиком: лимит по умолчанию, максимальный лимит и стабильная сортировка.
Как использовать
- 1Выпиши эндпоинты и интеграции
Хватит списка: какие адреса есть у твоего API, какие внешние сервисы ты вызываешь (оплата, CRM, почта, мессенджеры), как устроен вход.
- 2Запусти промпт в Cursor
В чате Cursor агент сам посмотрит маршруты и код интеграций. Если чего-то не хватает, он спросит.
- 3Сохрани файл
Попроси: «Сохрани это как .cursor/rules/api.mdc». Ответ начинается с блока между строками --- — это настройки правила, их тоже сохраняй.
- 4Проверь, что правило подхватилось
Открой файл с маршрутами и попроси добавить эндпоинт для списка. Если агент сам добавил пагинацию и формат ошибки, файл работает.
Рядом по теме: Cursor Rules для безопасности: готовый security.mdc, Cursor Rules для тестов: готовый tests.mdc, Cursor Rules для архитектуры: готовый architecture.mdc, статья «Cursor или Claude Code» и 12 модов Claude Code для вайбкодера (490 ₽).
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
Повторы и потерю событий в оплате подробно разбирает материал про вебхуки оплаты, а подключить ИИ к рабочим сервисам напрямую поможет MCP простыми словами. Перед выкладкой проверь проект на утечки ключей.
