---
title: "Создание API документации"
id: "sozdanie-api-dokumentatsii"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/sozdanie-api-dokumentatsii"
keywords:
  - "API"
  - "json"
  - "OpenAPI"
  - "Swagger"
  - "yaml"
updated: 2026-11-16T06:44:58Z
---

# Создание API документации

В этом разделе описаны шаги для создания API-документации из существующей OpenAPI/Swagger спецификации.

Вот шаги:

1. Нажмите **Импорт** странице проектов или в нижнем левом углу редактора страниц.
2. Выберите опцию **OpenAPI** на первой странице Мастера Импорта.![Иконка OpenAPI на шаге 1 в Мастере Импорта](/resources/Storage/manual/sozdanie-api-dokumentatsii/openAPI_icon.png)

    | Если вы импортируете со страницы Проекты, укажите, хотите ли вы создать новый проект или добавить страницы в существующий. Для нового проекта укажите название проекта и язык. |
    | --- |
3. Нажмите **Дальше**.
4. Укажите путь к файлу OpenAPI/Swagger спецификации или перенесите файл с вашего компьютера. Обратите внимание, что файл должен быть общедоступным и не защищённым паролем.

    | За один раз можно указать/загрузить только один файл. Если вам нужно импортировать несколько спецификаций OpenAPI в один проект, запустите мастер несколько раз. |
    | --- |
5. Выберите **Режим ипорта**: 
    1. **Одной страницей** - все методы будут перечислены на одной странице.
    2. **Сгруппировать методы по ресурсам** - страницы будут созданы для каждого ресурса. Все методы для этого ресурса будут перечислены на соответствующей странице.
    3. **Каждый метод отдельной страницей** - страницы будут созданы для каждого метода. Страницы группируются по тегам.
6. Нажмите **Дальше**.
7. Дождитесь пока Документерра обработает файл.
8. На последней странице **Мастера Импорта** нажмите **Окрыть**, чтобы открыть проект, или **Завершить**, чтобы выйти из мастера.

Вот и всё! Этот быстрый и простой способ позволяет легко импортировать ваши спецификации OpenAPI в Документерру. Возможно, вам также захочется узнать больше об [обновлении импортированных спецификаций](/articles/manual/obnovleniye-avtomaticheski-sgenerirovannykh-stranits).