Создать или обновить секрет в репозитории
PUT /repos/{owner}/{repo}/actions/secrets/{secretname}
Описание
Этот метод позволяет создать или обновить секрет в репозитории без шифрования.
Токен
Требуется токен с правами на Запись для Репозитория.
Заголовки
| Параметр | Обязательный | Описание |
|---|---|---|
accept | Нет | Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest |
Параметры пути
| Параметр | Обязательный | Описание |
|---|---|---|
owner | Да | Владелец репозитория |
repo | Да | Название репозитория |
secretname | Да | Имя секрета |
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
value | Да | Значение секрета |
Тело запроса
Данный метод не требует тела запроса.
Пример запроса
curl -X PUT "https://api.gitverse.ru/repos/myuser/myrepo/actions/secrets/MY_SECRET?value=SECRET_VALUE" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1"Ответ (201 Created)
Ответ содержит информацию о созданном секрете.
{
"name": "SECRET_NAME",
"created_at": "2023-01-01T00:00:00Z"
}Формат ответа: application/vnd.gitverse.object+json;version=1
Коды ответов
| Код | Статус | Описание |
|---|---|---|
201 | Created | Секрет успешно создан или обновлен |
400 | Bad Request | Некорректные параметры запроса |
401 | Unauthorized | Необходима авторизация |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Репозиторий не найден |
429 | Too Many Requests | Превышен лимит запросов |
500 | Internal 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 указан корректно и обладает необходимыми правами для доступа к репозиторию;
- секрет будет создан или обновлен в рамках указанного репозитория.