Общие методы
Этот раздел API описывает общие методы работы с задачами и запросами на слияние. Методы работают через эндпоинт /issues/ и применимы к обоим типам объектов, позволяя получать информацию о задачах и запросах, управлять комментариями, реакциями и метками.
Задачи и запросы
1. GET /repos/{owner}/{repo}/issues/{index}
Возвращает подробную информацию о задаче или запросе на слияние по его номеру.
2. GET /repos/{owner}/{repo}/issues/{index}/reactions
Возвращает массив реакций, оставленных пользователями на задачу или запрос на слияние.
Комментарии
3. GET /repos/{owner}/{repo}/issues/{index}/comments
Возвращает список всех комментариев к задаче или запросу на слияние.
4. GET /repos/{owner}/{repo}/issues/comments/{id}
Возвращает детали отдельного комментария по его уникальному идентификатору.
5. POST /repos/{owner}/{repo}/issues/{index}/comments
Создает новый комментарий в задаче или запросе на слияние.
6. PATCH /repos/{owner}/{repo}/issues/{index}/comments/{comment_id}
Редактирует комментарий в задаче или запросе на слияние.
7. DELETE /repos/{owner}/{repo}/issues/{index}/comments/{comment_id}
Удаляет комментарий в задаче или запросе на слияние.
Реакции на задачи и запросы
8. POST /repos/{owner}/{repo}/issues/{index}/reactions/react
Устанавливает реакцию на задачу или запрос на слияние.
9. POST /repos/{owner}/{repo}/issues/{index}/reactions/unreact
Снимает реакцию с задачи или запроса на слияние.
Реакции на комментарии
10. POST /repos/{owner}/{repo}/issues/{index}/comments/{comment_id}/reactions
Добавляет реакцию на комментарий в задаче или запросе на слияние.
11. DELETE /repos/{owner}/{repo}/issues/{index}/comments/{comment_id}/reactions/{reaction_id}
Удаляет реакцию на комментарий в задаче или запросе на слияние.
Метки
12. POST /repos/{owner}/{repo}/labels
Создает новую метку в указанном репозитории. Учитывается ролевая модель создания меток.
13. PATCH /repos/{owner}/{repo}/labels/{name}
Редактирует существующую метку в репозитории: название, цвет, описание и признак исключительности. Учитывается ролевая модель редактирования меток.
Возможные ошибки
| Код | Описание |
|---|---|
400 Bad Request | Некорректный формат данных |
401 Unauthorized | Необходима авторизация |
403 Forbidden | Недостаточно прав |
404 Not Found | Задача, комментарий или реакция не найдены |
429 Too Many Requests | Превышен лимит запросов |
500 Internal Server Error | Внутренняя ошибка сервера |