Теги

Описание структуры JSON-объекта, описывающего тег

Поле Тип Описание
name String Имя тега
fullName String Полное имя тега
objectId String Айди объекта (для легковесных тегов совпадает с хэшом коммита)
shortMessage String Короткое сообщение (отсутсвует для легковесных тегов)
fullMessage String Полное сообщение (отсутсвует для легковесных тегов)
commitId String Хэш коммита на который ссылается тег.
personIdent Объект personIdent Информация об авторе тега
lightWeight Boolean Легковесный тег (true) или аннотированный (false)

Описание структуры JSON-объекта, описывающего PersonIdent

Поле Тип Описание
name String Имя автора
avatart String Аватар автора
emailAddress String Email адрес
when DateTime Время создания тега

Метод для получения тегов проекта

GET /project/{ownerAlias}/{projectAlias}/tag

Запрос возвращает массив тегов, есть возможность настройки количества отображаемых объектов на странице

Запрос Описание
GET /project/{ownerAlias}/{projectAlias}/tag/{tagName} Получение всех тегов проекта

Responses

STATUS 200 пример JSON:

Пример ответа 
    
{
    "_embedded": {
        "tagList": [
            {
                "name": "v2",
                "fullName": "refs/tags/v2",
                "objectId": "38a51054ee1449c5b0c8222724b697b497bdf95a",
                "shortMessage": null,
                "fullMessage": null,
                "commitId": "38a51054ee1449c5b0c8222724b697b497bdf95a",
                "personIdent": null,
                "lightWeight": true
            },
            {
                "name": "v1.4",
                "fullName": "refs/tags/v1.4",
                "objectId": "767824e6b49d65127578c786bd68d6b38667242e",
                "shortMessage": "my version 1.4",
                "fullMessage": "my version 1.4\n",
                "commitId": "b7a6c142f2a9b575472c5b9112237dd4f314f328",
                "personIdent": {
                   "name": "Gitflic",
                   "avatar": "/static/image/avatar.jpg",
                   "emailAddress": "support@gitflic.ru",
                   "when": "2022-04-26T13:44:45Z"
                },
                "lightWeight": false
            },
            {
                "name": "tagv3",
                "fullName": "refs/tags/tagv3",
                "objectId": "9353f7a6ef5b0ef4fa26cce6de37b95c94961a04",
                "shortMessage": null,
                "fullMessage": null,
                "commitId": "9353f7a6ef5b0ef4fa26cce6de37b95c94961a04",
                "personIdent": null,
                "lightWeight": true
            },
            {
                "name": "test",
                "fullName": "refs/tags/test",
                "objectId": "c899b58c03ce4c56d4630c13e2e09dce1188e33e",
                "shortMessage": null,
                "fullMessage": null,
                "commitId": "c899b58c03ce4c56d4630c13e2e09dce1188e33e",
                "personIdent": null,
                "lightWeight": true
            }
        ]
    },
    "page": {
        "size": 10,
        "totalElements": 4,
        "totalPages": 1,
        "number": 0
    }
}


STATUS 403 - Нет прав для доступа.

STATUS 404 - Данные по запросу не найдены.

Метод для получения информации по тегу

GET /project/{ownerAlias}/{projectAlias}/tag/{tagName}

Запрос возвращает тег

Запрос Описание
GET /project/{ownerAlias}/{projectAlias}/tag/{tagName} Получение тега по имени

Responses

STATUS 200 пример JSON:

Пример ответа 
    
{
    "name": "v1.4",
    "fullName": "refs/tags/v1.4",
    "objectId": "767824e6b49d65127578c786bd68d6b38667242e",
    "shortMessage": "my version 1.4",
    "fullMessage": "my version 1.4\n",
    "commitId": "b7a6c142f2a9b575472c5b9112237dd4f314f328",
    "personIdent": {
        "name": "Gitflic",
        "avatar": "/static/image/avatar.jpg",
        "emailAddress": "support@gitflic.ru",
        "when": "2022-04-26T13:44:45Z"
    },
    "lightWeight": false
}


STATUS 403 - Нет прав для доступа.

STATUS 404 - Данные по запросу не найдены.

Метод для создания тега

POST /project/{ownerAlias}/{projectAlias}/tag/create

Запрос возвращает тег

Переменная JSON Тип Описание
tagName String Название тега
brachName String Название ветки проекта
message String Описание тега

Responses

STATUS 200 пример JSON:

Пример ответа 
    
{
    "name": "tagName",
    "fullName": "refs/tags/tagName",
    "objectId": "gi868512t9f429li82897c72g196ditfl67390i3",
    "shortMessage": "text",
    "fullMessage": "text",
    "commitId": "8081558g72987i7tf5l4i8cgitfli528cgitfli53c",
    "personIdent": {
        "name": "username",
        "avatar": "/static/image/avatar.jpg",
        "emailAddress": "supportd@gitflic.ru",
        "when": "2022-05-19T09:26:43Z"
    },
    "lightWeight": false
}


STATUS 403 - Нет прав для доступа.

STATUS 404 - Данные по запросу не найдены.

Навигация