2.7 KiB

Raw Blame History

name

description

version

license

metadata

gitea-api

Gitea API 调用工具。用于与 Gitea 代码托管平台进行交互，包括仓库管理、用户管理、组织操作、Issue/PR 管理等。当用户提到以下场景时使用此 Skill： (1) 需要调用 Gitea API (如 /api/v1/ 开头的接口) (2) 需要在 Gitea 上创建/查询/管理仓库 (3) 需要管理用户、组织、团队 (4) 需要操作 Issue、Pull Request (5) 需要查看/管理 Git 提交、分支 (6) 用户提到 "Gitea"、"代码托管"、"仓库管理"

1.0.0

Apache-2.0

author

Gitea API Skill

快速开始

此 Skill 提供调用 Gitea API 的能力。API 基础 URL: http://47.107.61.133:3000/api/v1

认证方式：使用环境变量 GITEA_TOKEN47 作为 Bearer Token。

使用方法

方式一：使用封装好的工具函数

直接调用以下工具函数（见 scripts/gitea.js）：

gitea_get(endpoint, params) - GET 请求
gitea_post(endpoint, data) - POST 请求
gitea_patch(endpoint, data) - PATCH 请求
gitea_delete(endpoint) - DELETE 请求

示例：

调用 gitea_get 获取当前用户信息
调用 gitea_get 获取仓库列表
调用 gitea_post 创建新仓库

方式二：直接使用 curl

TOKEN=$GITEA_TOKEN47
curl -H "Authorization: token $TOKEN" http://47.107.61.133:3000/api/v1/user

常用 API 示例

用户相关

GET /user - 获取当前用户信息
GET /users/{username} - 获取指定用户信息
GET /users/{username}/repos - 获取用户仓库列表

仓库相关

GET /repos/{owner}/{repo} - 获取仓库信息
POST /user/repos - 创建仓库（当前用户）
POST /orgs/{org}/repos - 在组织中创建仓库
GET /repos/{owner}/{repo}/branches - 获取分支列表
GET /repos/{owner}/{repo}/commits - 获取提交历史

Issue 相关

GET /repos/{owner}/{repo}/issues - 获取 Issue 列表
POST /repos/{owner}/{repo}/issues - 创建 Issue
GET /repos/{owner}/{repo}/issues/{index} - 获取 Issue 详情
PATCH /repos/{owner}/{repo}/issues/{index} - 更新 Issue

组织相关

GET /orgs - 获取组织列表
GET /orgs/{org} - 获取组织详情
POST /orgs - 创建组织
GET /orgs/{org}/members - 获取组织成员

管理相关 (需要管理员权限)

GET /admin/users - 列出所有用户
POST /admin/users - 创建用户
DELETE /admin/users/{username} - 删除用户

错误处理

API 返回状态码说明：

200/201: 成功
204: 成功（无返回内容）
400: 请求参数错误
401: 未认证
403: 权限不足
404: 资源不存在
422: 验证错误
500: 服务器错误

2.7 KiB Raw Blame History Unescape Escape