快速开始
5 分钟从 0 到第一次调用 EasyAPI。
1. 创建一个应用
打开 https://easypm.yiproject.com/settings → 开放平台 → 新建应用。
填好名字，选权限（建议先用最小集合 projects:read），点创建。系统会显示：
- Client ID（
eacli_xxx）—— 永远不变，可以重复使用 - Secret（
eapk_live_xxx）—— 仅此一次，离开对话框后不再显示，请立即保存
> 推荐保存到密码管理器（1Password / Bitwarden），不要 commit 到 git。
2. 创建一把 API Key
同一个应用可以签发多把 Key。建议一把对应一个集成环境：
| 名字 | 用途 |
|---|---|
dev | 本地调试 |
staging | CI 集成测试 |
prod | 生产环境 |
每把 Key 可以独立撤销。
3. 第一次调用
curl https://easypm.yiproject.com/openapi/v1/resource/project/list \
-H "X-Client-ID: eacli_xxx" \
-H "Authorization: eapk_live_xxx"
成功响应：
{
"success": true,
"data": {
"items": [
{
"id": "cms5brzya0009zp13m0hmf79x",
"name": "官网重构",
"key": "WEB",
"ragStatus": "GREEN",
"ownerId": "cms5brzxe0000zp13yno59cbq",
"startDate": "2026-06-01T00:00:00.000Z",
"dueDate": "2026-09-30T00:00:00.000Z",
"createdAt": "2026-07-29T00:07:08.483Z"
}
],
"hasMore": false,
"nextCursor": null,
"total": 1
},
"error": null,
"meta": { "timestamp": 1782962708 },
"request_id": "f9ce3b15483f001"
}
4. 接入 Agent
参考 MCP 集成 把 @easypm/mcp 加到 Claude Desktop 或 Cursor，Agent 立刻能读写你的项目。