D黑奴背锅 文档中心
修仙 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}