修仙 API角色
POST
/business/xiuxian/player/create创建修仙角色,需先通过 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='修仙数据已存在或今日已操作';不同区服可分别创建角色。
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/business/xiuxian/player/create" \ -H "Content-Type: application/json" \ -d '{ "server_id": 0 }'{ "code": 0, "message": "创建角色成功", "data": { "user_id": "server:1:business:1:user:1001", "user_name": "无名道友", "cultivation_type": "灵修", "spiritual_root": "金灵根", "state": "空闲", "gold": 100, "experience": 0, "lifespan": 100 }, "time": 1779502528}