Gestion des tags utilisateurs
Gestion des balises utilisateur
Les développeurs peuvent utiliser les interfaces pertinentes de gestion des balises utilisateur pour créer, interroger, modifier, supprimer et d'autres opérations sur les balises de compte public, et peuvent également baliser et démarquer les utilisateurs.
Gestion des tags
1. Créer des tags
Un compte public, vous pouvez créer jusqu'à 100 tags.
Description de la demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"tag" : {
"name" : "Guangdong"//nom du tag
}
}
Description du paramètre nom du tag (3 à moins de 0 caractères)
Instructions de retour (exemple de paquet de données JSON renvoyé lorsque c'est normal)
{ "tag":{
"id":134,//tag id
"name":"Guangdong"
}
}
Description du paramètre de retour nom de la balise, encodage UTF8
Description du code d'erreur
Code d'erreur Explication -1 Système occupé 45157 Tags Le nom est illégal, veillez à ne pas avoir le même nom que les autres tags 45158 La longueur du nom du tag dépasse 30 octets 45056 Trop de tags sont créés, veuillez noter qu'il ne peut pas dépasser 100
2. Obtenez les tags créés par le compte officiel
Instructions de demande d'appel d'interface
Méthode de demande http : GET (veuillez utiliser le protocole https)
https://api.weixin.qq. com /cgi-bin/tags/get?access_token=ACCESS_TOKEN
Instructions de retour
{
"tags":[{
"id":1,
"name":"Une canette de Coca par jour",
"count": 0 //Le nombre de fans sous ce tag
},{
"id":2,
"name":"star group",
"count":0
},{
"id ": 127,
"nom": "Guangdong",
"compte": 5
}
]
}
3. Modifier la balise
Description de la demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi-bin/ tags/update?access_token=ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"tag" : {
"id" : 134,
"name" : "Cantonais"
}
}
Instructions de retour
{
"errcode":0,
"errmsg":"ok"
}
Description du code d'erreur
Code d'erreur Explication -1 Système occupé 45157 Tags Le nom est illégal, veillez à ne pas avoir le même nom que les autres balises 45158 Le nom de la balise fait plus de 30 octets 45058 Vous ne pouvez pas modifier les balises 0/1/2 réservées par défaut dans ces trois systèmes
4. Supprimer les tags
Veuillez noter que lorsque le nombre de fans sous un certain tag dépasse 100 000, le tag ne peut pas être supprimé directement en arrière-plan. À ce stade, les développeurs peuvent d'abord annuler l'étiquette dans la liste openid sous l'étiquette, puis supprimer directement l'étiquette jusqu'à ce que le nombre de fans ne dépasse pas 100 000.
Description de la demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https)https://api.weixin.qq.com/cgi-bin/tags/delete?access_token= ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"tag":{
"id" : 134
}
}
Instructions de retour
{
"errcode":0,
"errmsg":"ok"
}
Description du code d'erreur
Code d'erreur Description -1 Le système est occupé 45058 non modifiable Les trois systèmes 0/1/2 sont réservés par défaut. Le tag 45057 Le nombre de fans sous ce tag dépasse 100 000, et la suppression directe n'est pas autorisée
5. Obtenez la liste des fans sous le label
Instructions de demande d'appel d'interface
Méthode de demande http : GET (veuillez utiliser le protocole https)
https://api.weixin.qq. com/cgi -bin/user/tag/get?access_token=ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"tagid" : 134,
"next_openid": ""//Le tirez d'abord Obtenez l'OPENID, s'il n'est pas renseigné, il sera extrait de zéro par défaut
}
Instructions de retour (exemple de package json retourné dans des conditions normales)
{
"count":2, //Le nombre de fans obtenus cette fois
"data":{//Liste des fans
"openid":[
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
]
},
"next_openid ":"ocYxcuB t0mRugKZ7tGAHPnUaOW7Y"//Obtenir l'openid du dernier utilisateur de la pull list
}
Description du code d'erreur
Code d'erreur Explication -1 Le système est occupé 40003 Entrez l'openid illégal 45159 Illégal tag_id
Gestion des utilisateurs
La fonction d'étiquette prend actuellement en charge les comptes publics pour étiqueter jusqu'à trois étiquettes pour les utilisateurs.
1. Identifiez les utilisateurs par lots
Instructions de demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi -bin/tags/members/batchtagging?access_token=ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"openid_list" : [//Liste des fans
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",
« ocYxcuBt0mRugKZ7tGAHPnUaOW7Y »
],
"tagid" : 134
}
Instructions de retour (exemple de colis json retourné dans des conditions normales)
{
"errcode":0,
"errmsg":"ok"
}
Description du code d'erreur
Code d'erreur Explication -1 Le système est occupé 40032 Le nombre de listes openid transmises à chaque fois ne peut pas dépasser 50 45159 Tags illégales 45 059 Il y a fans Le nombre de tags a dépassé la limite 40003 Un openid illégal a été transmis dans 49003 L'openid transmis n'appartient pas à cet AppID
2. Démarquer les utilisateurs par lots
Instructions de demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi -bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"openid_list" : [//Liste des fans
"ocYxcuAEy30bX0NXmGn4ypqx3tI0" ,
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
],
"tagid" : 134
}
Instructions de retour (exemple de colis json retourné dans des conditions normales)
{
"errcode":0,
"errmsg":"ok"
}
Description du code d'erreur
Code d'erreur Explication -1 Le système est occupé 40032 Le nombre de listes openid passées à chaque fois ne peut pas dépasser 50 45159 Tags illégales 40 003 Saisie illégale L'openid 49003 L'openid entrant n'appartient pas à cet AppID
3. Obtenez la liste des balises sur l'utilisateur
Instructions de demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq .com /cgi-bin/tags/getidlist?access_token=ACCESS_TOKEN
Format de données POST : JSON
Exemple de données POST :
{
"openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
}
Retour Instructions ( Exemple de json renvoyé dans des circonstances normales)
{ "tagid_list":[//La liste des balises placées
134,
2
]
}
Description du code d'erreur
Code d'erreur Explication -1 系统繁忙 40003 传入非法的openid 49003 传入的openid不属于此AppID
Gestion des balises utilisateur
Les développeurs peuvent utiliser les interfaces pertinentes de gestion des balises utilisateur pour créer, interroger, modifier, supprimer et d'autres opérations sur les balises de compte public, et peuvent également baliser et démarquer les utilisateurs.
Gestion des tags
1. Créer des tags
Un compte public, vous pouvez créer jusqu'à 100 tags.
Description de la demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "tag" : { "name" : "Guangdong"//nom du tag } } |
Instructions de retour (exemple de paquet de données JSON renvoyé lorsque c'est normal)
| { "tag":{ "id":134,//tag id "name":"Guangdong" } } |
nom de la balise, encodage UTF8
| Code d'erreur | Explication |
| -1 | Système occupé |
| 45157 | Tags Le nom est illégal, veillez à ne pas avoir le même nom que les autres tags |
| 45158 | La longueur du nom du tag dépasse 30 octets |
| 45056 | Trop de tags sont créés, veuillez noter qu'il ne peut pas dépasser 100 |
2. Obtenez les tags créés par le compte officiel
Instructions de demande d'appel d'interface
Méthode de demande http : GET (veuillez utiliser le protocole https) https://api.weixin.qq. com /cgi-bin/tags/get?access_token=ACCESS_TOKEN |
Instructions de retour
{ "tags":[{ "id":1, "name":"Une canette de Coca par jour", "count": 0 //Le nombre de fans sous ce tag },{ "id":2, "name":"star group", "count":0 },{ "id ": 127, "nom": "Guangdong", "compte": 5 } ] } |
3. Modifier la balise
Description de la demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi-bin/ tags/update?access_token=ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "tag" : { "id" : 134, "name" : "Cantonais" } } |
Instructions de retour
{ "errcode":0, "errmsg":"ok" } |
Description du code d'erreur
| Code d'erreur | Explication |
| -1 | Système occupé |
| 45157 | Tags Le nom est illégal, veillez à ne pas avoir le même nom que les autres balises |
| 45158 | Le nom de la balise fait plus de 30 octets |
| 45058 | Vous ne pouvez pas modifier les balises 0/1/2 réservées par défaut dans ces trois systèmes |
4. Supprimer les tags
Veuillez noter que lorsque le nombre de fans sous un certain tag dépasse 100 000, le tag ne peut pas être supprimé directement en arrière-plan. À ce stade, les développeurs peuvent d'abord annuler l'étiquette dans la liste openid sous l'étiquette, puis supprimer directement l'étiquette jusqu'à ce que le nombre de fans ne dépasse pas 100 000.
Description de la demande d'appel d'interface
| Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi-bin/tags/delete?access_token= ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "tag":{ "id" : 134 } } |
Instructions de retour
{ "errcode":0, "errmsg":"ok" } |
Description du code d'erreur
| Code d'erreur | Description |
| -1 | Le système est occupé |
| 45058 | non modifiable Les trois systèmes 0/1/2 sont réservés par défaut. Le tag |
| 45057 | Le nombre de fans sous ce tag dépasse 100 000, et la suppression directe n'est pas autorisée |
5. Obtenez la liste des fans sous le label
Instructions de demande d'appel d'interface
Méthode de demande http : GET (veuillez utiliser le protocole https) https://api.weixin.qq. com/cgi -bin/user/tag/get?access_token=ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "tagid" : 134, "next_openid": ""//Le tirez d'abord Obtenez l'OPENID, s'il n'est pas renseigné, il sera extrait de zéro par défaut } |
Instructions de retour (exemple de package json retourné dans des conditions normales)
{ "count":2, //Le nombre de fans obtenus cette fois "data":{//Liste des fans "openid":[ "ocYxcuAEy30bX0NXmGn4ypqx3tI0", "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" ] }, "next_openid ":"ocYxcuB t0mRugKZ7tGAHPnUaOW7Y"//Obtenir l'openid du dernier utilisateur de la pull list } |
Description du code d'erreur
| Code d'erreur | Explication |
| -1 | Le système est occupé |
| 40003 | Entrez l'openid illégal |
| 45159 | Illégal tag_id |
Gestion des utilisateurs
La fonction d'étiquette prend actuellement en charge les comptes publics pour étiqueter jusqu'à trois étiquettes pour les utilisateurs.
1. Identifiez les utilisateurs par lots
Instructions de demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi -bin/tags/members/batchtagging?access_token=ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "openid_list" : [//Liste des fans "ocYxcuAEy30bX0NXmGn4ypqx3tI0", « ocYxcuBt0mRugKZ7tGAHPnUaOW7Y » ], "tagid" : 134 } |
Instructions de retour (exemple de colis json retourné dans des conditions normales)
{ "errcode":0, "errmsg":"ok" } |
Description du code d'erreur
| Code d'erreur | Explication |
| -1 | Le système est occupé |
| 40032 | Le nombre de listes openid transmises à chaque fois ne peut pas dépasser 50 |
| 45159 | Tags illégales |
| 45 059 | Il y a fans Le nombre de tags a dépassé la limite |
| 40003 | Un openid illégal a été transmis dans |
| 49003 | L'openid transmis n'appartient pas à cet AppID |
2. Démarquer les utilisateurs par lots
Instructions de demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi -bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "openid_list" : [//Liste des fans "ocYxcuAEy30bX0NXmGn4ypqx3tI0" , "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" ], "tagid" : 134 } |
Instructions de retour (exemple de colis json retourné dans des conditions normales)
{ "errcode":0, "errmsg":"ok" } |
Description du code d'erreur
| Code d'erreur | Explication |
| -1 | Le système est occupé |
| 40032 | Le nombre de listes openid passées à chaque fois ne peut pas dépasser 50 |
| 45159 | Tags illégales |
| 40 003 | Saisie illégale L'openid |
| 49003 | L'openid entrant n'appartient pas à cet AppID |
3. Obtenez la liste des balises sur l'utilisateur
Instructions de demande d'appel d'interface
Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq .com /cgi-bin/tags/getidlist?access_token=ACCESS_TOKEN Format de données POST : JSON Exemple de données POST : { "openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" } |
Retour Instructions ( Exemple de json renvoyé dans des circonstances normales)
| { "tagid_list":[//La liste des balises placées 134, 2 ] } |
Description du code d'erreur
| Code d'erreur | Explication |
| -1 | 系统繁忙 |
| 40003 | 传入非法的openid |
| 49003 | 传入的openid不属于此AppID |
