Cоздать коммит

POST /repos/{owner}/{repo}/git/commits

Описание

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

Заголовки

Параметр	Обязательный	Описание
accept	Нет	Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest

Параметры пути

Параметр	Тип	Обязательный	Описание
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": "gpg.error.not_signed_commit",
    "signature": null,
    "payload": null,
    "verified_at": null
  }
}

Проверка подписи коммита

Объект verification содержит результат проверки криптографической подписи коммита.

Поле	Тип	Описание
verified	boolean	Признак успешной проверки подписи. Возвращает true, если подпись подтверждена, иначе — false.
reason	string	Техническая причина результата проверки. Например, gpg.error.not_signed_commit означает, что коммит не содержит подписи.
signature	string или null	Подпись, извлеченная из коммита. Возвращает null, если подпись отсутствует.
payload	string или null	Данные, для которых была создана подпись. Возвращает null, если подписанные данные отсутствуют.
verified_at	string или null	Дата и время проверки подписи в формате ISO 8601. Возвращает 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	Подписанные данные
verified_at	string	Дата и время проверки подписи	Подписанные данные

Коды ответа

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