Antara muka penghantaran kumpulan lanjutan
Antara muka penghantaran kumpulan lanjutan
Di tapak web platform awam, akaun langganan disediakan dengan satu kebenaran mesej kumpulan setiap hari, dan akaun perkhidmatan disediakan dengan 4 kebenaran mesej kumpulan setiap bulan (bulan semula jadi). Bagi sesetengah pengendali akaun awam yang mempunyai keupayaan pembangunan, mereka boleh mencapai keupayaan penghantaran kumpulan yang lebih fleksibel melalui antara muka penghantaran kumpulan lanjutan.
Sila ambil perhatian:
1、对于认证订阅号,群发接口每天可成功调用1次,此次群发可选择发送给全部用户或某个标签; 2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次,但是用户每月只能接收4条,无论在公众平台网站上,还是使用接口群发,用户每月只能接收4条群发消息,多于4条的群发将对该用户发送失败; 3、具备微信支付权限的公众号,在使用群发接口上传、群发图文消息类型时,可使用<a>标签加入外链; 4、开发者可以使用预览接口校对消息样式和排版,通过预览接口可发送编辑好的消息给指定用户校验效果。
Proses penghantaran mesej grafik secara besar-besaran adalah seperti berikut:
1、首先,预先将图文消息中需要用到的图片,使用上传图文消息内图片接口,上传成功并获得图片URL 2、上传图文消息素材,需要用到图片时,请使用上一步获取的图片URL 3、使用对用户标签的群发,或对OpenID列表的群发,将图文消息群发出去 4、在上述过程中,如果需要,还可以预览图文消息、查询群发状态,或删除已群发的消息等
Proses menghantar gambar, teks dan jenis mesej secara besar-besaran adalah seperti berikut:
1、如果是群发文本消息,则直接根据下面的接口说明进行群发即可 2、如果是群发图片、视频等消息,则需要预先通过素材管理接口准备好mediaID
Mengenai penggunaan is_to_selling sebagai benar, ia akan memasuki akaun rasmi dalam senarai mesej Sejarah pelanggan WeChat:
1、使用is_to_all为true且成功群发,会使得此次群发进入历史消息列表。 2、为防止异常,认证订阅号在一天内,只能使用is_to_all为true进行群发一次,或者在公众平台官网群发(不管本次群发是对全体还是对某个分组)一次。以避免一天内有2条群发进入历史消息列表。 3、类似地,服务号在一个月内,使用is_to_all为true群发的次数,加上公众平台官网群发(不管本次群发是对全体还是对某个分组)的次数,最多只能是4次。 4、设置is_to_all为false时是可以多次群发的,但每个用户只会收到最多4条,且这些群发不会进入历史消息列表。
Selain itu, pembangun sila ambil perhatian bahawa semua tempat di mana media_id digunakan dalam antara muka ini kini boleh menggunakan media_id bahan kekal dalam pengurusan bahan. Sila ambil perhatian bahawa pautan yang dihantar menggunakan bahan yang sama adalah sama, yang bermaksud bahawa pemadaman kumpulan tertentu akan menyebabkan keseluruhan pautan menjadi tidak sah.
Muat naik gambar dalam mesej grafik untuk mendapatkan URL [tersedia selepas akaun langganan dan akaun perkhidmatan disahkan]
Sila ambil perhatian bahawa antara muka ini tidak dimuat naik oleh ini perpustakaan bahan akaun rasmi Terdapat had 5000 dalam bilangan gambar. Imej hanya menyokong format jpg/png, dan saiznya mestilah kurang daripada 1MB.
Penerangan permintaan panggilan antara muka
http请求方式: POST https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN 调用示例(使用curl命令,用FORM表单方式上传一个图片): curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
Penerangan parameter
.Arahan Kembalikan Dalam keadaan biasa, hasil pengembalian adalah: { "url": "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0" } di mana url ialah URL imej yang dimuat naik, yang boleh digunakan dalam penghantaran kumpulan berikutnya dan diletakkan dalam mesej grafik. WeChat akan mengembalikan kod ralat dan maklumat lain apabila terdapat ralat. Sila semak maklumat ralat mengikut kod ralat akaun dan akaun perkhidmatan] Perihalan permintaan panggilan antara muka |
---|
Adakah parameter | diperlukan Penerangan | |
---|---|---|
ialah mesej grafik | Mesej grafik menyokong 1 hingga 8 mesej grafik | |
Ya | Gambar dan teks The media_id lakaran kecil mesej boleh didapati dalam antara muka fail multimedia muat naik sokongan asas | |
pengarang | Tidak | Pengarang mesej grafik |
tajuk | Ya | Mesej grafik Ya |
content_source_url | No | Halaman selepas mengklik "Baca teks asal" pada halaman imej dan mesej teks tertakluk kepada sekatan keselamatan Jika anda perlu melompat ke Appstore, anda boleh menggunakan perkhidmatan pautan pendek itun .es atau appsto.re, dan selepas pautan pendek Tambah akhiran #wechat_redirect. |
kandungan | ialah kandungan halaman mesej grafik | 🎜 dan menyokong teg HTML.Akaun rasmi dengan kebenaran pembayaran WeChat boleh menggunakan teg, akaun rasmi lain tidak boleh menggunakannya paparan , 0 bermaksud tidak memaparkan |
Kembalikan penerangan | Kembalikan contoh data (hasil pengembalian JSON apabila betul): | |
Parameter |
jenis, masing-masing Terdapat gambar (imej), suara (suara), video (video) dan lakaran kecil (ibu jari), mesej grafik (berita)
media_idcreated_at | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
错误时微信会返回错误码等信息,请根据错误码查询错误信息 根据标签进行群发【订阅号与服务号认证后均可用】接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN POST keterangan data POST contoh data adalah seperti berikut: Mesej grafik (perhatikan bahawa media_id mesej grafik perlu diperolehi melalui kaedah di atas): { "filter":{ "is_to_all":false, "tag_id":2 }, "mpnews":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"mpnews" } Teks: { "filter":{ "is_to_all":false, "tag_id":2 }, "text":{ "content":"CONTENT" }, "msgtype":"text" } Suara (perhatikan bahawa media_id di sini perlu diperoleh dengan memuat naik dan memuat turun fail multimedia dalam sokongan asas ): { "filter":{ "is_to_all":false, "tag_id":2 }, "voice":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"voice" } Gambar (perhatikan bahawa media_id di sini perlu diperoleh dengan memuat naik dan memuat turun fail multimedia dalam sokongan asas): { "filter":{ "is_to_all":false, "tag_id":2 }, "image":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"image" } Video Sila ambil perhatian bahawa media_id video di sini perlu diperolehi melalui permintaan POST ke antara muka berikut: https:/ /file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN Data POST adalah seperti berikut (media_id di sini perlu diperoleh dengan memuat naik dan memuat turun multimedia fail dalam sokongan asas): { "media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ", "title": "TITLE", "description": "Description" } Pemulangan akan menjadi { "type":"video", "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc", "created_at":1398848981 } Kemudian, POSKAN data berikut (tukar media_id kepada media_id yang diperolehi dalam langkah sebelumnya) untuk menghantar { "filter":{ "is_to_all":false, "tag_id":2 }, "mpvideo":{ "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc" }, "msgtype":"mpvideo" } kad dan mesej kupon (perhatikan bahawa media_id daripada mesej grafik perlu diperolehi melalui kaedah di atas): { "filter":{ "is_to_all":false, "tag_id":"2" }, "wxcard":{ "card_id":"123dsdajkasd231jhksad" }, "msgtype":"wxcard" }
Kembalikan perihalan Kembalikan contoh data (hasil pemulangan JSON yang betul): { "errcode":0, "errmsg":"send job submission success", "msg_id":34182, "msg_data_id": 206227730 }
返回说明 返回数据示例(正确时的JSON返回结果): { "errcode":0, "errmsg":"send job submission success", "msg_id":34182, "msg_data_id": 206227730 }
Sila ambil perhatian: Apabila kejayaan dikembalikan, bermakna tugas penghantaran beramai-ramai telah berjaya dihantar, tetapi tidak bermakna penghantaran beramai-ramai telah tamat pada masa ini Oleh itu, masih ada kemungkinan situasi tidak normal berlaku semasa proses penghantaran seterusnya dan pengguna tidak menerima mesej, seperti Mesej kadangkala tertakluk kepada penyederhanaan, pelayan tidak stabil, dsb. Selain itu, Tugas penghantaran kumpulan biasanya mengambil masa yang lama untuk dihantar, jadi sila tunggu dengan sabar. WeChat akan mengembalikan kod ralat dan maklumat lain apabila terdapat ralat. Sila semak maklumat ralat mengikut kod ralat dan akaun perkhidmatan disahkan] 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN POST keterangan data POST contoh data adalah seperti berikut: { "msg_id":30124 }
Sila ambil perhatian: 1、只有已经发送成功的消息才能删除 2、删除消息是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片。 3、删除群发消息只能删除图文消息和视频消息,其他类型的消息一经发送,无法删除。 4、如果多次群发发送的是一个图文消息,那么删除其中一次群发,就会删除掉这个图文消息也,导致所有群发都失效 Kembalikan perihalan Kembalikan contoh data (hasil pemulangan JSON apabila betul): { "errcode":0, "errmsg":"ok" }
错误时微信会返回错误码等信息,请根据错误码查询错误信息 预览接口【订阅号与服务号认证后均可用】开发者可通过该接口发送消息给指定用户,在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求,在保留对openID预览能力的同时,增加了对指定微信号发送预览的能力,但该能力每日调用次数有限制(100次),请勿滥用。 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN POST keterangan data POST contoh data adalah seperti berikut: 图文消息(其中media_id与根据分组群发中的media_id相同): { "touser":"OPENID", "mpnews":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"mpnews" } 文本: { "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" } 视频(其中media_id与根据分组群发中的media_id相同): { "touser":"OPENID", "mpvideo":{ "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc", }, "msgtype":"mpvideo" } 卡券: { "touser":"OPENID", "wxcard":{ "card_id":"123dsdajkasd231jhksad", "card_ext": "{\"code\":\"\",\"openid\":\"\",\"timestamp\":\"1402057159\",\"signature\":\"017bb17407c8e0058a66d72dcc61632b70f511ad\"}" }, "msgtype":"wxcard" } 请注意,上述JSON数据中的touser字段都可以改为towxname,这样就可以针对微信号进行预览(而非openID),towxname和touser同时赋值时,以towxname优先。修改后JSON数据如下(以图文消息为例): 图文消息: { "towxname":"示例的微信号", "mpnews":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"mpnews" }
Kembalikan perihalan Kembalikan contoh data (hasil pemulangan JSON apabila betul): { "errcode":0, "errmsg":"preview success", "msg_id":34182 }
查询群发消息发送状态【订阅号与服务号认证后均可用】接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN POST keterangan data POST contoh data adalah seperti berikut: { "msg_id": "201053012" }
Pulangan data yang betul
|