# API - fmonq (Testforge)
Отправка данных в агрегатор fmonq осуществляется с помощью HTTP-запросов к API http(s)://<instance-name>/api/public/fm/v1/aggregator.
# Отправка сборки в Агрегатор
POST /api/public/fm/v1/aggregator
# Параметры запроса
| Параметр | Тип | Требуется | Описание |
|---|---|---|---|
| projectKey | string | да | Ключ API проекта fmonq Можно заменить заголовком x-fmonq-project-key=<key>Если ключ указан обоими способами, то приоритет на стороне параметра |
# Заголовки запроса
| Заголовок | Требуется | Описание |
|---|---|---|
| x-fmonq-project-key | да | Ключ API проекта fmonq Можно заменить параметром projectKey=<key>Если ключ указан обоими способами, то приоритет на стороне параметра |
Content-Type: multipart/form-data | да | Необходим для отправки сборки в запросе как содержимого |
# Тело запроса
Тело запроса задаётся в формате form-data.
| Ключ | Значение | Описание |
|---|---|---|
| build | С:/<build-path>.zip | Возможен произвольный ключ Файл сборки обязательно должен быть в формате архива .zip |
# Пример запроса CURL
curl --location --request POST 'https://<instance-name>/api/public/fm/v1/aggregator' \
--header 'x-fmonq-project-key: 4c7fdf6e-f286-42e6-98bc-4b4b65dab0c4' \
--header 'Content-Type: multipart/form-data' \
--form 'build=@"C:/<build-path>.zip"'
# Коды ответа
| Код | Описание |
|---|---|
| 201 | Сборка отправлена в конвейер обработки |
| 400 | Не найден файл сборки в теле запроса |
| 400 | Не указан ключ проекта FMONQ |
| 400 | Не указано имя файла в заголовке 'Content-Disposition' |
| 400 | Неверный формат файла |
| 415 | Неправильный тип входных данных. Требуется указать тип: multipart/form-data |
| 422 | Проект ФТ не активен |
| 422 | Проект ФТ по указанному ключу не найден |