100 lines
2.7 KiB
Markdown
100 lines
2.7 KiB
Markdown
---
|
||
name: gitea-api
|
||
description: |
|
||
Gitea API 调用工具。用于与 Gitea 代码托管平台进行交互，包括仓库管理、用户管理、组织操作、Issue/PR 管理等。
|
||
|
||
当用户提到以下场景时使用此 Skill：
|
||
(1) 需要调用 Gitea API (如 /api/v1/ 开头的接口)
|
||
(2) 需要在 Gitea 上创建/查询/管理仓库
|
||
(3) 需要管理用户、组织、团队
|
||
(4) 需要操作 Issue、Pull Request
|
||
(5) 需要查看/管理 Git 提交、分支
|
||
(6) 用户提到 "Gitea"、"代码托管"、"仓库管理"
|
||
version: 1.0.0
|
||
license: Apache-2.0
|
||
metadata:
|
||
author: lirh
|
||
category: development
|
||
tags:
|
||
- gitea
|
||
- api
|
||
- git
|
||
- repository
|
||
---
|
||
|
||
# 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
|
||
|
||
```bash
|
||
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: 服务器错误
|