Dev48
ЯЗЫК
  • О нас
  • Услуги
  • Индустрии
  • Технологии
  • Статьи
  • Контакты
Забронировать звонок
    Главная/Статьи/Sozdanie portala razrabotchika s pomoschyu postman i fern za odin den
Dev48
info@dev48.org+375 29 320-40-96WhatsApp@isky_by

© 2026 · Все права защищены.

Создание портала разработчика с помощью Postman и Fern за один день

Фото: GLady (Pixabay) — https://pixabay.com/photos/butterfly-insect-animal-44882/

Источник: Postman Blog•17 ноября 2026 г. в 16:11

Создание портала разработчика с помощью Postman и Fern за один день

Узнайте, как создать портал разработчика с помощью Postman и Fern, используя коллекции с поддержкой Git и MDX. Запустите документацию за день без затрат на SaaS или фронтенд-разработку. Статья «Создание портала разработчика с помощью Postman и Fern за один день» впервые появилась в блоге Postman.

17 ноября 2026 г.

Как бывший руководитель API-платформы и владелец продукта, я знаю, насколько важен портал для разработчиков API. Это не просто витрина для ваших API. Хороший портал выполняет огромную работу для всей организации:

  • Он документирует ваш API и упрощает его обнаружение и интеграцию для других разработчиков, особенно если вы подкрепляете его SDK и примерами кода.
  • Он ускоряет внутренний и внешний онбординг благодаря контактным формам, API-ключам самообслуживания и пошаговым руководствам.
  • Он уведомляет разработчиков об изменениях в API, от новых версий до критических изменений.
  • Он предоставляет разработчикам и бизнес-аналитикам единый источник знаний, что становится всё важнее по мере роста текучести кадров.
  • Он делает ваши API-продукты осязаемыми для нетехнических стейкхолдеров и владельцев бюджета, у которых часто нет другого способа увидеть, что именно создает команда.
  • Он рекламирует вашу компанию техническим B2B-партнерам. Разработчики могут с первого взгляда понять, является ли API-программа приоритетной, просто взглянув на портал.

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

Я на горьком опыте убедился, что портал разработчика требует выделенного бюджета и ресурсов. Эти ресурсы обычно появляются только тогда, когда давление по выпуску новых API невелико. Грубо говоря, владельцы бюджета почти всегда ставят новый API выше новой страницы на сайте, поэтому портал и API в конечном итоге конкурируют за одни и те же ресурсы команды.

Это не обязательно должно быть так. Помимо привлечения своих сотрудников к фронтенд-разработке, другим вариантом всегда было специализированное SaaS-решение. Оно работает как центральная CMS для портала, но требует закупок, онбординга, очень высоких лицензионных сборов, и кто-то все равно должен его поддерживать. Тратить 100 тысяч долларов в год на портал разработчика и занимать людей его поддержкой вместо создания API — это никогда не казалось мне правильным. Мы этого не делали.

Как команда API-платформы, мы поддерживали полный жизненный цикл API, от идеи и проектирования до реализации, тестирования и обслуживания, как внутри компании, так и для внешних клиентов. Мы уже настолько сильно полагались на один инструмент для всего этого, что не рассматривали его как третий вариант. Postman был нашим источником истины для совместной работы, от проектирования до тестирования, для создания и использования API. Использование его для документации оказалось самым эффективным способом создать витрину для наших API без существенного изменения технологического стека. Это стало еще более актуально после того, как Postman приобрел Fern. Fern работает поверх существующих коллекций Postman и генерирует порталы разработчиков, которые можно глубоко настраивать, даже если вы не разработчик. (Полное раскрытие информации: я работаю в Postman.)

Позвольте мне показать вам, на мой взгляд, самый эффективный способ создания портала разработчика с использованием технологий, которые, скорее всего, уже есть в вашей компании. Это не требует нового программного обеспечения. Вы просто более эффективно используете то, что у вас уже есть, вместе с Fern.

