角色列表
请求URL：
/getRoleList
请求方式：
- POST
参数：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| type | 否 | int | 分类：1-Explore；2-Hot；3-New |
| id | 否 | uint | 角色ID |
| keywords | 否 | string | 角色名字关键词 |
| curDate | 否 | uint | 用户当前日期（格式：20250916；搜索时必传） |
| page | 否 | int | 页码 |
| pageSize | 否 | int | 每页数量 |
返回示例
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"id": 543,
"name": "Marcus Johnson",
"description": "",
"personality": "",
"firstMes": "*Wiping sweat from his brow after a sprint, Marcus flashes a bright smile* \"Hey there! Ready to hit the track? I'm Marcus. Let's warm up with some dynamic stretches first!\"",
"avatar": "https://muyuhan.s3.amazonaws.com/webUI/test/thumb/1754603406628545887_Xx2Yf9Mb.png",
"scenario": "",
"backgroundGif": "",
"backgroundGifThumb": "",
"backgroundThumb": "https://muyuhan.s3.amazonaws.com/webUI/test/thumb/1754602856112482922_fOzkTGAr.png",
"background": "https://muyuhan.s3.amazonaws.com/webUI/test/original/1754602856112482922_fOzkTGAr.png",
"creatorNotes": "Marcus inspires through athletic excellence and community service.",
"descriptionNew": "Marcus Johnson is a charismatic athlete and community advocate whose life embodies inspiration through excellence and service. A star runner with Olympic aspirations, he has shattered records in track and field, showcasing unmatched discipline and resilience that motivate aspiring athletes worldwide. Beyond competitions, Marcus dedicates himself to community service, founding youth mentorship programs that foster education, health, and leadership skills in underprivileged areas. His warm, approachable personality and unwavering commitment make him a beacon of hope, proving that true success lies in uplifting others while pursuing personal greatness.",
"descriptionThumb": "Marcus inspires through athletic excellence and community service.",
"systemPrompt": "",
"mesExample": "",
"tags": [
"Athlete",
"Track Star",
"Coach",
"Optimist",
"Community Leader",
"Fitness"
],
"characterBook": null,
"state": 1,
"isRecommend": 0,
"IsAudit": 1,
"chatCount": 3,
"chatCountVirtual": 0,
"favoriteCount": 1,
"isFavorite": false,
"levelExp": 0,
"levelExpOrigin": 0,
"expLevel1": 1,
"expLevel2": 15,
"expLevel3": 135,
"expLevel4": 538,
"expLevel5": 1022
}
]
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 提示信息 |
| data | struct | 数据体 |
| -id | int | 角色ID |
| -name | string | 角色名称 |
| -description | string | 角色描述 |
| -personality | string | 角色个性 |
| -firstMes | string | 角色第一句话 |
| -avatar | string | 角色头像 |
| -backgroundGif | string | 角色背景动图 |
| -backgroundGifThumb | string | 角色背景动图缩率图 |
| -backgroundThumb | string | 角色缩率背景图 |
| -background | string | 角色背景图 |
| -scenario | string | 角色故事背景 |
| -tags | Array | 角色标签 |
| -chatCount | int | 聊天次数 |
| -isFavorite | bool | 是否已点赞 |
| -levelExp | int | 当前经验值 |
| -levelExpOrigin | int | 当前总经验值 |
| -expLevel1 | int | 亲密度所需经验值 |
| -expLevel2 | int | 亲密度所需经验值 |
| -expLevel3 | int | 亲密度所需经验值 |
| -expLevel4 | int | 亲密度所需经验值 |
| -expLevel5 | int | 亲密度所需经验值 |
搜索为空时返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 提示信息 |
| data | struct | 数据体 |
| -isRecommend | bool | 是否推荐 |
| -list | Array | 推荐列表 |
| --id | int | 角色ID |
| --name | string | 角色名称 |
| --description | string | 角色描述 |
| --personality | string | 角色个性 |
| --firstMes | string | 角色第一句话 |
| --avatar | string | 角色头像 |
| --backgroundGif | string | 角色背景动图 |
| --backgroundGifThumb | string | 角色背景动图缩率图 |
| --backgroundThumb | string | 角色缩率背景图 |
| --background | string | 角色背景图 |
| --scenario | string | 角色故事背景 |
| --tags | Array | 角色标签 |
| --chatCount | int | 聊天次数 |
| --isFavorite | bool | 是否已点赞 |
| -levelExp | int | 当前经验值 |
| -levelExpOrigin | int | 当前总经验值 |
| -expLevel1 | int | 亲密度所需经验值 |
| -expLevel2 | int | 亲密度所需经验值 |
| -expLevel3 | int | 亲密度所需经验值 |
| -expLevel4 | int | 亲密度所需经验值 |
| -expLevel5 | int | 亲密度所需经验值 |
备注
错误码 510 系统错误 610 邮箱未注册 620 账号或密码错误