| GitVerse

2. `POST /repos/{owner}/{repo}/git/commits` — cоздать коммит

Описание

Создает новый объект коммита в репозитории на основе указанного дерева (tree), сообщения и родительских коммитов.
Этот метод не обновляет ветки и не создает ссылок — он лишь формирует новый коммит в истории Git, который впоследствии можно использовать, например, для обновления ветки через /git/refs.

Параметры URL

Параметр	Тип	Обязательный	Описание
`owner`	string	Да	Владелец репозитория (пользователь или организация)
`repo`	string	Да	Название репозитория

Параметры запроса

Данный метод не использует параметры запроса.

Тело запроса

Формат: application/json
Обязательные поля:

{
  "message": "feat: add new config file",
  "tree": "d3adb33f1234567890abcdef1234567890abcdef",
  "parents": ["a1b2c3d4e5f6789012345678901234567890abcd"],
  "author": {
    "name": "Alice Developer",
    "email": "alice@example.com",
    "date": "2025-10-23T12:00:00Z"
  },
  "committer": {
    "name": "Alice Developer",
    "email": "alice@example.com",
    "date": "2025-10-23T12:00:00Z"
  }
}

Поле	Тип	Обязательный	Описание
`message`	string	Да	Сообщение коммита
`tree`	string	Да	SHA дерева, которое представляет состояние файлов в этом коммите
`parents`	array	Нет*	Список SHA родительских коммитов (обычно один; для корневого коммита — пустой массив или отсутствует)
`author`	object	Нет	Информация об авторе (если не указан — используется текущий пользователь)
`committer`	object	Нет	Информация о коммитере (если не указан — используется текущий пользователь)

💡 Если author или committer не указаны, GitVerse использует данные авторизованного пользователя и текущее время.

Поля объектов `author` / `committer`

Поле	Тип	Обязательный	Описание
`name`	string	Да	Имя автора/коммитера
`email`	string	Да	Email
`date`	string	Нет	Дата в формате ISO 8601 (например, `2025-10-23T12:00:00Z`)

Пример запроса

curl -X POST "https://api.gitverse.ru/repos/gitverse/example-repo/git/commits" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1" \
  -H "Content-Type: application/json" \
  -d '{
        "message": "docs: update changelog",
        "tree": "d3adb33f1234567890abcdef1234567890abcdef",
        "parents": ["a1b2c3d4e5f6789012345678901234567890abcd"]
      }'

Ответ (201 Created)

Пример JSON-ответа:

{
  "sha": "f00dcafe1234567890abcdef1234567890abcdef",
  "url": "https://api.gitverse.ru/repos/gitverse/example-repo/git/commits/f00dcafe1234567890abcdef1234567890abcdef",
  "html_url": "https://gitverse.ru/gitverse/example-repo/commit/f00dcafe1234567890abcdef1234567890abcdef",
  "author": {
    "name": "Alice Developer",
    "email": "alice@example.com",
    "date": "2025-10-23T12:00:00Z"
  },
  "committer": {
    "name": "Alice Developer",
    "email": "alice@example.com",
    "date": "2025-10-23T12:00:00Z"
  },
  "message": "docs: update changelog",
  "tree": {
    "sha": "d3adb33f1234567890abcdef1234567890abcdef",
    "url": "https://api.gitverse.ru/repos/gitverse/example-repo/git/trees/d3adb33f1234567890abcdef1234567890abcdef"
  },
  "parents": [
    {
      "sha": "a1b2c3d4e5f6789012345678901234567890abcd",
      "url": "https://api.gitverse.ru/repos/gitverse/example-repo/git/commits/a1b2c3d4e5f6789012345678901234567890abcd",
      "html_url": "https://gitverse.ru/gitverse/example-repo/commit/a1b2c3d4e5f6789012345678901234567890abcd"
    }
  ],
  "verification": {
    "verified": false,
    "reason": "unsigned",
    "signature": null,
    "payload": null
  }
}

Формат ответа

application/vnd.gitverse.object+json;version=1

Поля ответа

Поле	Тип	Описание
`sha`	string	SHA нового коммита
`url`	string	API-ссылка на коммит
`html_url`	string	Ссылка на коммит в веб-интерфейсе
`author`	object	Автор коммита
`committer`	object	Коммитер
`message`	string	Сообщение коммита
`tree`	object	Информация о дереве
`parents`	array	Список родительских коммитов
`verification`	object	Информация о подписи коммита (обычно `verified: false`)

Подполе `tree`

Поле	Тип	Описание
`sha`	string	SHA дерева
`url`	string	API-ссылка на дерево

Подполе `verification`

Поле	Тип	Описание
`verified`	boolean	Подтверждена ли подпись
`reason`	string	Причина (например, `unsigned`)
`signature`	string \| null	Подпись (если есть)
`payload`	string \| null	Подписанные данные

Коды ответа

Код	Статус	Описание
201	Created	Коммит успешно создан
400	Bad Request	Некорректные данные в теле запроса
403	Forbidden	Недостаточно прав для записи в репозиторий
404	Not Found	Репозиторий не найден
422	Unprocessable Entity	Ошибка валидации (например, недопустимый SHA дерева)
500	Internal Server Error	Внутренняя ошибка сервера

1. POST /repos/{owner}/{repo}/git/trees - создать дерево Приобретение лицензии и подписок

2. POST /repos/{owner}/{repo}/git/commits — cоздать коммит