微信公眾號用戶標簽管理

用戶標簽管理

開發(fā)者可以使用用戶標簽管理的相關接口，實現(xiàn)對公眾號的標簽進行創(chuàng)建、查詢、修改、刪除等操作，也可以對用戶進行打標簽、取消標簽等操作。

標簽管理

1. 創(chuàng)建標簽

一個公眾號，最多可以創(chuàng)建100個標簽。

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "tag" : {     "name" : "廣東"http://標簽名   } }

參數(shù)說明

參數(shù)	說明
access_token	調(diào)用接口憑據(jù)
name	標簽名（30個字符以內(nèi)）

返回說明（正常時返回的json數(shù)據(jù)包示例）

{   "tag":{ "id":134,//標簽id "name":"廣東"   } }

返回參數(shù)說明

參數(shù)	說明
id	標簽id，由微信分配
name	標簽名，UTF8編碼

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
45157	標簽名非法，請注意不能和其他標簽重名
45158	標簽名長度超過30個字節(jié)
45056	創(chuàng)建的標簽數(shù)過多，請注意不能超過100個

2. 獲取公眾號已創(chuàng)建的標簽

接口調(diào)用請求說明

http請求方式：GET（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN

返回說明

{   "tags":[{       "id":1,       "name":"每天一罐可樂星人",       "count":0 //此標簽下粉絲數(shù) },{   "id":2,   "name":"星標組",   "count":0 },{   "id":127,   "name":"廣東",   "count":5 }   ] }

3. 編輯標簽

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/update?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "tag" : {     "id" : 134,     "name" : "廣東人"   } }

返回說明

{   "errcode":0,   "errmsg":"ok" }

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
45157	標簽名非法，請注意不能和其他標簽重名
45158	標簽名長度超過30個字節(jié)
45058	不能修改0/1/2這三個系統(tǒng)默認保留的標簽

4. 刪除標簽

請注意，當某個標簽下的粉絲超過10w時，后臺不可直接刪除標簽。此時，開發(fā)者可以對該標簽下的openid列表，先進行取消標簽的操作，直到粉絲數(shù)不超過10w后，才可直接刪除該標簽。

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "tag":{        "id" : 134   } }

返回說明

{   "errcode":0,   "errmsg":"ok" }

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
45058	不能修改0/1/2這三個系統(tǒng)默認保留的標簽
45057	該標簽下粉絲數(shù)超過10w，不允許直接刪除

5. 獲取標簽下粉絲列表

接口調(diào)用請求說明

http請求方式：GET（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "tagid" : 134,   "next_openid":""http://第一個拉取的OPENID，不填默認從頭開始拉取 }

返回說明（正常時返回的json包示例）

{   "count":2,//這次獲取的粉絲數(shù)量   "data":{//粉絲列表 "openid":[     "ocYxcuAEy30bX0NXmGn4ypqx3tI0",     "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"     ]   },   "next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"http://拉取列表最后一個用戶的openid }

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
40003	傳入非法的openid
45159	非法的tag_id

用戶管理

標簽功能目前支持公眾號為用戶打上最多三個標簽。

1. 批量為用戶打標簽

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "openid_list" : [//粉絲列表     "ocYxcuAEy30bX0NXmGn4ypqx3tI0",     "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"   ],   "tagid" : 134 }

返回說明（正常時返回的json包示例）

{   "errcode":0,   "errmsg":"ok" }

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
40032	每次傳入的openid列表個數(shù)不能超過50個
45159	非法的標簽
45059	有粉絲身上的標簽數(shù)已經(jīng)超過限制
40003	傳入非法的openid
49003	傳入的openid不屬于此AppID

2. 批量為用戶取消標簽

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "openid_list" : [//粉絲列表     "ocYxcuAEy30bX0NXmGn4ypqx3tI0",     "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"   ],   "tagid" : 134 }

返回說明（正常時返回的json包示例）

{   "errcode":0,   "errmsg":"ok" }

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
40032	每次傳入的openid列表個數(shù)不能超過50個
45159	非法的標簽
40003	傳入非法的openid
49003	傳入的openid不屬于此AppID

3. 獲取用戶身上的標簽列表

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議） https://api.weixin.qq.com/cgi-bin/tags/getidlist?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON POST數(shù)據(jù)例子： {   "openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" }

返回說明（正常情況下返回的json示例）

{   "tagid_list":[//被置上的標簽列表 134, 2   ] }

錯誤碼說明

錯誤碼	說明
-1	系統(tǒng)繁忙
40003	傳入非法的openid
49003	傳入的openid不屬于此AppID