---
name: tjwater-action-business-identity-access-auth
description: business/identity-access 下 auth 操作技能。
version: 3.0.0
---

# auth Action Skill

## 简介
负责 `business/identity-access` 场景下 `auth` 的具体接口调用。

## 子模块索引 (渐进式引导)
- 当前为叶子节点，直接使用下方接口目录。

## 接口目录
| Method | Path | Summary | Required Params | Optional Params |
|---|---|---|---|---|
| POST | `/api/v1/auth/login` | 用户登录 | form_data (body) | - |
| POST | `/api/v1/auth/login/simple` | 简化版登录 | username (query), password (query) | - |
| GET | `/api/v1/auth/me` | 获取当前用户信息 | - | - |
| POST | `/api/v1/auth/refresh` | 刷新AccessToken | refresh_token (query) | - |

- 覆盖方法：`GET, POST`

## 接口说明

| 接口 | 说明 |
|---|---|
| `POST /login` | OAuth2标准格式登录，提交form-data（username+password），返回JWT Access Token和Refresh Token |
| `POST /login/simple` | 简化版登录，直接通过query参数传递username和password，保持向后兼容 |
| `GET /me` | 返回当前已登录用户的详细信息（需携带Access Token） |
| `POST /refresh` | 使用Refresh Token换取新的Access Token，延续会话 |