微信公众号用户标签管理

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-27 用户标签管理开发者可以使用用户标签管理的相关接口，实现对公众号的标签进行创建、查询、修改、删除等操作，也可以对用户进行打标签、取消标签等操作。标签管理1. 创建标签一个公众号，最多可以创建100个标签。接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "tag" : {    "name" : "广东"//标签名  }}参数说明参数说明access_token调用接口凭据name标签名（30个字符以内）返回说明（正常时返回的json数据包示例）{  "tag":{"id":134,//标签id"name":"广东"  }}返回参数说明参数说明id标签id，由微信分配name标签名，UTF8编码错误码说明错误码说明-1系统繁忙45157标签名非法，请注意不能和其他标签重名45158标签名长度超过30个字节45056创建的标签数过多，请注意不能超过100个2. 获取公众号已创建的标签接口调用请求说明http请求方式：GET（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN返回说明{  "tags":[{      "id":1,      "name":"每天一罐可乐星人",      "count":0 //此标签下粉丝数},{  "id":2,  "name":"星标组",  "count":0},{  "id":127,  "name":"广东",  "count":5}  ]}3. 编辑标签接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/update?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "tag" : {    "id" : 134,    "name" : "广东人"  }}返回说明{  "errcode":0,  "errmsg":"ok"}错误码说明错误码说明-1系统繁忙45157标签名非法，请注意不能和其他标签重名45158标签名长度超过30个字节45058不能修改0/1/2这三个系统默认保留的标签4. 删除标签请注意，当某个标签下的粉丝超过10w时，后台不可直接删除标签。此时，开发者可以对该标签下的openid列表，先进行取消标签的操作，直到粉丝数不超过10w后，才可直接删除该标签。接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "tag":{       "id" : 134  }}返回说明{  "errcode":0,  "errmsg":"ok"}错误码说明错误码说明-1系统繁忙45058不能修改0/1/2这三个系统默认保留的标签45057该标签下粉丝数超过10w，不允许直接删除5. 获取标签下粉丝列表接口调用请求说明http请求方式：GET（请使用https协议）https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "tagid" : 134,  "next_openid":""//第一个拉取的OPENID，不填默认从头开始拉取}返回说明（正常时返回的json包示例）{  "count":2,//这次获取的粉丝数量  "data":{//粉丝列表"openid":[    "ocYxcuAEy30bX0NXmGn4ypqx3tI0",    "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"    ]  },  "next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//拉取列表最后一个用户的openid}错误码说明错误码说明-1系统繁忙40003传入非法的openid45159非法的tag_id用户管理标签功能目前支持公众号为用户打上最多三个标签。1. 批量为用户打标签接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "openid_list" : [//粉丝列表    "ocYxcuAEy30bX0NXmGn4ypqx3tI0",    "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"  ],  "tagid" : 134}返回说明（正常时返回的json包示例）{  "errcode":0,  "errmsg":"ok"}错误码说明错误码说明-1系统繁忙40032每次传入的openid列表个数不能超过50个45159非法的标签45059有粉丝身上的标签数已经超过限制40003传入非法的openid49003传入的openid不属于此AppID2. 批量为用户取消标签接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "openid_list" : [//粉丝列表    "ocYxcuAEy30bX0NXmGn4ypqx3tI0",    "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"  ],  "tagid" : 134}返回说明（正常时返回的json包示例）{  "errcode":0,  "errmsg":"ok"}错误码说明错误码说明-1系统繁忙40032每次传入的openid列表个数不能超过50个45159非法的标签40003传入非法的openid49003传入的openid不属于此AppID3. 获取用户身上的标签列表接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/tags/getidlist?access_token=ACCESS_TOKENPOST数据格式：JSONPOST数据例子：{  "openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"}返回说明（正常情况下返回的json示例）{  "tagid_list":[//被置上的标签列表134,2  ]}错误码说明错误码说明-1系统繁忙40003传入非法的openid49003传入的openid不属于此AppID