gitee-api

Установка

Установка в репозиторий:

sh mvnw install

Публикация в частный репозиторий:

mvn deploy

Пользователи Maven

Ссылка на jar-пакет в pom:

<dependency>
    <groupId>com.gitee</groupId>
    <artifactId>gitee-api</artifactId>
    <version>1.0.0</version>
    <scope>compile</scope>
</dependency>

Пользователи Gradle

Добавьте эту зависимость в файл сборки проекта:

compile "com.gitee:gitee-api:1.0.0"

Начало работы

import com.gitee.api.*;
import com.gitee.api.ApiClient;
import com.gitee.api.auth.*;
import com.gitee.api.model.*;
import rx.Observable;
import com.gitee.api.api.AuthApi;

import java.io.File;
import java.util.*;

public class AuthApiExample {

    public static void main(String[] args) {
        AuthApi api = new ApiClient().createService(AuthApi.class);
        Observable<OAuth2AccessToken> token = api.getToken("邮箱",
                "密码",
                "重定向网站",
                "clientId",
                "clientSecret",
                "password",
                "projects user_info issues notes");

        token.subscribe(new Observer<OAuth2AccessToken>() {
            @Override
            public void onCompleted() {

            }

            @Override
            public void onError(Throwable throwable) {
                System.err.println(throwable.getMessage());
            }

            @Override
            public void onNext(OAuth2AccessToken oAuth2AccessToken) {
                System.err.println(oAuth2AccessToken);
            }
        });
    }
}

Документация API

• OpenApi документация
• Документация Postman

Все URI относятся к https://gitee.com/api

ActivityApi

getV5UserSubscriptionsOwnerRepo | GET v5/user/subscriptions/{owner}/{repo} | Проверяет, отслеживает ли авторизованный пользователь определённый проект.

ActivityApi

getV5UsersUsernameEvents | GET v5/users/{username}/events | Перечисляет события пользователя.

ActivityApi

getV5UsersUsernameEventsOrgsOrg | GET v5/users/{username}/events/orgs/{org} | Перечисляет события организаций, к которым принадлежит пользователь.

ActivityApi

getV5UsersUsernameEventsPublic | GET v5/users/{username}/events/public | Перечисляет публичные события пользователя.

ActivityApi

getV5UsersUsernameReceivedEvents | GET v5/users/{username}/received_events | Перечисляет полученные пользователем события.

ActivityApi

getV5UsersUsernameReceivedEventsPublic | GET v5/users/{username}/received_events/public | Перечисляет полученные публичные события пользователя.

ActivityApi

getV5UsersUsernameStarred | GET v5/users/{username}/starred | Перечисляет отмеченные пользователем проекты.

ActivityApi

getV5UsersUsernameSubscriptions | GET v5/users/{username}/subscriptions | Перечисляет отслеживаемые пользователем проекты.

ActivityApi

patchV5NotificationsMessagesId | PATCH v5/notifications/messages/{id} | Помечает личное сообщение как прочитанное.

ActivityApi

patchV5NotificationsThreadsId | PATCH v5/notifications/threads/{id} | Помечает уведомление как прочитанное.

ActivityApi

postV5NotificationsMessages | POST v5/notifications/messages | Отправляет личное сообщение указанному пользователю.

ActivityApi

putV5NotificationsMessages | PUT v5/notifications/messages | Помечает все личные сообщения как прочитанные.

ActivityApi

putV5NotificationsThreads | PUT v5/notifications/threads | Помечает все уведомления как прочитанные.

ActivityApi

putV5ReposOwnerRepoNotifications | PUT v5/repos/{owner}/{repo}/notifications | Помечает уведомления в проекте как прочитанные.

ActivityApi

putV5UserStarredOwnerRepo | PUT v5/user/starred/{owner}/{repo} | Отмечает проект как понравившийся.

ActivityApi

putV5UserSubscriptionsOwnerRepo | PUT v5/user/subscriptions/{owner}/{repo} | Начинает отслеживать проект.

GistsApi

deleteV5GistsGistIdCommentsId | DELETE v5/gists/{gist_id}/comments/{id} | Удаляет комментарий к коду.

GistsApi

deleteV5GistsId | DELETE v5/gists/{id} | Удаляет код.

GistsApi

deleteV5GistsIdStar | DELETE v5/gists/{id}/star | Отменяет отметку кода как понравившегося.

GistsApi

getV5Gists | GET v5/gists | Получает код.

