Получить информацию о задании

GET /repos/{owner}/{repo}/actions/jobs/{job_id}

Описание

Этот метод позволяет получить информацию о задании.

Токен

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

Заголовки

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

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

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

Тело запроса

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

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

curl -X GET "https://api.gitverse.ru/repos/myorg/myrepo/actions/jobs/1234567" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest"

Ответ (200 OK)

Ответ содержит информацию о задании.

{
  "id": 1234567,
  "run_id": 123456,
  "head_branch": "main",
  "head_sha": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "status": "completed",
  "completed_at": "2023-01-01T00:00:00Z",
  "name": "Build",
  "runner_id": 123,
  "runner_name": "GitHub Actions 2",
  "started_at": "2023-01-01T00:00:00Z",
  "steps": [
    {
      "name": "Set up job",
      "status": "completed",
      "number": 1,
      "started_at": "2023-01-01T00:00:00Z",
      "completed_at": "2023-01-01T00:00:00Z"
    }
  ],
  "workflow_name": "Build workflow"
}

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

Коды ответов

КодСтатусОписание
200OkЗапрос выполнен успешно, информация о задании получена
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 указан корректно и обладает необходимыми правами для доступа к репозиторию;
  • идентификатор задания должен быть корректным.