|
|
开发者可以使用用户标签管理的相关接口，实现对公众号的标签进行创建、查询、修改、删除等操作，也可以对用户进行打标签、取消标签等操作。使用接口过程中有任何问题，可以前往微信开放社区 #公众号 专区发帖交流。
标签管理
1. 创建标签
一个公众号，最多可以创建100个标签。
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN
POST数据格式：JSON POST数据示例：
{ "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":53. 编辑标签
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/tags/update?access_token=ACCESS_TOKEN
POST数据格式：JSON POST数据例子：
{ "tag" : { "id" : 134, "name" : "广东人" } }返回说明
{ "errcode":0, "errmsg":"ok" }错误码说明
错误码 说明 -1 系统繁忙 45157 标签名非法，请注意不能和其他标签重名 45158 标签名长度超过30个字节 45058 不能修改0/1/2这三个系统默认保留的标签 4. 删除标签
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKEN
POST数据格式：JSON POST数据例子：
{ "tag":{ "id" : 134 } }返回说明
{ "errcode":0, "errmsg":"ok" }错误码说明
错误码 说明 -1 系统繁忙 45058 不能修改0/1/2这三个系统默认保留的标签 45057 该标签下粉丝数超过10w，不允许直接删除 5. 获取标签下粉丝列表
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN
POST数据格式：JSON POST数据例子：
{ "tagid" : 134, "next_openid":""//第一个拉取的OPENID，不填默认从头开始拉取 }返回说明（正常时返回的json包示例）
{ "count":2,//这次获取的粉丝数量 "data":{//粉丝列表 "openid":[ "ocYxcuAEy30bX0NXmGn4ypqx3tI0", "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" ] "next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//拉取列表最后一个用户的openid错误码说明
错误码 说明 -1 系统繁忙 40003 传入非法的openid 45159 非法的tag_id 用户管理
标签功能目前支持公众号为用户打上最多20个标签。
1. 批量为用户打标签
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKEN
POST数据例子：
{ "openid_list" : [//粉丝列表 "ocYxcuAEy30bX0NXmGn4ypqx3tI0", "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" ], "tagid" : 134返回说明（正常时返回的json包示例）
{ "errcode":0, "errmsg":"ok"错误码说明
错误码 说明 -1 系统繁忙 40032 每次传入的openid列表个数不能超过50个 45159 非法的标签 45059 有粉丝身上的标签数已经超过限制，即超过20个 40003 传入非法的openid 49003 传入的openid不属于此AppID 2. 批量为用户取消标签
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN
POST数据格式：JSON POST数据例子：
{ "openid_list" : [//粉丝列表 "ocYxcuAEy30bX0NXmGn4ypqx3tI0", "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" ], "tagid" : 134返回说明（正常时返回的json包示例）
{ "errcode":0, "errmsg":"ok"错误码说明
错误码 说明 -1 系统繁忙 40032 每次传入的openid列表个数不能超过50个 45159 非法的标签 40003 传入非法的openid 49003 传入的openid不属于此AppID 3. 获取用户身上的标签列表
接口调用请求说明
http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/tags/getidlist?access_token=ACCESS_TOKEN
POST数据格式：JSON