Создать токен регистрации раннера для репозитория

POST /repos/{owner}/{repo}/actions/runners/registration-token

Описание

Этот метод генерирует временный токен, который может быть использован для регистрации нового локального раннера для репозитория. Только пользователи с правами администратора для репозитория могут создать токен.

Токен

Требуется токен с правами на Запись для Репозитория.

Заголовки

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

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

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

Тело запроса

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

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

curl -X POST "https://api.gitverse.ru/repos/myuser/myrepo/actions/runners/registration-token" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (201 Created)

Ответ содержит созданный токен регистрации.

{
  "token": "<registration_token>"
}

Формат ответа: application/vnd.gitverse.object+json;version=1

Коды ответов

КодСтатусОписание
201CreatedТокен регистрации успешно создан
400Bad RequestНекорректные параметры запроса
401UnauthorizedНеобходима авторизация
403ForbiddenДоступ запрещен
404Not FoundРепозиторий не найден
429Too Many RequestsПревышен лимит запросов
500Internal Server ErrorВнутренняя ошибка сервера

Пример тела ошибки

При ответе 400 тело ответа имеет следующий вид:

{
  "error": {
    "code": "BAD_REQUEST",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "The request format is invalid",
    "status": 400
  }
}

Примечания

  • убедитесь, что токен API указан корректно и обладает необходимыми правами для доступа к репозиторию;
  • токен является временным и используется для регистрации нового раннера.