> For the complete documentation index, see [llms.txt](https://docs-ru.testmace.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-ru.testmace.com/0.0.1-beta.14/node-types/api-description/api-desc-import.md).

# Импорт описания API

TestMace позволяет не только вручную задокументировать API, но и импортировать уже существующую документацию. На данный момент поддерживается импорт из форматов Swagger 2.0 и OpenAPI 3.0.

Импортировать описание API можно из контекстного меню + проекта, выбрав **Import** -> **Swagger** (аналогичное меню есть и в области Scratches):

![Контекстное меню проекта](/files/-LiMtKQIIq4b8Y7FT7Wb)

При этом открывается диалог следующего вида:

![](/files/-LiMtMyJHFHO5eoh25UQ)

Как видите, на данный момент поддерживается как импорт из файла, так и загрузка API с удаленного сервера по URL. После выбора источника и нажатия на кнопку **OK** в дерево добавляется импортированное описание.

### Обновление описания API

Помимо загрузки описания API, можно также обновить уже существующие описание API . Для этого из контекстного меню [ApiRootFolder](/0.0.1-beta.14/node-types/api-description/apirootfolder.md) узла необходимо выбрать **Update api.** При этом откроется диалог как при импорте API. Стоит отметить, что все изменения в описании API, сделанные вручную, будут перетерты после обновления.