На схеме показана архитектура высокого уровня. Ваша API-команда продолжает заниматься API, и вам не нужно дорогое SaaS-решение. Postman, скорее всего, уже работает поверх вашего существующего проекта API с поддержкой Git. Fern берет существующие коллекции и спецификации, добавляет файлы .mdx для визуализации и публикует все по URL-адресу, который можно привязать к вашему собственному домену.

Я придумал вымышленную авиакомпанию под названием JSON Jet Airways и попросил Claude сделать все возможное для визуализации. Вот что получилось примерно за час: Портал разработчика JSON Jet.

Как я это построил

Я почти все сделал через кодинг-агент, вместо того чтобы кликать по интерфейсу. Вот путь:

  • Подключите свой кодинг-агент к Postman с помощью плагина Postman.
  • Попросите агента создать публичное рабочее пространство (Public Workspace) с интеграцией Git.
  • Попросите агента обновить документацию коллекции и рабочего пространства.
  • Пусть агент автоматически опубликует портал разработчика в Fern для вас.
  • Зарегистрируйтесь в Fern (бесплатно для начала). Будет создан репозиторий GitHub. Получите права владения этим репозиторием в панели управления Fern.
  • Клонируйте репозиторий и работайте с Fern CLI, который я использую ежедневно.
  • Внутри репозитория вы найдете файлы .mdx в папке root/fern/docs/pages. Каждый файл — это страница на вашем новом портале разработчика.
  • Позвольте вашему агенту изменять эти файлы .mdx.

Файл .mdx сочетает в себе Markdown, JavaScript и CSS. Вот пример:

На изображении выше показано, как файлы .mdx, написанные вами или вашей любимой LLM, отображаются на итоговых страницах. Разместите их в репозитории и соедините через панель навигации. Это все, что нужно.

Самым долгим было ожидание, пока Claude закончит файлы .mdx. Я также добавил фронтенд-тесты для портала с помощью Playwright, но это тема для другой статьи.

Что это решает

  • Вся команда получает доступ через Git и рабочие пространства Postman. Все, кто публикует контент на портале, уже знают Git.
  • Порталу не нужен выделенный владелец, поэтому ваша API-команда может сосредоточиться на API.
  • Нет необходимости во фронтенд-разработке и нет бюджета на SaaS в размере 100 000+ долларов, конкурирующего с вашей дорожной картой API.
  • Вы получаете полностью функционирующий портал разработчика в течение одного дня.
  • Рабочий процесс на основе Git позволяет легко добавить CI/CD, ветвление и автоматизированное тестирование позже. Обновления портала могут происходить в том же рабочем процессе, что и изменения вашего API, поэтому документация не будет отставать.

Один портал, две аудитории: люди и ИИ-агенты

Есть еще одна причина, по которой эта настройка оказалась долговечной. Люди — больше не единственные читатели порталов разработчиков. Кодинг-агенты, RAG-конвейеры и помощники в IDE постоянно обращаются к сайтам документации, и большинство порталов не были спроектированы для такого трафика. А Fern — был. Сайт, который вы только что создали для своей команды, уже отлично подходит для ИИ-агентов без каких-либо дополнительных усилий с вашей стороны.

