---
title: "Варианты отображения API документации"
id: "varianti-otobrazheniya-api-dokumentatsii"
project: "Руководство пользователя Документерры"
url: "https://docs.documenterra.ru/articles/manual/varianti-otobrazheniya-api-dokumentatsii"
keywords:
  - "API"
  - "json"
  - "OpenAPI"
  - "Swagger"
  - "yaml"
updated: 2026-11-16T06:44:57Z
---

# Варианты отображения API документации

С февраля 2025 года, в системе Документерра изменился режим отображения [API-документации](/articles/manual/api-dokumentatsiya). Новые клиенты автоматически будут использовать новый вариант, без возможности изменения этой конфигурации. Однако клиенты, у которых портал был создан до февраля 2025 года, могут выбирать между двумя вариантами отображения своей API-документации: **Классический** и **Современный**.

* [Варианты отображения](/articles/manual/varianti-otobrazheniya-api-dokumentatsii/a/h2_646697382)
* [Выбор варианта отображения](/articles/manual/varianti-otobrazheniya-api-dokumentatsii/a/h2_1591165469)
* [Выбор во время импорта](/articles/manual/varianti-otobrazheniya-api-dokumentatsii/a/h3_620903327)
* [Выбор при обновлении автоматически сгенерированных страниц](/articles/manual/varianti-otobrazheniya-api-dokumentatsii/a/h3_968812904)

##   Варианты отображения 

При выборе варианта отображения учитывайте преимущества каждого из них.

| Современный | <ul> <li>Современный и визуально привлекательный пользовательский интерфейс. </li> <li>Расширенная функциональность &quot;Test request&quot;, включая выбор сервера для тестирования запросов API. </li> <li>Автоматическая генерация примеров кода для вызовов API. </li> <li>Легкая настройка с использованием читаемых CSS-классов для брендинга и стилизации.</li> </ul> <br>![Современный режим отображения API документации](/resources/Storage/manual/varianti-otobrazheniya-api-dokumentatsii/modern_editor.png) |
| --- | --- |
| Классический | <ul> <li>Надежный и привычный интерфейс для API-документации.</li> </ul> <br>![Классический вид API документации](/resources/Storage/manual/varianti-otobrazheniya-api-dokumentatsii/legacy_editor.png) |

##  Выбор варианта отображения

Клиенты, у которых портал был создан до февраля 2025 года, могут выбрать вариант отображения API-документации в двух местах: при импорте нового файла OpenAPI/Swagger и при обновлении существующих [автоматически сгенерированных страниц](/articles/manual/avtomaticheski-sgenerirovannyye-stranitsy).

### Выбор во время импорта

1. Запустите [процесс импорта](/articles/manual/sozdanie-api-dokumentatsii).
2. На шаге 2 мастера выберите **Современный** или **Классический** в разделе **Режим рендеринга (отображения)**.![Выбор режима рендеринга в мастере импорта.](/resources/Storage/manual/api-dokumentatsiya/rendering_engine_selector.png)

Импортированная API-документация будет отображаться в соответствии с выбранным вариантом.

### Выбор при обновлении автоматически сгенерированных страниц

1. Запустите процесс обновления автоматически сгенерированных страниц, используя один из двух вариантов, описанных здесь: [Обновление автоматически сгенерированных страниц](/articles/manual/obnovleniye-avtomaticheski-sgenerirovannykh-stranits).
2. В диалоговом окне выберите **Современный** или **Классический** в разделе **Режим рендеринга**.![Выбор режима рендеринга во время обновления страниц](/resources/Storage/manual/api-dokumentatsiya/rendering_engine_during_update.png)

| Если вы решите перейти на **Современный** вариант, то будущие импорты и обновления будут использовать новый режим отображения. Однако существующая API-документация останется без изменений. |
| --- |