Стоимость разработки API считают по операциям и правам, а не по числу адресов

Сколько стоит разработка API для вашей системы? Начните с действий партнёра. По адресу /orders можно читать список и создавать заказ.

Чтение и создание требуют разной работы. В одном случае сервер отдаёт разрешённые данные, в другом меняет состояние системы.

В OpenAPI операция описана вместе с входом и ответами. Ниже учебный API заказов, не наш клиентский кейс.

Операции используют общий фундамент. Выдача ключей, единый формат ошибок и тестовое окружение не создаются заново для каждой строки.

Сравнивайте предложения на одном списке. Цена за метод без прав, тестов и документации ещё не описывает готовую операцию.

Если правила уже есть в системе, их можно использовать. Если поведение известно лишь сотруднику, его сначала придётся описать.

Ключ партнёра подтверждает, кто пришёл. Право читать конкретный заказ проверяется отдельно. OWASP описывает эту разницу в API Security.

Партнёру можно показать статус его заказа и скрыть внутреннюю маржу. При создании сервер не должен доверять присланному имени владельца.

Копия внутренней записи в ответе обходит эти решения. В смете нужна матрица доступа, а в приёмке нужны запросы от разных партнёров.

Партнёр отправил заказ, сервер его сохранил, но ответ потерялся. При повторе сервер должен узнать тот же запрос, иначе появится второй заказ.

Такую механику показывает документация Stripe. Для своего API надо согласовать ключ повтора, срок его хранения и ответ при конфликте.

Демонстрация «заказ создан» этого не доказывает. Проверьте повтор после потери ответа и одновременную отправку того же запроса.

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

Лимиты защищают бюджет эксплуатации. Размер списка, частоту запросов и объём загрузки задают до запуска; OWASP выделяет расход ресурсов отдельно.

Версии влияют на будущую стоимость. Если партнёр читает старый формат, изменение поля требует проверки его клиента и плана перехода.

Наш случай с ошибкой 500 был поломкой ответа. Функция вернула новое поле, которое валидатор не принимал. Тесты эту границу не проверяли.

После починки появился тест сопоставления ответа с валидатором. Адрес функции прежний, но к работе добавилась проверка договорённости.

Инженер ведёт машину агентов этого сайта. Клиентского кейса цены API у нас нет; ниже поломки собственной машины и правила после них.

Приёмка API проверяет поведение, а не только успешный код ответа. Сервер может ответить успешно и при этом показать чужие данные.

Список обещаний должен совпадать со списком проверок. Для отмены заказа нужен тест статуса после отказа, для списка нужен тест видимых полей.

Ответственность за ошибки агента разбираем отдельно. Здесь CTO принимает операцию вместе с доказательством её поведения.

ИИ-агент может подготовить обработчик, проверки и примеры запросов. Решение, кому разрешить отмену и что считать готовым, принимает владелец API.

В задаче для ИИ-агента нужны результат и условия приёмки. Фраза «сделать REST API» их не содержит.

Операцию сдают вместе с проверками. Урок курса «Одиннадцать шагов одной задачи» устроен вокруг этого пути, а не вокруг набора кода.

Для очереди новых операций есть разработка по подписке. «Один проект» стоит 250 000 ₽ в месяц; цена проверена 8 октября 2026.

Инженер ведёт машину ИИ-агентов, код идёт в вашу ветку в вашем репозитории. В потоке работает одна задача, следующая ждёт в очереди.

На архитектуру и ночные дежурства этот тариф не распространяется. Архитектурные решения принимает ваша сторона; объём реализации согласуют на звонке.

Начните с операции, которая проверяет сложность вашего API. Для примера заказов это создание с правами и безопасным повтором, а не открытый список.

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

Месячный отчёт должен показывать принятые операции и причины задержек. Список написанных адресов или число коммитов этого не заменяет.

Когда матрица готова, можно обсудить задачи API и формат работы с инженером.

1. Зафиксируйте операции и общий фундамент отдельно: число адресов не описывает работу.
2. Приложите матрицу доступа к объектам и полям, включая запрещённые действия.
3. Включите повтор, отказ и совместимость ответа в критерии приёмки.
4. Примите первую операцию с тестами, затем уточните оставшийся бюджет.
5. Сверяйте оплаченные месяцы с принятыми операциями; эксплуатацию считайте отдельно.