道具相关

1. 获取道具名称列表

1.1 说明
  • 若此接口已配置上线,则GM系统中的所有功能,若需使用道具信息,将自动同步此接口信息
1.2 请求方式
  • GET
1.3 请求参数
  • 仅需基础请求参数即可
1.4 返回参数
  • 响应示例:
{
    "status":1,
    "msg":"success",
    "data":[
        {
            "id":"1",
            "name":"name1"
        },
        {
            "id":"2",
            "name":"name2"
        }
    ]
}

返回参数说明:

参数名 类型 长度 说明 是否必传
id string 11 道具id
name string 50 道具名称

2. 获取道具变更原因列表

2.1 说明
  • 运用于 GM系统-信息查询-道具变更明细-变更原因
2.2 请求方式
  • GET
2.3 请求参数
  • 仅需基础请求参数即可
2.4 返回参数

响应示例:

{
    "status":1,
    "msg":"success",
    "data":[
        {
            "id":"1",
            "name":"变更原因1"
        },
        {
            "id":"2",
            "name":"变更原因2"
        }
    ]
}

返回参数说明:

参数名 类型 长度 说明 是否必传
id string 11 变更原因id
name string 50 变更原因

3. 获取道具变更明细(按变更时间降序)

3.1 说明
  • 运用于 GM系统-信息查询-道具变更明细
3.2 请求方式
  • GET
3.3 请求参数
参数名 类型 长度 说明 是否必传
per_page int 11 每页显示条数
page int 11 页码
pid string 50 角色id
prop_id int 11 道具id 否,和变更原因id必传一个
change_reason_id int 11 变更原因id 否,和道具id必传一个
change_start_time string 32 变更开始时间,格式YYYY-MM-DD hh:mm:ss (注:对应平台【change-变更时间】筛选控件起始值
change_end_time string 32 变更结束时间,格式YYYY-MM-DD hh:mm:ss (注:对应平台【change-变更时间】筛选控件结束值
3.4 返回参数

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "total": "2",
        "list": [
            {
                "change_time": "2020-07-18 00:01:57",
                "prop_name": "道具名称1",
                "change_num": "+10",
                "account_num": "100",
                "change_reason": "变更原因1"
            },
            {
                "change_time": "2020-07-18 00:02:57",
                "prop_name": "道具名称2",
                "change_num": "-10",
                "account_num": "80",
                "change_reason": "变更原因2"
            }
        ]
    }
}

返回参数说明:

参数名 类型 长度 说明 是否必传
data.total int 11 总记录数
data.list array 1000 道具变更明细列表
data.list.change_time string 32 变更时间,格式YYYY-MM-DD hh:mm:ss
data.list.prop_name string 50 道具名称
data.list.change_num string 11 变更数量,如果是增加,数量前面需加上+,如果是减少,数量前面需加上-,例如+10或-20
data.list.account_num int 11 变更后数量
data.list.change_reason string 50 变更原因

4. 道具删除

4.1 说明
  • 运用于 GM系统-操作工具-道具操作-道具删除
4.2 请求方式
  • POST
  • Content-Type:application/x-www-form-urlencoded
4.3 请求参数
参数名 类型 长度 说明 是否必传
pid string 50 角色id
prop_list string,json格式 - 道具列表
reason string 50 删除原因

prop_list 参数说明:

参数名 类型 长度 说明 是否必传
id string 50 道具id
num int 11 道具数量

prop_list 参数示例:

[
    {"id":"xx", "num":10},
    {"id":"yy", "num":1}
]
4.4 返回参数
  • 响应示例:
{
    "status":1,
    "msg":"success",
    "data":{

    }
}