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

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

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

![](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-LvigB_ebqRKI4OZpbwR%2F-LvigmezDlcGZlxMb3HC%2F1-swagger.jpg?alt=media\&token=bc57af15-0bcb-40b7-b013-2796fa952790)

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

![](https://1540441421-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-LvigB_ebqRKI4OZpbwR%2F-Lvih0EDc4S16T5ESr9a%2F2-swagger.jpg?alt=media\&token=a6be4d40-f85a-4b54-aa0d-b4fa812e4b77)

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

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

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