# gamematch.setMatchIdOpenState
本接口应在服务器端调用，详细说明参见服务端API。
修改matchid对应的打开状态。
每个matchid都有两种状态：打开(1)和关闭(0)
用户在调用加入匹配接口时，只能加入状态为打开的matchid。状态为打开的matchid才会分配匹配池。
小程序通过updateMatchRule修改matchid对应的规则时，只能修改状态为关闭的matchid
可以通过getAllMatchRule拉取小程序所有matchid的配置信息和打开状态。
将打开状态设置为关闭（0）时，匹配服务会释放掉matchid对应的匹配池。如果是线上正在使用的matchid，请谨慎变更matchid的状态。
# 请求地址
POST https://api.weixin.qq.com/wxa/business/gamematch/setmatchopenstate?access_token=ACCESS_TOKEN
# 请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| match_id | number | 是 | 需要变更状态的matchid，通过createMatchRule后台接口创建 | |
| open_state | number | 是 | matchid的打开状态 |
open_state 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 关闭 | |
| 1 | 打开 |
# 返回值
# Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误提示信息 |
| match_id | string | 匹配池对应的id，加入匹配时需要携带matchid以加入对应的匹配池 |
errcode 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| -1 | 系统繁忙，此时请开发者稍候再试 | |
| 1 | matchid不存在 | |
| 200000 | 无效的请求数据 | |
| 500005 | 无效的matchid | |
| 500012 | open_state的值不合法 |
# 调用示例
curl -X POST -d '{"match_id":"FD0PT4rKguEdK-L83RaJgdbchUCW8wjhSwgCku4CLQk","open_state":1}' https://api.weixin.qq.com/wxa/business/gamematch/setmatchopenstate?access_token=ACCESS_TOKEN
# 返回结果示例
{
"errcode": 0,
"errmsg":"ok"
}