GistsApi

getV5GistsGistIdComments | GET v5/gists/{gist_id}/comments | Получает комментарии к коду.

GistsApi

getV5GistsGistIdCommentsId | GET v5/gists/{gist_id}/comments/{id} | Получает комментарий к коду.

GistsApi

getV5GistsId | GET v5/gists/{id} | Получает код.

GistsApi

getV5GistsIdCommits | GET v5/gists/{id}/commits | Получает коммиты кода.

GistsApi

getV5GistsIdForks | GET v5/gists/{id}/forks | Получает список форков кода.

GistsApi

getV5GistsIdStar | GET v5/gists/{id}/star | Определяет, отмечен ли код как понравившийся.

GistsApi

getV5GistsPublic | GET v5/gists/public | Получает общедоступный код.

GistsApi

getV5GistsStarred | — | Получает отмеченный код. getV5ReposOwnerRepoLabels | GET v5/repos/{owner}/{repo}/labels | Получение всех меток проекта

LabelsApi | getV5ReposOwnerRepoLabelsName | GET v5/repos/{owner}/{repo}/labels/{name} | Получение метки по её названию

LabelsApi | patchV5ReposOwnerRepoLabelsOriginalName | PATCH v5/repos/{owner}/{repo}/labels/{original_name} | Обновление метки проекта

LabelsApi | postV5ReposOwnerRepoIssuesNumberLabels | POST v5/repos/{owner}/{repo}/issues/{number}/labels | Создание метки Issue

LabelsApi | postV5ReposOwnerRepoLabels | POST v5/repos/{owner}/{repo}/labels | Создание меток проекта

LabelsApi | putV5ReposOwnerRepoIssuesNumberLabels | PUT v5/repos/{owner}/{repo}/issues/{number}/labels | Замена всех меток Issue

MilestonesApi | deleteV5ReposOwnerRepoMilestonesNumber | DELETE v5/repos/{owner}/{repo}/milestones/{number} | Удаление отдельного этапа проекта

MilestonesApi | getV5ReposOwnerRepoMilestones | GET v5/repos/{owner}/{repo}/milestones | Получение всех этапов проекта

MilestonesApi | getV5ReposOwnerRepoMilestonesNumber | GET v5/repos/{owner}/{repo}/milestones/{number} | Получение отдельного этапа проекта

MilestonesApi | patchV5ReposOwnerRepoMilestonesNumber | PATCH v5/repos/{owner}/{repo}/milestones/{number} | Обновление этапа проекта

MilestonesApi | postV5ReposOwnerRepoMilestones | POST v5/repos/{owner}/{repo}/milestones | Создание этапа проекта

MiscellaneousApi | getV5Emojis | GET v5/emojis | Список доступных эмодзи

MiscellaneousApi | getV5GitignoreTemplates | GET v5/gitignore/templates | Список шаблонов .gitignore

MiscellaneousApi | getV5GitignoreTemplatesName | GET v5/gitignore/templates/{name} | Получение шаблона .gitignore

MiscellaneousApi | getV5Licenses | GET v5/licenses | Список открытых лицензий

MiscellaneousApi | getV5LicensesLicense | GET v5/licenses/{license} | Получение открытой лицензии

MiscellaneousApi | getV5LicensesLicenseRaw | GET v5/licenses/{license}/raw | Получение исходного файла открытой лицензии

MiscellaneousApi | getV5ReposOwnerRepoLicense | GET v5/repos/{owner}/{repo}/license | Получение лицензии проекта

MiscellaneousApi | postV5Markdown | POST v5/markdown | Рендеринг текста Markdown

OrganizationsApi | deleteV5OrgsOrgMembershipsUsername | DELETE v5/orgs/{org}/memberships/{username} | Удаление члена организации, управляемой авторизованным пользователем

OrganizationsApi | deleteV5UserMembershipsOrgsOrg | DELETE v5/user/memberships/orgs/{org} | Выход из организации

OrganizationsApi | getV5OrgsOrg | GET v5/orgs/{org} | Получение организации

OrganizationsApi | getV5OrgsOrgMembers | GET v5/orgs/{org}/members | Список членов организации

OrganizationsApi | getV5OrgsOrgMembershipsUsername | GET v5/orgs/{org}/memberships/{username} | Получение члена организации getV5ReposOwnerRepoContentsPath | GET v5/repos/{owner}/{repo}/contents(/{path}) | Получение содержимого конкретного пути в репозитории

