文章目录
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":{
}
}