1. POST /repos/{owner}/{repo}/git/trees
— cоздать новое дерево
Описание
Создает новое дерево (структуру файлов) в репозитории.
URL
POST /public/api/repos/{username}/{reponame}/git/trees
Параметры
Имя | Тип | Обязательно | Описание |
---|---|---|---|
username | string | Да | Владелец репозитория. |
reponame | string | Да | Название репозитория. |
body | object | Да | Описание дерева. |
Тело запроса
{
"base_tree": "a1b2c3d4...",
"tree": [
{
"path": "src/index.js",
"mode": "100644",
"type": "blob",
"sha": "abc123..."
},
{
"path": "docs/",
"mode": "040000",
"type": "tree",
"sha": "def456..."
}
]
}
Заголовки
Authorization: Bearer <your-api-token>
Content-Type: application/json
Accept: application/vnd.gitverse.object+json;version=1
Ответ (201 Created)
{
"sha": "e8f9g7h6...",
"url": "https://gitverse.ru/api/...",
"tree": [
{
"path": "src/index.js",
"sha": "abc123...",
"type": "blob",
"mode": "100644"
}
],
"truncated": false
}
Коды ответов
Код | Статус | Описание |
---|---|---|
201 | Created | Дерево успешно создано |
400 | Bad Request | Неверный запрос: переданы некорректные элементы дерева (например, отсутствует путь или режим) |
403 | Forbidden | Доступ запрещен: недостаточно прав для изменения репозитория |
404 | Not Found | Репозиторий или базовое дерево (если указано) не найдены |
422 | Unprocessable Entity | Невозможно обработать сущность: например, недопустимый тип элемента или конфликт в путях |
500 | Internal Server Error | Внутренняя ошибка сервера |