RepositoriesApi | getV5ReposOwnerRepoContributors | GET v5/repos/{owner}/{repo}/contributors | Получение участников проекта

RepositoriesApi | getV5ReposOwnerRepoForks | GET v5/repos/{owner}/{repo}/forks | Просмотр форков проекта

RepositoriesApi | getV5ReposOwnerRepoKeys | GET v5/repos/{owner}/{repo}/keys | Отображение открытых ключей проекта

RepositoriesApi | getV5ReposOwnerRepoKeysId | GET v5/repos/{owner}/{repo}/keys/{id} | Получение отдельного открытого ключа проекта

RepositoriesApi | getV5ReposOwnerRepoPages | GET v5/repos/{owner}/{repo}/pages | Получение информации о страницах

RepositoriesApi | getV5ReposOwnerRepoReadme | GET v5/repos/{owner}/{repo}/readme | Получение файла README репозитория

RepositoriesApi | getV5ReposOwnerRepoReleases | GET v5/repos/{owner}/{repo}/releases | Получение всех релизов проекта

RepositoriesApi | getV5ReposOwnerRepoReleasesId | GET v5/repos/{owner}/{repo}/releases/{id} | Получение отдельного релиза проекта

RepositoriesApi | getV5ReposOwnerRepoReleasesLatest | GET v5/repos/{owner}/{repo}/releases/latest | Получение последнего обновлённого релиза проекта

RepositoriesApi | getV5ReposOwnerRepoReleasesTagsTag | GET v5/repos/{owner}/{repo}/releases/tags/{tag} | Получение релиза проекта по имени тега

RepositoriesApi | getV5ReposOwnerRepoTags | GET v5/repos/{owner}/{repo}/tags | Перечисление всех тегов проекта

RepositoriesApi | getV5UserRepos | GET v5/user/repos | Перечисление всех проектов авторизованного пользователя

RepositoriesApi | getV5UsersUsernameRepos | GET v5/users/{username}/repos | Получение публичных проектов определённого пользователя

RepositoriesApi | patchV5ReposOwnerRepo | PATCH v5/repos/{owner}/{repo} | Обновление настроек проекта

RepositoriesApi | patchV5ReposOwnerRepoCommentsId | PATCH v5/repos/{owner}/{repo}/comments/{id} | Обновление комментария к коммиту

RepositoriesApi | patchV5ReposOwnerRepoReleasesId | PATCH v5/repos/{owner}/{repo}/releases/{id} | Обновление релиза проекта

RepositoriesApi | postV5OrgsOrgRepos | POST v5/orgs/{org}/repos | Создание проекта организации

RepositoriesApi | postV5ReposOwnerRepoCommitsShaComments | POST v5/repos/{owner}/{repo}/commits/{sha}/comments | Создание комментария к коммиту

RepositoriesApi | postV5ReposOwnerRepoContentsPath | POST v5/repos/{owner}/{repo}/contents/{path} | Создание файла

RepositoriesApi | postV5ReposOwnerRepoForks | POST v5/repos/{owner}/{repo}/forks | Форк проекта

RepositoriesApi | postV5ReposOwnerRepoKeys | POST v5/repos/{owner}/{repo}/keys | Добавление открытого ключа к проекту

RepositoriesApi | postV5ReposOwnerRepoPagesBuilds | POST v5/repos/{owner}/{repo}/pages/builds | Запрос на создание страниц

RepositoriesApi | postV5ReposOwnerRepoReleases | POST v5/repos/{owner}/{repo}/releases | Создание релиза проекта

RepositoriesApi | postV5UserRepos | POST v5/user/repos | Создание нового проекта Документация для моделей:

• Blob.
• Branch.
• Code.
• CodeComment.
• CodeForks.
• CodeForksHistory.
• Commit.
• CommitContent.
• Compare.
• CompleteBranch.
• Content.
• ContentBasic.
• Event.
• Group.
• GroupDetail.
• GroupMember.
• Hook.
• Issue.
• Label.
• Milestone.
• Project.
• ProjectBasic.
• PullRequest.
• PullRequestComments.
• PullRequestCommits.
• PullRequestFiles.
• Release.
• RepoCommit.
• SSHKey.
• SSHKeyBasic.
• Tree.
• User.
• UserAddress.
• UserBasic.
• UserDetail.
• UserEmail.
• UserMessage.
• UserNotification.