修仙 API角色
GET
/business/xiuxian/player/get_servers获取全部修仙游戏区服,按区服 ID 升序返回。
注意事项
- 进入游戏前请先选择区服,后续请求通过
X-Xiuxian-Server-ID请求头携带区服 ID。 - 仅 status 为 active 的区服可进入,其他状态进入时返回 code=1,message='游戏区服当前不可进入'。
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Response Body
application/json
curl -X GET "https://example.com/business/xiuxian/player/get_servers"{ "code": 0, "message": "获取游戏区服成功", "data": [ { "server_id": 1, "server_code": "qy01", "server_name": "青云一号", "status": "active", "opened_at": 1779502528, "created_at": 1779502528, "updated_at": 1779502528 } ], "time": 1779502528}创建角色 POST
创建修仙角色,需先通过 OAuth 登录且未创建过角色。新人需要先通过 `player/get_servers` 选择区服,创建时将区服 ID 通过 `server_id` 传入。 ## 注意事项 - 需要有效的 OAuth Bearer Token。 - server_id 必填,未传或区服不可用时返回 code=1,message='请选择游戏区服' 或 '游戏区服当前不可进入'。 - cultivation_type 仅支持 灵修(默认)和 体修,传入其他值返回 code=1,message='修仙请求参数无效'。 - user_name 不传时默认使用账号昵称。 - 同一区服下重复创建返回 code=1,message='修仙数据已存在或今日已操作';不同区服可分别创建角色。
获取角色信息 GET
获取当前登录用户的修仙角色完整信息。 ## 注意事项 - 未创建角色时返回 code=1,message='修仙数据不存在'。 - 被封禁的用户返回 code=1,message='修仙角色已被限制操作'。