# gamematch.deleteMatchRule
本接口应在服务器端调用,详细说明参见服务端API。
小游戏删除对局匹配规则,每个规则对应一个唯一的matchid。
每个小游戏持有的matchid数量有限制,可以通过此接口删除无效的matchid。
删除接口在删除matchid的同时,也会释放掉matchid对应的匹配池。如果是线上正在使用的matchid,请谨慎使用该接口。
# 请求地址
POST https://api.weixin.qq.com/wxa/business/gamematch/deletematchrule?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
match_id | string | 是 | 需要删除的matchid,通过createMatchRule后台接口创建 |
# 返回值
# Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误提示信息 |
errcode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 请求成功 | |
-1 | 系统繁忙,此时请开发者稍候再试 | |
1 | matchid不存在 | |
200000 | 无效的请求数据 | |
500005 | 无效的matchid |
# 调用示例
curl -X POST -d '{"match_id":"FD0PT4rKguEdK-L83RaJgdbchUCW8wjhSwgCku4CLQk"}' https://api.weixin.qq.com/wxa/business/gamematch/deletematchrule?access_token=ACCESS_TOKEN
# 返回结果示例
{
"errcode": 0,
"errmsg":"ok"
}