Fern делает несколько вещей «из коробки»:

  • Машиночитаемые точки входа. Каждый сайт получает /llms.txt и /llms-full.txt в корне, которые генерируются автоматически вместе с robots.txt и sitemap.xml. llms.txt — это компактный индекс, а llms-full.txt содержит полный контент. Добавление /llms.txt к любому URL страницы дает индекс на уровне страницы.
  • Markdown для каждой страницы. Добавьте .md к любому URL страницы, и вы получите чистый Markdown без парсинга HTML и лишней навигации.
  • Markdown для ботов. Когда Fern обнаруживает ИИ-бота, он отдает Markdown вместо HTML. Fern сообщает, что это сокращает использование токенов на 90% или более, что важно, когда агенты платят за токен при чтении вашей документации.
  • Теги контента для вывода, специфичного для агентов. <llms-only> показывает контент только для ИИ-инструментов, <llms-ignore> скрывает контент от них, а параметры запроса могут дополнительно фильтровать вывод, например, по языку SDK.
  • Ask Fern, RAG-чат с цитатами. Он работает в вашей документации, в Slack и через API, который можно встроить в ваш собственный продукт.
  • Хостируемый MCP-сервер для каждого сайта документации. Любой сайт с включенным Ask Fern получает MCP-сервер по адресу /_mcp/server, и Claude Code, Cursor и Windsurf могут подключиться к нему в один клик. Для аутентифицированных сайтов Fern рекомендует отключать его с помощью mcp: false.
  • Доступ к защищенным документам. Агенты могут получить JWT с помощью ключа Fern API, что позволяет им читать закрытый контент и использовать поиск без обхода вашей аутентификации.
  • Контроль сканирования и обучения. Ваш собственный файл robots.txt по-прежнему определяет, могут ли сторонние инструменты сканировать контент или использовать его для обучения.

Для внутренних инструментов вы также можете установить частный MCP-сервер, ограниченный вашей организацией (fern mcp install). Он предоставляет агентам программирования контекст по docs.yml, компонентам и командам CLI. Fern Agent может редактировать документацию, открывать PR, а также запускаться по расписанию или через процесс в Slack.

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

Хотел бы я, чтобы кто-то показал мне этот подход много лет назад, и надеюсь, что он попадет к вам быстрее. Это эффективный способ продемонстрировать вашу работу внутренним коллегам и внешнему миру, не отвлекая вашу команду от того, ради чего они там находятся: создания API.

Ресурсы

  • Проекты API в Postman с поддержкой Git
  • Документация Fern
  • Режим агента Postman
  • Демонстрация портала разработчика JSON Jet
  • Документация MDX
← Все статьи

О чём эта статья

Ещё в разделе «Разработка ПО»

Все →
Один и тот же неверный ответ, разные причины: почему важно понимать ход мыслей ученика.
Khan Academy

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

Помогайте своей команде писать код быстрее и исследовать больше с помощью Kilo Desktop
Anaconda

Помогайте своей команде писать код быстрее и исследовать больше с помощью Kilo Desktop

Teladoc Health расширяет комплексную программу по контролю веса, предлагая работодателям возможность софинансирования препаратов группы ГПП-1
Teladoc Health

Teladoc Health расширяет комплексную программу по контролю веса, предлагая работодателям возможность софинансирования препаратов группы ГПП-1

L3Harris и партнеры продемонстрировали многодоменные возможности на учениях EVEREST: Pacific Vigilance
L3Harris

L3Harris и партнеры продемонстрировали многодоменные возможности на учениях EVEREST: Pacific Vigilance

Добавьте интерактивности в презентации Canva с помощью Kahoot! 360
Kahoot

Добавьте интерактивности в презентации Canva с помощью Kahoot! 360

Превращайте презентации Canva в уроки и учебные сессии Kahoot!
Kahoot

Превращайте презентации Canva в уроки и учебные сессии Kahoot!

Ещё от Postman

Fern теперь является платформой Postman для порталов разработчиков API
Postman

Fern теперь является платформой Postman для порталов разработчиков API

Что нового в Postman: Kafka, тесты MCP, RAML
Postman

Что нового в Postman: Kafka, тесты MCP, RAML

Обмен симуляциями API между сессиями агентов кодинга
Postman

Обмен симуляциями API между сессиями агентов кодинга

Один терминал, весь агентный жизненный цикл разработки ПО (SDLC): Прямой эфир 17 ноября в 10:00 по тихоокеанскому времени
Postman

Один терминал, весь агентный жизненный цикл разработки ПО (SDLC): Прямой эфир 17 ноября в 10:00 по тихоокеанскому времени

Устранение утечки учетных данных с плагином Postman
Postman

Устранение утечки учетных данных с плагином Postman

Как перенести тесты JMeter в Postman
Postman

Как перенести тесты JMeter в Postman