Redmine 访问 Skill(仅指派给我)
请先获取环境变量中 token 的值,保存在上下文中,方便后续调用 API 时使用。
连接信息
| 项目 | 值 |
|---|---|
| 服务器地址 | https://redmine-skgd3-local.housei-inc.com |
| 认证方式 | API Token |
| Token 来源 | 环境变量 REDMINE_API_TOKEN |
安全提示:Token 从环境变量
REDMINE_API_TOKEN读取,请确保已在系统环境变量中设置。
读取方式:
Windows
$env:REDMINE_API_TOKENLinux/Mac
echo $REDMINE_API_TOKEN
前置条件
- 已在系统环境变量中设置
REDMINE_API_TOKEN,值为有效的 Redmine API Token。
认证方法(二选一)
- Header 方式(推荐):
X-Redmine-API-Key: <token> - URL 参数方式:
?key=<token>
API 端点
| 用途 | 方法 | 端点 | 说明 |
|---|---|---|---|
| 单票详情 | GET | /issues/{id}.json |
获取指定工单的完整信息 |
| 工单列表 | GET | /issues.json |
支持筛选、分页 |
| 项目工单 | GET | /projects/{project_id}/issues.json |
获取指定项目的工单 |
常用筛选参数(默认指派给我,可按提示指定指派人)
| 参数 | 示例值 | 说明 |
|---|---|---|
status_id |
open, closed, * |
工单状态筛选 |
assigned_to_id |
me, {user_id} |
指派人筛选(默认 me;提示词明确指定指派人时按指定值) |
limit |
25(默认), 100(最大) |
每页条数 |
offset |
0, 25 |
分页偏移 |
sort |
updated_on:desc |
排序 |
tracker_id |
1=Bug, 2=Feature |
跟踪器类型 |
priority_id |
1=低, 2=中, 3=高, 4=紧急 |
优先级 |
调用示例
# 获取所有未关闭且指派给我的工单(最多50条,按更新时间倒序)
GET /issues.json?assigned_to_id=me&status_id=open&limit=50&sort=updated_on:desc&key=$REDMINE_API_TOKEN
# 获取单个工单详情(仅在该工单指派给我时使用)
GET /issues/15400.json?key=$REDMINE_API_TOKEN
# 获取分配给我的工单(不限制状态)
GET /issues.json?assigned_to_id=me&status_id=*&key=$REDMINE_API_TOKEN
实际调用时,使用
fetch_webpage工具拼接 URL,Token 通过终端命令$env:REDMINE_API_TOKEN读取后填入。
返回数据结构要点
工单对象关键字段:
id- 工单编号subject- 标题status.name- 状态名priority.name- 优先级名tracker.name- 跟踪器名(Bug/Feature/Task等)assigned_to.name- 指派人description- 描述(可能含 Textile 标记)updated_on- 最后更新时间created_on- 创建时间