Instructions de retour Dans des circonstances normales, le résultat du retour est : {
"url": "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
} où url est l'URL de l'image téléchargée, qui peut être utilisée lors d'un envoi de groupe ultérieur et placée dans des messages graphiques. WeChat renverra le code d'erreur et d'autres informations en cas d'erreur. Veuillez vérifier les informations d'erreur en fonction du code d'erreur
Télécharger des messages graphiques [disponibles après certification de l'abonnement. compte et compte de service]
Description de la demande d'appel d'interface http请求方式: POST
https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN Description des données POST Les exemples de données POST sont les suivants : {
"articles": [
{
"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
"author":"xxx",
"title":"Happy Day",
"content_source_url":"www.qq.com",
"content":"content",
"digest":"digest",
"show_cover_pic":1
},
{
"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
"author":"xxx",
"title":"Happy Day",
"content_source_url":"www.qq.com",
"content":"content",
"digest":"digest",
"show_cover_pic":0
}
]
} Le paramètre | est-il obligatoire ? Description | | Articles est un | message graphique prend en charge 1 à 8 messages graphiques | | thumb_media_id Oui. | Images et texte Le media_id de la vignette du message peut être obtenu dans l'interface de base de support-téléchargement de fichiers multimédias | | auteurNon | L'auteur du message graphique | | titreOui | Le titre du message graphique | | content_source_urlNon | La page après avoir cliqué sur "Lire le texte original" sur la page d'image et de message texte est soumise à des restrictions de sécurité. Si vous devez accéder à l'Appstore, vous pouvez utiliser le service de liens courts d'itun. .es ou appsto.re, et après le lien court, ajoutez le suffixe #wechat_redirect. | | content est le contenu de la page de message graphique | et prend en charge les balises HTML.Les comptes officiels avec les autorisations de paiement WeChat peuvent utiliser la balise a, les autres comptes officiels ne peuvent pas l'utiliser | digest | Non | Description des messages graphiques | show_cover_pic | Non | S'il faut afficher la couverture, 1 moyen display , 0 signifie ne pas afficher |
Description de retour Exemple de données de retour (résultat renvoyé par JSON lorsqu'il est correct) : {
"type":"news",
"media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
"created_at":1391857799
} Paramètres | Description |
---|
type | type de fichier multimédia, respectivement Il y a des images (image), de la voix (voix), de la vidéo (vidéo) et des vignettes (pouce), des messages graphiques (actualités) | media_id | L'identifiant unique obtenu après le téléchargement de fichiers multimédias/messages graphiques | create_at | Heure de téléchargement du fichier multimédia |
错误时微信会返回错误码等信息,请根据错误码查询错误信息
根据标签进行群发【订阅号与服务号认证后均可用】
接口调用请求说明 http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN Description des données POST Les exemples de données POST sont les suivants : Message graphique (notez que le media_id du message graphique doit être obtenu via la méthode ci-dessus) : {
"filter":{
"is_to_all":false,
"tag_id":2
},
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
} Texte : {
"filter":{
"is_to_all":false,
"tag_id":2
},
"text":{
"content":"CONTENT"
},
"msgtype":"text"
} Voix (notez que le media_id ici doit être obtenu en téléchargeant et en téléchargeant des fichiers multimédia dans le support de base ): {
"filter":{
"is_to_all":false,
"tag_id":2
},
"voice":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"voice"
} Picture (notez que le media_id ici doit être obtenu en téléchargeant et en téléchargeant des fichiers multimédias dans le support de base) : {
"filter":{
"is_to_all":false,
"tag_id":2
},
"image":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"image"
} Video Veuillez noter que le media_id de la vidéo ici doit être obtenu via une requête POST à l'interface suivante : https://file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN Les données POST sont les suivantes (media_id doit ici être obtenu en téléchargeant et en téléchargeant du multimédia fichiers en support de base) : {
"media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
"title": "TITLE",
"description": "Description"
} Le retour sera {
"type":"video",
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
"created_at":1398848981
} Ensuite, POSTez les données suivantes (remplacez le media_id par le media_id obtenu à l'étape précédente) pour envoyer la {
"filter":{
"is_to_all":false,
"tag_id":2
},
"mpvideo":{
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc"
},
"msgtype":"mpvideo"
} carte et le message du coupon (notez que le media_id du message graphique doit être obtenu par la méthode ci-dessus) : {
"filter":{
"is_to_all":false,
"tag_id":"2"
},
"wxcard":{
"card_id":"123dsdajkasd231jhksad"
},
"msgtype":"wxcard"
}
Le paramètre | est-il obligatoire ? | Description |
---|
filter | est | utilisé pour définir le destinataire du message graphique | is_to_all | non | est utilisé pour définir si Tous utilisateurs Envoyer, la valeur est vraie ou fausse, sélectionnez vrai pour envoyer le message à tous les utilisateurs d'un groupe, sélectionnez faux pour l'envoyer aux utilisateurs du groupe spécifié en fonction du tag_id | tag_id | Non | Le tag_id de le tag auquel le groupe est envoyé, participer à la gestion des utilisateurs Interface de regroupement des utilisateurs, si la valeur is_to_all est vraie, vous n'avez pas besoin de renseigner le tag_id | mpnews | est | utilisé pour définir l'image et messages texte à envoyer | media_id | est | le media_id utilisé pour les messages de groupe | msgtype | est le type de message envoyé par | , le message graphique est mpnews, le message texte est texte, la voix est voix, la musique est musique, l'image est image, la vidéo est vidéo, le coupon de carte est wxcard | titre | Non | Titre du message | description | Non | Description du message | thumb_media_id | est | L'identifiant média de la vignette de la vidéo | Description du retour (pouce), le message graphique est news errcodeerror codeerrmsg | error message |
---|
msg_id | ID de la tâche d'envoi de message | msg_data_id | L'identifiant des données du message. Ce champ n'apparaîtra que lors de l'envoi de messages graphiques à des groupes. Il peut être utilisé pour obtenir les données du message graphique correspondant dans l'interface de données d'analyse graphique et textuelle. Il s'agit de la première moitié du champ msgid dans l'interface de données d'analyse graphique et textuelle. Pour plus de détails, voir l'introduction du champ msgid. dans l'interface de données d'analyse graphique et textuelle. | Veuillez noter : Lorsque le succès est renvoyé, cela signifie que la tâche d'envoi de masse a été soumise avec succès, mais cela ne signifie pas que l'envoi de masse est terminé à ce moment-là Par conséquent, il est toujours possible qu'une situation anormale se produise. se produisent lors du processus d'envoi ultérieur et l'utilisateur ne reçoit pas le message, par exemple. Les messages sont parfois soumis à modération, les serveurs sont instables, etc. De plus, les Les tâches d'envoi de groupe prennent généralement beaucoup de temps à être envoyées, alors veuillez patienter. WeChat renverra les codes d'erreur et d'autres informations en cas d'erreur. Veuillez vérifier les informations d'erreur en fonction du code d'erreur
Envoyer en masse selon la liste OpenID [Abonnement. le compte n'est pas disponible, le compte de service est disponible après certification]
Description de la demande d'appel d'interface {
"errcode":0,
"errmsg":"send job submission success",
"msg_id":34182,
"msg_data_id": 206227730
} Description des données POST Les exemples de données POST sont les suivants : 图文消息(注意图文消息的media_id需要通过上述方法来得到): http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN 文本: {
"touser":[
"OPENID1",
"OPENID2"
],
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
} 语音: {
"touser":[
"OPENID1",
"OPENID2"
],
"msgtype": "text",
"text": { "content": "hello from boxer."}
} 图片: {
"touser":[
"OPENID1",
"OPENID2"
],
"voice":{
"media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT"
},
"msgtype":"voice"
} 视频: 请注意,此处视频的media_id需通过POST请求到下述接口特别地得到: https://api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST数据如下(此处media_id需通过基础支持中的上传下载多媒体文件来得到): {
"touser":[
"OPENID1",
"OPENID2"
],
"image":{
"media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat"
},
"msgtype":"image"
} 返回将为 {
"media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
"title": "TITLE",
"description": "Description"
} 然后,POST下述数据(将media_id改为上一步中得到的media_id),即可进行发送 {
"type":"video",
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
"created_at":1398848981
} Coupon : {
"touser":[
"OPENID1",
"OPENID2"
],
"mpvideo":{
"media_id":"123dsdajkasd231jhksad",
"title":"TITLE",
"description":"DESCRIPTION"
},
"msgtype":"mpvideo"
}
参数 | 是否必须 | 说明 |
---|
touser | 是 | 填写图文消息的接收者,一串OpenID列表,OpenID最少2个,最多10000个 | mpnews | 是 | 用于设定即将发送的图文消息 | media_id | 是 | 用于群发的图文消息的media_id | msgtype | est le type de message envoyé par | , le message graphique est mpnews, le message texte est texte, la voix est voix, la musique est musique, l'image est image, la vidéo est vidéo, le coupon de carte est wxcard | titre | Non | Titre du message | description | Non | Description du message | thumb_media_id | est | L'identifiant média de la vignette de la vidéo |
返回说明 返回数据示例(正确时的JSON返回结果): {
"touser":[
"OPENID1",
"OPENID2"
],
"wxcard": {"card_id":"123dsdajkasd231jhksad"}
"msgtype":"wxcard"
} 参数 | 说明 |
---|
type | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),次数为news,即图文消息 | errcode | 错误码 | errmsg | 错误信息 | msg_id | 消息发送任务的ID | msg_data_id | 消息的数据ID,,该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍。 |
Veuillez noter : Lorsque le succès est renvoyé, cela signifie que la tâche d'envoi de masse a été soumise avec succès, mais cela ne signifie pas que l'envoi de masse est terminé à ce moment-là Par conséquent, il est toujours possible qu'une situation anormale se produise. se produisent lors du processus d'envoi ultérieur et l'utilisateur ne reçoit pas le message, par exemple. Les messages sont parfois soumis à modération, les serveurs sont instables, etc. De plus, les Les tâches d'envoi de groupe prennent généralement beaucoup de temps à être envoyées, alors veuillez patienter. WeChat renverra un code d'erreur et d'autres informations en cas d'erreur. Veuillez vérifier les informations d'erreur en fonction du code d'erreur
Supprimer le message de groupe [Disponible après l'abonnement. le compte et le compte de service sont authentifiés]
Après l'envoi groupé, vous pouvez supprimer l'envoi groupé à tout moment via cette interface. 接口调用请求说明 {
"errcode":0,
"errmsg":"send job submission success",
"msg_id":34182,
"msg_data_id": 206227730
} Description des données POST Les exemples de données POST sont les suivants : http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN Veuillez noter : {
"msg_id":30124
} Description de retour Exemple de données de retour (résultat renvoyé par JSON lorsqu'il est correct) : 1、只有已经发送成功的消息才能删除
2、删除消息是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片。
3、删除群发消息只能删除图文消息和视频消息,其他类型的消息一经发送,无法删除。
4、如果多次群发发送的是一个图文消息,那么删除其中一次群发,就会删除掉这个图文消息也,导致所有群发都失效 Paramètres | Description |
---|
errcode | Code d'erreur | errmsg | Message d'erreur |
错误时微信会返回错误码等信息,请根据错误码查询错误信息
预览接口【订阅号与服务号认证后均可用】
开发者可通过该接口发送消息给指定用户,在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求,在保留对openID预览能力的同时,增加了对指定微信号发送预览的能力,但该能力每日调用次数有限制(100次),请勿滥用。 接口调用请求说明 {
"errcode":0,
"errmsg":"ok"
} Description des données POST Les exemples de données POST sont les suivants : 图文消息(其中media_id与根据分组群发中的media_id相同): http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN 文本: {
"touser":"OPENID",
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
} 语音(其中media_id与根据分组群发中的media_id相同): {
"touser":"OPENID",
"text":{
"content":"CONTENT"
},
"msgtype":"text"
} 图片(其中media_id与根据分组群发中的media_id相同): {
"touser":"OPENID",
"voice":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"voice"
} 视频(其中media_id与根据分组群发中的media_id相同): {
"touser":"OPENID",
"image":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"image"
} 卡券: {
"touser":"OPENID",
"mpvideo":{ "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
},
"msgtype":"mpvideo"
} 请注意,上述JSON数据中的touser字段都可以改为towxname,这样就可以针对微信号进行预览(而非openID),towxname和touser同时赋值时,以towxname优先。修改后JSON数据如下(以图文消息为例): 图文消息: { "touser":"OPENID",
"wxcard":{
"card_id":"123dsdajkasd231jhksad",
"card_ext": "{\"code\":\"\",\"openid\":\"\",\"timestamp\":\"1402057159\",\"signature\":\"017bb17407c8e0058a66d72dcc61632b70f511ad\"}"
},
"msgtype":"wxcard"
} Paramètres | Description |
---|
touser | L'openid du compte officiel correspondant à l'utilisateur qui reçoit le message Ce champ peut également être modifié en towxname pour obtenir l'aperçu de WeChat ID | . msgtype | Type de message, le message graphique est mpnews, le message texte est un texte, la voix est une voix, la musique est de la musique, l'image est une image, la vidéo est une vidéo, le coupon de carte est wxcard | media_id | media_id pour les messages de groupe | contenu | Le contenu du texte lors de l'envoi d'un SMS | Description du retour errmsg message d'erreur
msg_idID du message |
查询群发消息发送状态【订阅号与服务号认证后均可用】
接口调用请求说明 {
"towxname":"示例的微信号",
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews"
} Description des données POST Les exemples de données POST sont les suivants : {
"errcode":0,
"errmsg":"preview success",
"msg_id":34182
} Paramètre | Description |
---|
msg_id | L'identifiant du message renvoyé après l'envoi d'un message de groupe |
Description de retour Exemple de données de retour (résultat JSON renvoyé lorsqu'il est correct) : http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN Paramètres | Description |
---|
msg_id | L'identifiant du message renvoyé après l'envoi d'un message de groupe | msg_status | Le statut après l'envoi du message, SEND_SUCCESS signifie que l'envoi est réussi |
Résultats de l'envoi de groupe push d'événement
Étant donné que la tâche d'envoi de groupe peut être terminée après un certain laps de temps après sa soumission, lorsque l'interface d'envoi de groupe est appelée, uniquement la tâche d'envoi de groupe sera donnée Indique si la soumission est réussie. Si la tâche d'envoi de masse est soumise avec succès, à la fin de la tâche d'envoi de masse, l'événement sera poussé vers l'URL du développeur (URL de rappel) renseignée par le développeur. sur la plateforme publique. Il convient de noter que comme la tâche d'envoi de masse prend beaucoup de temps pour être complètement terminée, le résultat de l'envoi de masse sera poussé lorsque la tâche d'envoi de masse est sur le point d'être terminée. Le nombre de personnes poussées à ce moment-là aura. une certaine erreur par rapport à la situation réelle Pushed La structure XML est la suivante (lorsqu'elle est envoyée avec succès) : {
"msg_id": "201053012"
} Parameter | Description |
---|
ToUserName | Le compte WeChat du compte public | FromUserName | Le compte WeChat du groupe de comptes publics envoie le compte WeChat de l'assistant à | Créer Time | Horodatage de la création | MsgType | Type de message, voici l'événement | Event | Informations sur l'événement, voici MASSSENDJOBFINISH | MsgID | Mas sage ID | Statut | La structure d'envoi de groupe, est "envoi réussi" ou "envoi échoué" ou "erreur (num)". Cependant, lors de l'envoi réussi, un petit nombre d'utilisateurs peuvent ne pas recevoir de messages en raison du refus des utilisateurs de recevoir des messages de comptes officiels, d'erreurs système, etc. err(num) est la raison spécifique de l'échec de l'audit. Les situations possibles sont les suivantes : err(10001), //erreur publicitaire suspectée(20001), //erreur politique suspectée(20004), //erreur sociale suspectée(20002). ), / /suspecté de pornographie err(20006), //suspecté de crimes illégaux err(20008), //suspecté de fraude err(20013), //suspecté de droit d'auteur err(22000), //suspecté de promotion mutuelle ( promotion mutuelle) err(21000), //Suspecté des autres | TotalCount | tag_id nombre de fans ; ou le nombre de fans dans openid_list | FilterCount | Filtering (le filtrage fait référence au filtrage de régions, de sexes et de rejets définis par l'utilisateur. L'utilisateur a reçu plus de 4 éléments Après filtrage), le nombre de fans prêts à être envoyés. En principe, FilterCount = SentCount + ErrorCount | SentCount | Le nombre de fans envoyés avec succès | ErrorCount | Le nombre de fans envoyés avec succès. à envoyer | |
---|
|
|