Работа с API
Вы можете взаимодействовать с системой Test IT посредством открытого API. Методы API позволяют создавать и запускать автотесты, импортировать и экспортировать проекты с помощью .json
файлов, создавать рабочие элементы и многое другое. Описание методов API хранится в Swagger. Вы можете взаимодействовать с открытым API любым способом, например с помощью Postman.
Внимание!
Следующие API-методы устарели и перестанут поддерживаться (дата прекращения поддержки уточняется). Рекомендуем использовать обновленные методы, добавленные в документацию Swagger. Список устаревших API-методов представлен в таблице ниже.
Раздел Swagger | Метод |
---|---|
WorkItem | get /api/v2/workItems/sharedSteps/{sharedStepId}/references |
TestSuites | post /api/v2/testSuites/{id}/workItems/search |
Sections | get /api/v2/sections/{id}/workItems |
Projects | get /api/v2/projects get /api/v2/projects/{id}/workItems post /api/v2/projects/{id}/export post /api/v2/projects/{id}/export-by-testPlans post /api/v2/projects/import post /api/v2/projects/{id}/import |
Переход в Swagger из интерфейса Test IT
Вы можете открыть Swagger из интерфейса Test IT двумя способами:
- Нажмите значок Информация в правом верхнем углу окна, затем в выпадающем меню выберите Документация API.
- В адресной строке браузера добавьте постфикс
/swagger
к адресу системы Test IT, затем перейдите по получившемуся адресу. Например, testit.software/swagger, где testit.software необходимо заменить на адрес системы вашей компании.
Авторизация
- Сгенерируйте приватный API токен.
- Откройте Swagger. В открывшемся окне нажмите Authorize.
- В открывшемся диалоговом окне введите
PrivateToken {API Secret Key}
. Вставьте скопированный ранее секретный ключ API вместо{API Secret Key}
. - Нажмите Authorize.
После авторизации вы можете просматривать тела запросов и описания методов, но делать запросы из Swagger. Для этого:
- Откройте интересующий вас запрос и нажмите Try it out около него.
- Заполните тело запроса.
- Нажмите Execute.
Запрос выполнится, и в системе Test IT будет виден его результат.