用戶標(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" : "廣東"//標(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í)，后臺不可直接刪除標(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":""//第一個(gè)拉取的OPENID，不填默認(rèn)從頭開始拉取
}
返回說明（正常時(shí)返回的json包示例）
{
"count":2,//這次獲取的粉絲數(shù)量
"data":{//粉絲列表
"openid":[
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
]
},
"next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//拉取列表最后一個(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
用戶標(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" : "廣東"//標(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í)，后臺不可直接刪除標(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":""//第一個(gè)拉取的OPENID，不填默認(rèn)從頭開始拉取 } |
返回說明（正常時(shí)返回的json包示例）
{ "count":2,//這次獲取的粉絲數(shù)量 "data":{//粉絲列表 "openid":[ "ocYxcuAEy30bX0NXmGn4ypqx3tI0", "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" ] }, "next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//拉取列表最后一個(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 |