用戶標籤管理

使用者標籤管理

開發者可以使用使用者標籤管理的相關接口，實現對公眾號的標籤進行創建、查詢、修改、刪除等操作，也可以對使用者進行打標籤、取消標籤等操作。

標籤管理

#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，由微信分配標籤名，UTF8編碼

參數	##說明
	id
	#name

######

錯誤碼說明

系統繁忙標籤名稱非法，請注意不能和其他標籤重名稱標籤名稱長度超過30個位元組##所建立的標籤數過多，請注意不能超過100個

錯誤碼
	##-1
	#45157
	45158
	45056

####

2. 取得公眾號碼已建立的標籤

介面呼叫請求說明

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

#

返回說明

#

3. 編輯標籤

介面呼叫請求說明

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

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" }

#

錯誤碼說明

系統繁忙標籤名稱非法，請注意不能和其他標籤重名#標籤名長度超過30個位元組##不能修改0 /1/2這三個系統預設保留的標籤

錯誤碼
	##-1
	#45157
	45158
	45058

####

4. 刪除標籤

請注意，當某個標籤下的粉絲超過10w時，後台無法直接刪除標籤。此時，開發者可以對該標籤下的openid列表，先進行取消標籤的操作，直到粉絲數不超過10w後，才可直接刪除該標籤。

介面呼叫請求說明

#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" }

#

錯誤碼說明

系統繁忙不能修改0/1/2這三個系統預設保留的標籤該標籤下粉絲數超過10w，不允許直接刪除

錯誤碼
	##-1
	#45058
	45057

######

5. 取得標籤下粉絲清單

介面呼叫請求說明

http要求方式：GET（請使用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"     ] 卷#} # 錯誤碼說明 系統繁忙傳入非法的openid非法的tag_id 錯誤碼 ##-1 #40003 45159 ####### 使用者管理 #標籤功能目前支援公眾號碼為使用者打上最多三個標籤。 1. 批次為使用者打標籤 介面呼叫請求說明 http要求方式：POST（請使用https協議） https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKEN #POST資料格式：JSON POST資料範例： {   "openid_list" : [//粉絲清單     "ocYxcuAEy30bX0NXmGn4ypqx3tI0",     "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"   ],   "tagid" : 134 } 傳回說明（正常時傳回的json套件範例） #{   "errcode ":0,   "errmsg":"ok" } # 錯誤碼說明 # 錯誤碼 說明 -1 系統繁忙 #40032 每次傳入的openid列表個數不能超過50個 45159 非法的標籤 45059 有粉絲身上的標籤數字已經超過限制 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 POST數據例子： {   "openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" } 回傳說明（正常情況下傳回的json範例） {   " tagid_list":[//被置的標籤清單 134, #2   ] } ##################################################################### ###### 錯誤碼說明 # 錯誤碼 說明 -1 系统繁忙 40003 传入非法的openid 49003 传入的openid不属于此AppID 設定用戶備註名 → 提交 PHP中文網 首頁課程文章問答詞典手册下載搜尋 APP下載