Replit API: создать первый endpoint и проверить ответы
Как поручить Replit создать API приложения: учебный JSON, HTTP 200 и 404, проверка реальных запросов и различие Preview и публикации.
Ты хочешь, чтобы прототип отдавал данные другому приложению: например, статус учебного пилота для внутреннего дашборда. В Replit можно поручить агенту создать небольшой HTTP API и проверить его по заранее известным ответам.
Здесь создаём API твоего приложения, а не интерфейс управления аккаунтом Replit. Первый результат — адрес, который возвращает JSON с учебными данными. Ключ внешнего сервиса для этого не нужен.

1. Опиши договор между приложениями
Endpoint — это конкретный путь API с определённым поведением. В нашем примере запрос GET /api/pilots/atlas читает статус пилота Atlas. Он ничего не создаёт и не меняет.
| Запрос | Код ответа | Содержание |
|---|---|---|
| GET /api/pilots/atlas | 200 | Учебный статус Atlas |
| GET /api/pilots/unknown | 404 | Ошибка pilot_not_found |
| GET /api/health | 200 | Признак работы сервера |
Числа в ответе должны быть числами, а не строками. Не добавляй реальные имена клиентов и обращения: для проверки контракта достаточно вымышленных значений.
Ожидаемый JSON для Atlas:
{"id":"atlas","status":"pilot","invited":20,"active":12,"demo":true}
Для неизвестного пилота:
{"error":"pilot_not_found"}
2. Передай агенту задачу на небольшой сервер
Создай отдельный проект Replit. Агент работает с описанием на обычном языке, поэтому начинать с ручного написания сервера не обязательно. Вставь такой запрос:
Создай учебное web-приложение с серверным HTTP API.
Нужны только GET /api/health и GET /api/pilots/:id.
Для atlas верни HTTP 200 и JSON:
{"id":"atlas","status":"pilot","invited":20,"active":12,"demo":true}
Для другого id верни HTTP 404 и {"error":"pilot_not_found"}.
Для health верни HTTP 200 и {"ok":true}.
Content-Type ответов API — application/json.
Данные фиксированные, учебные. Не подключай БД, оплату и внешние API.
Сделай простую страницу с кнопками трёх проверок:
показывай HTTP-код и тело настоящего ответа через fetch.
Не подменяй запросы заранее нарисованным текстом.
Пока не публикуй проект. Покажи, где реализованы маршруты,
как запустить сервер и какие проверки действительно выполнил.
После создания открой Preview и нажми каждую кнопку. Если интерфейс красивый, но запросы не видны или значения зашиты только в страницу, задача ещё не выполнена. Попроси агента показать обработчики серверных маршрутов и обращение страницы к ним.
3. Проверь HTTP-ответ, а не только надпись
Открой инструменты разработчика браузера, вкладку Network, и повтори запрос. Выбери запись /api/pilots/atlas: проверь статус, тип содержимого и тело ответа. Для неизвестного значения нужен настоящий HTTP 404, а не HTTP 200 с текстом «ошибка».
Дополнительно попроси агента выполнить запросы из среды проекта:
Проверь три маршрута настоящими HTTP-запросами к запущенному серверу.
В отчёте покажи метод, путь, HTTP-код, Content-Type и тело ответа.
Отдельно проверь, что invited и active имеют числовой тип,
а demo — логический. Не называй проверку пройденной по коду
без фактического запроса. Если сервер недоступен, покажи ошибку.
Ожидается 20, 12 и true, без кавычек вокруг значений. Порядок полей JSON не важен. Важны имена, типы и смысл.
Проверь также путь с другим регистром, например /api/pilots/Atlas. В нашем контракте допустим только atlas, поэтому ожидается 404. Если хочешь разрешить разные регистры, сначала явно измени правило и тест. Не оставляй такое поведение случайным.
4. Раздели Preview и опубликованный адрес
Publishing в Replit создаёт отдельный запущенный экземпляр приложения. После изменений для обновления опубликованной версии нужна новая публикация. Поэтому успешная проверка в редакторе не доказывает, что внешний потребитель получает новый ответ.
Для серверного API нужен вариант публикации, поддерживающий выполнение сервера; статическая публикация сама по себе обработчики HTTP не исполняет. Перед публикацией проверь выбранный режим, условия оплаты и доступ. Затем повтори три запроса уже на опубликованном адресе.
| Симптом | Что проверить |
|---|---|
| Вместо JSON приходит HTML | Адрес, маршрут и не попал ли запрос на страницу входа |
| В Preview работает, снаружи нет | Публикацию, ограничения доступа и правильный адрес |
| Приходит старое значение | Опубликована ли новая версия |
| Неизвестный id даёт 200 | Настоящий код ошибки в обработчике |
Открытие адреса браузером — только проверка GET. Если позже добавишь POST или операции изменения, для них потребуются собственные правила, права доступа и тесты.
5. Подключай реальные сервисы отдельным этапом
Когда учебный контракт работает, можно заменить фиксированные данные источником. Если внешний сервис требует ключ, используй Secrets: секрет становится переменной окружения для приложения. Не включай его в JSON-ответ и клиентский JavaScript. Конфигурация публичного адреса и секрет доступа — разные виды данных.
Публичный демонстрационный endpoint не подходит для закрытой информации. Перед подключением реальных данных определи, кто вправе их читать, и проверяй это на сервере. Начни с одного читающего маршрута, без автоматических изменений в CRM.
Перед расширением сохрани checkpoint проекта. Для общей постановки продукта есть руководство по прототипу в Replit, а практику можно продолжить на курсе под статьёй.
Документация проверена 20 ноября 2026 года. Это учебная спецификация API и план приёмки; проект в Replit и публичный endpoint при подготовке статьи не создавались.
Собери своего ИИ-агента и проверь результат
«AI Agents: от vibe coding к AI-команде»: desktop agents, MCP, skills, evals и harness. Отдельные воркшопы — от подключения инструментов до контроля качества.
7 практических воркшопов · записи · вопросы автору в чате
Посмотреть программу курса ↗