微信公眾號用戶標(biāo)簽管理

用戶標(biāo)簽管理

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

標(biāo)簽管理

1. 創(chuàng)建標(biāo)簽

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

接口調(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://標(biāo)簽名   } }

參數(shù)說明

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

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

{   "tag":{ "id":134,//標(biāo)簽id "name":"廣東"   } }

返回參數(shù)說明

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

錯(cuò)誤碼說明

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

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

接口調(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 //此標(biāo)簽下粉絲數(shù) },{   "id":2,   "name":"星標(biāo)組",   "count":0 },{   "id":127,   "name":"廣東",   "count":5 }   ] }

3. 編輯標(biāo)簽

接口調(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" }

錯(cuò)誤碼說明

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

4. 刪除標(biāo)簽

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

接口調(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" }

錯(cuò)誤碼說明

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

5. 獲取標(biāo)簽下粉絲列表

接口調(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://第一個(gè)拉取的OPENID，不填默認(rèn)從頭開始拉取 }

返回說明（正常時(shí)返回的json包示例）

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

錯(cuò)誤碼說明

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

用戶管理

標(biāo)簽功能目前支持公眾號為用戶打上最多三個(gè)標(biāo)簽。

1. 批量為用戶打標(biāo)簽

接口調(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 }

返回說明（正常時(shí)返回的json包示例）

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

錯(cuò)誤碼說明

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

2. 批量為用戶取消標(biāo)簽

接口調(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 }

返回說明（正常時(shí)返回的json包示例）

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

錯(cuò)誤碼說明

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

3. 獲取用戶身上的標(biāo)簽列表

接口調(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":[//被置上的標(biāo)簽列表 134, 2   ] }

錯(cuò)誤碼說明

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