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

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

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

![Контекстное меню проекта](https://1448546621-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-LiMrmYbW3n5VDqYxikj%2F-LiMtKQIIq4b8Y7FT7Wb%2Fim_1.png?alt=media\&token=f5de1b2d-6c5d-4a97-9ef0-bbb3d6ebaeb4)

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

![](https://1448546621-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lh_FaVh9XfQJ0p1KqZ1%2F-LiMrmYbW3n5VDqYxikj%2F-LiMtMyJHFHO5eoh25UQ%2Fim_2.png?alt=media\&token=2b3fb94a-3346-4a9d-9898-a0ce07d24361)

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

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

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