wxpusher docs
1.0.0
WxPusher (layanan dorong WeChat) adalah platform dorong informasi waktu nyata yang menggunakan akun publik WeChat sebagai saluran. Anda dapat mengirimkan informasi ke WeChat dengan memanggil API tanpa menginstal perangkat lunak tambahan untuk mencapai pemberitahuan informasi waktu nyata. Anda dapat menggunakan WxPusher untuk membuat notifikasi alarm server, notifikasi kesibukan kelas, notifikasi kesibukan tiket, perintah pembaruan informasi, dll.
Anda dapat mengakses program demo dan merasakan fungsinya: https://wxpusher.zjiecode.com/demo/
Kode sumber program demo: https://github.com/wxpusher/wxpusher-sdk-java/
Latar belakang manajemen: https://wxpusher.zjiecode.com/admin/
Harap pastikan untuk tidak memanggil program demo dan mengirim pesan langsung ke pengguna! ! !
Antarmuka WeChat telah disesuaikan. Metode pengiriman pesan teks secara langsung telah offline . Kami sedang mengembangkan metode push baru, jadi pantau terus.
| jenis | Dapatkan ID pengguna | pesan templat | |||
|---|---|---|---|---|---|
| Pratinjau |  |  |  |  |  |
Untuk memfasilitasi kelompok pengguna yang berbeda dan skenario penggunaan yang berbeda untuk mengirim pesan dengan lebih cepat dan nyaman, saat ini kami mendukung 2 cara menggunakan WxPusher.
- Harap diperhatikan bahwa kedua metode pengiriman ini memiliki tanda identitas yang berbeda dan tidak dapat dimigrasikan atau dialihkan satu sama lain;
- Jika memungkinkan, sangat disarankan untuk menggunakan cara pertama agar kemampuannya lebih baik.
| Metode pengiriman | Keuntungan, kerugian dan skenario yang dapat diterapkan |
|---|---|
| Dorongan standar [disarankan] (Pengembangan aplikasi standar) |
|
| Dorongan minimalis (dorongan sekali klik SPT) |
|
Sesuai dengan salah satu proyek Anda, ini terutama digunakan untuk otentikasi, isolasi sumber daya, dll. (mirip dengan menggunakan Amap SDK, login WeChat, dll., pertama-tama Anda akan membuat aplikasi baru). , dan alamat panggilan balik. Langkah pertama untuk memanggil sumber daya, informasi otentikasi, dll. dan mengirim pesan adalah membuat aplikasi baru.
Untuk memahaminya secara sederhana, Anda memiliki proyek untuk mengambil tiket kereta api. Setelah Anda mengambil tiket, Anda perlu mengirim pesan ke pengguna; Anda juga memiliki proyek untuk memperingatkan server. Ketika server tidak normal, kirim pesan ke penanggung jawab terkait. Apa kegunaan keduanya berbeda, Anda dapat membuat 2 aplikasi untuk mengirimkan informasinya secara terpisah.
Pengguna dapat mengikuti aplikasi ini melalui kode QR atau tautan. Dengan mengikuti, kami akan memanggil kembali UID pengguna ke server yang Anda tunjuk.
Topik adalah kumpulan pesan di bawah aplikasi. Misalnya, aplikasi terkait diskon dibuat untuk memberikan berbagai informasi preferensial kepada pengguna. Namun, pengguna yang berbeda memperhatikan informasi preferensi yang berbeda perhatian pada Taobao. Dalam skenario ini, Anda dapat membuat topik Taobao, lalu membuat topik JD.com. Saat mengirim informasi, cukup kirimkan langsung ke topik yang sesuai. Setiap topik memiliki tautan berlangganan dan kode QR yang sesuai. Pengguna Setelah berlangganan topik ini , Anda dapat menerima informasi dalam topik ini.
Topik hanya dapat dikirim ke grup tanpa pandang bulu, dan pesan tidak dapat disesuaikan untuk pengguna. Setelah pengguna mengikutinya, tidak akan ada informasi panggilan balik.
| proyek | aplikasi | Topik |
|---|---|---|
| konsep | Aplikasi ini merupakan entitas independen | Tema tersebut milik aplikasi, dan pemanggilan tema tersebut memerlukan otorisasi APP_TOKEN dari aplikasi terkait. |
| Bagaimana cara mengikuti | Kode QR dan tautan | Kode QR dan tautan |
| Kirim grup | Kirim satu-ke-satu melalui UID | Setelah pesan terkirim ke topik, topik tersebut kemudian dibagikan kepada pengguna yang mengikuti topik tersebut, yaitu pesan grup. |
| proyek | Terapkan kode QR | Kode QR tema |
|---|---|---|
| menggunakan | Digunakan untuk pengguna WeChat untuk mengikuti aplikasi. Pengguna hanya mengikuti aplikasi Anda. Hanya dengan begitu Anda bisa mendapatkan UID-nya dan mengiriminya pesan. | Digunakan untuk berlangganan topik. Setelah pengguna berlangganan suatu topik, Anda tidak bisa mendapatkan UID-nya. |
| Dinamis dan statis | Kode QR dinamis default | Kode QR dinamis default |
Kode QR Dinamis : Tautan kode QR tidak akan berubah, tetapi grafik kode QR akan berubah, jadi hanya tautan kode QR dinamis yang dapat digunakan, dan tangkapan layar, pencetakan, dll. tidak diperbolehkan.
Kode QR statis : Tautan dan grafik kode QR tetap tidak berubah dan dapat digunakan sesuka hati.
Token identitas aplikasi hanya dapat diketahui oleh Anda sebagai pengembang. Dengan APP_TOKEN, Anda dapat mengirim pesan ke pengguna aplikasi terkait, jadi harap jaga kerahasiaannya dan jangan mengirimkannya ke tempat seperti github.
Logo pengguna WeChat digunakan untuk menunjukkan kepada pengguna mana pesan tersebut harus dikirim ketika mengirim pesan ke pengguna saja.
Sebelum mengakses, Anda dapat melihat diagram arsitektur untuk membantu Anda memahami perbedaan antara transmisi tunggal dan transmisi grup. 
https://wxpusher.zjiecode.com/admin/, gunakan WeChat untuk memindai kode QR untuk masuk, tidak perlu registrasi, dan pengguna baru akan otomatis terdaftar dengan memindai kode QR untuk pertama kalinya.
Buatlah aplikasi seperti gambar di bawah ini:
Alamat panggilan balik: Tidak perlu diisi. Jika tidak diisi, tidak akan ada panggilan balik saat pengguna mengikutinya. Anda tidak bisa mendapatkan UID pengguna.
Setel URL: Anda tidak perlu mengisinya. Setelah mengisinya, pengguna dapat membuka "Langganan Saya" di WeChat dan langsung menuju ke alamat ini, dan uid akan dibawa sebagai parameter untuk memfasilitasi tampilan halaman yang disesuaikan.
Informasi kontak: Anda tidak perlu mengisinya. Beri tahu pengguna cara menghubungi Anda dan berikan masukan kepada Anda.
Ikuti perintah: Perintah yang dikirimkan kepada pengguna saat pengguna mengikuti atau memindai kode aplikasi. Anda tidak perlu mengisinya. Wxpusher akan memberikan salinan default. Anda juga dapat secara aktif mengirimkan pesan pengingat kepada pengguna ketika pengguna memperhatikan panggilan balik dan memberi Anda UID.
Deskripsi: Jelaskan aplikasi Anda dan konten apa yang didorongnya. Pengguna dapat melihatnya ketika mereka mengikuti tautan atau melihatnya di WeChat.
Selama proses pembuatan aplikasi, Anda seharusnya melihat appToken. Jika tidak disimpan, Anda dapat mereproduksinya dengan cara berikut.
Buka bagian belakang aplikasi https://wxpusher.zjiecode.com/admin/, dan temukan menu appToken dari bilah menu sebelah kiri. Di sini, Anda dapat menyetel ulang appToken. Harap diperhatikan bahwa setelah disetel ulang, appToken yang lama akan menjadi tidak valid segera. Memanggil antarmuka akan gagal.
Setelah membuat aplikasi, Anda dapat melihat kode aplikasi dan mengikuti tautan aplikasi. Anda dapat membiarkan pengguna mengikuti aplikasi Anda dengan dua cara berikut. Setelah mengikuti aplikasi Anda, Anda dapat mengiriminya pesan.
Saat ini ada 3 cara untuk mendapatkan UID:
Setelah mendapatkan UID, cocokkan appToken aplikasi, lalu panggil antarmuka pengirim untuk mengirim pesan.
Semua antarmuka sudah mendukung https.
Antarmuka POST Antarmuka POST adalah antarmuka yang berfungsi penuh dan direkomendasikan untuk digunakan.
Tipe Konten:application/json
Alamat: https://wxpusher.zjiecode.com/api/send/message
Data permintaan ditempatkan di badan, dan parameter spesifiknya adalah sebagai berikut:
JSON tidak mendukung komentar. Saat mengirim, komentar harus dihapus.
{
"appToken" : " AT_xxx " , //必传
"content" : " <h1>H1标题</h1><br/><p style= " color:red; " >欢迎你使用WxPusher，推荐使用HTML发送</p> " , //必传
//消息摘要，显示在微信聊天页面或者模版消息卡片上，限制长度20(微信只能显示20)，可以不传，不传默认截取content前面的内容。
"summary" : "消息摘要" ,
//内容类型 1表示文字 2表示html(只发送body标签内部的数据即可，不包括body标签，推荐使用这种) 3表示markdown
"contentType" : 2 ,
//发送目标的topicId，是一个数组！！！，也就是群发，使用uids单发的时候， 可以不传。
"topicIds" :[
123
],
//发送目标的UID，是一个数组。注意uids和topicIds可以同时填写，也可以只填写一个。
"uids" :[
" UID_xxxx "
],
//原文链接，可选参数
"url" : " https://wxpusher.zjiecode.com " ,
//是否验证订阅时间，true表示只推送给付费订阅用户，false表示推送的时候，不验证付费，不验证用户订阅到期时间，用户订阅过期了，也能收到。
//verifyPay字段即将被废弃，请使用verifyPayType字段，传verifyPayType会忽略verifyPay
"verifyPay" : false ,
//是否验证订阅时间，0：不验证，1:只发送给付费的用户，2:只发送给未订阅或者订阅过期的用户
"verifyPayType" : 0 }
html格式的消息（contentType=2），支持通过标签复制，复制的语法如下：
```html
<copy style="这里可以写复制按钮的style" data-clipboard-text="需要复制到剪贴板的内容">
复制按钮的文字
</copy>
一个例子如下，style默认可以不写：
<copy data-clipboard-text="被复制的内容">
复制
</copy>
Deskripsi data pengembalian:
{
"code" : 1000 , //状态码，非1000表示有异常
"msg" : "处理成功" , //提示消息
"data" : [ //每个uid/topicid的发送状态，和发送的时候，一一对应，是一个数组，可能有多个
{
"uid" : " UID_xxx " , //用户uid
"topicId" : null , //主题ID
"messageId" : 121 , //废弃️，请不要再使用，后续会删除这个字段
"messageContentId" : 2123 , //消息内容id，调用一次接口，生成一个，你可以通过此id调用删除消息接口，删除消息。本次发送的所有用户共享此消息内容。
"sendRecordId" : 12313 , //消息发送id，每个uid用户或者topicId生成一个，可以通过这个id查询对某个用户的发送状态
"code" : 1000 , //1000表示发送成功
"status" : "创建发送任务成功"
}
],
"success" : true
}
Antarmuka GET Antarmuka GET adalah pengebirian dari antarmuka POST. Hal ini terutama untuk kenyamanan panggilan dalam beberapa kasus. Ini hanya mendukung pengiriman teks (contentType=1).
https://wxpusher.zjiecode.com/api/send/message/?appToken=AT_qHT0cTQfLwYOlBV9cJj9zDSyEmspsmyM&content=123&uid=c1BcpqxEbD8irqlGUh9BhOqR2BvH8yWZ&url=http%3a%2f%2fwxpusher.zjiecode.com
Dukungan parameter permintaan: appToken, uid , topicId , konten, url, verifikasiPayType. Silakan lakukan pengkodean urlEncode pada konten dan url.
Antarmuka GET hanya mendukung pengiriman uid atau topicId. Disarankan untuk menggunakan antarmuka POST.
Pesan dikirim ke Wxpusher, yang akan di-cache, dikirim secara asinkron ke WeChat di latar belakang, dan kemudian didistribusikan ke pengguna. Jika jumlah pesan sangat banyak, mungkin ada penundaan pengguna berdasarkan sendRecordId yang dikembalikan dengan mengirimkan pesan.
Metode permintaan: DAPATKAN
Catatan: Kueri status pesan. Cache pesan sensitif terhadap waktu. Waktu cache saat ini disetel ke 7 hari. Jika Anda menanyakan pesan setelah 7 hari, mungkin pesan tersebut tidak ada.
Alamat permintaan: https://wxpusher.zjiecode.com/api/send/query/status?sendRecordId={sendRecordId}
Deskripsi parameter:
Metode permintaan: HAPUS
Catatan: Setelah pesan terkirim, Anda dapat memanggil antarmuka sekunder untuk menghapus pesan. Namun, harap diperhatikan bahwa hanya halaman arahan yang diklik pengguna untuk melihat detailnya yang tidak dapat dihapus dihapus.
Alamat permintaan: https://wxpusher.zjiecode.com/api/send/message?messageContentId=${messageContentId}&appToken=${appToken}
Deskripsi parameter:
Ada skenario di mana Anda perlu mengetahui siapa yang memindai kode QR. Misalnya, ada pesan baru di postingan forum yang perlu disampaikan kepada pengguna. Jika pengguna memindai kode untuk mengikuti, Anda perlu mengetahui siapa yang memindai QR kode dan masukkan ID pengguna forum. Ikat ke UID pengguna Wxpusher. Jika ada pesan baru dari ID pengguna forum, maka akan dikirim ke pengguna Wxpusher. Skenario ini memerlukan kode QR dengan parameter.
Metode permintaan: POST
Alamat permintaan: https://wxpusher.zjiecode.com/api/fun/create/qrcode
Tipe Konten: aplikasi/json
Deskripsi: Buat kode QR dengan parameter. Setelah pengguna memindai kode, parameter akan disertakan dalam panggilan balik.
Badan permintaan:
{
"appToken" : " xxx " , //必填，appToken,前面有说明，应用的标志
"extra" : " xxx " , //必填，二维码携带的参数，最长64位
"validTime" : 1800 //可选，二维码的有效期，默认30分钟，最长30天，单位是秒
}
Setelah pengguna memindai kode QR parameter dan menetapkan alamat panggilan balik, kami akan mengirimkan UID pengguna ke layanan Anda melalui alamat panggilan balik. Untuk detailnya, lihat deskripsi panggilan balik.
Namun, beberapa skenario pengguna sederhana, atau tidak ada layanan back-end, seperti perangkat lunak klien, yang sangat merepotkan untuk digunakan. Oleh karena itu, kami telah menambahkan antarmuka kueri ini. Buat kode QR melalui parameter pembuatan antarmuka kode QR di atas , dan Anda akan mendapatkan kode kode QR. Gunakan kode ini dengan antarmuka ini untuk menanyakan UID pengguna yang terakhir memindai kode QR parameter.
Interval latihan tidak boleh kurang dari 10 detik! ! Pelatihan loop tak terbatas dilarang. Setelah pengguna keluar, pelatihan harus dimatikan, jika tidak, akun akan diblokir.
Metode permintaan: DAPATKAN
Alamat permintaan: https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid
Parameter permintaan (Kueri):
sebuah contoh
https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid?code=xxxxx
Antarmuka ini sudah tidak digunakan lagi. Silakan gunakan antarmuka pengguna V2 berikut untuk menanyakan Aplikasi. Anda dapat menggunakan antarmuka ini untuk menanyakan semua pengguna WeChat yang mengikuti Aplikasi Anda berdasarkan halaman.
Metode permintaan: DAPATKAN
Deskripsi: Dapatkan informasi pengguna dari semua pengguna WeChat yang mengikuti aplikasi
Alamat permintaan: https://wxpusher.zjiecode.com/api/fun/wxuser
Parameter permintaan:
Data pengembalian:
{
"page" : 1 , //当前数据页码
"pageSize" : 50 , //当前页码大小
"records" :[
{
"createTime" : 1572755754416 , //用户关注时间
"enable" : true , //是否可用，也就是用户是否开启接收消息
"headImg" : " xxxxxx " , //用户头像
"nickName" : " 0XFF " , //用户昵称
"uid" : " xxxxxxx " //用户的UID
}
],
"total" : 3 //所有的用户数量
}Anda dapat menggunakan antarmuka ini untuk menanyakan semua pengguna yang mengikuti aplikasi dan topik berdasarkan halaman.
Metode permintaan: DAPATKAN
Deskripsi: Dapatkan informasi pengguna dari semua pengguna WeChat yang mengikuti aplikasi/topik. Perlu dicatat bahwa jika pengguna WeChat mengikuti aplikasi, topik, atau bahkan beberapa topik secara bersamaan, banyak catatan akan dikembalikan.
Alamat permintaan: https://wxpusher.zjiecode.com/api/fun/wxuser/v2
Parameter permintaan:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : {
"total" : 40 , //总数
"page" : 1 , //当前页码
"pageSize" : 20 , //页码大小，
"records" : [
{
"uid" : " UID_xxx " , //用户uid
"appOrTopicId" : 111 , //用户关注的应用或者主题id，根据type来区分
"headImg" : " " , //新用户微信不再返回 ，强制返回空
"createTime" : 1603540859285 , //创建时间
"nickName" : " " , //新用户微信不再返回 ，强制返回空
"reject" : false , //是否拉黑
"id" : 47361 , //id，如果调用删除或者拉黑接口，需要这个id
"type" : 0 , //关注类型，0：关注应用，1：关注topic
"target" : " WxPusher官方" , //关注的应用或者主题名字
"payEndTime" : 0 // 0表示用户不是付费用户，大于0表示用户付费订阅到期时间，毫秒级时间戳
}
]
},
"success" : true
}Anda dapat menghapus perhatian pengguna terhadap aplikasi dan topik melalui antarmuka ini.
Metode permintaan: HAPUS
Catatan: Anda dapat menghapus perhatian pengguna terhadap aplikasi atau topik. Setelah dihapus, pengguna dapat mengikutinya lagi. Jika Anda tidak ingin pengguna mengikutinya lagi, Anda dapat memanggil antarmuka blokir untuk memblokir pengguna.
Alamat permintaan: https://wxpusher.zjiecode.com/api/fun/remove
Parameter permintaan (Kueri):
Data pengembalian:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}Anda dapat menggunakan antarmuka ini untuk memblokir pengguna
Metode permintaan: PUT
Catatan: Tidak ada lagi pesan yang dapat dikirim setelah diblokir, dan pengguna tidak dapat mengikutinya lagi kecuali Anda membatalkan pemblokirannya. Panggil antarmuka daftar hitam alih-alih memanggil antarmuka hapus.
Alamat permintaan: https://wxpusher.zjiecode.com/api/fun/reject
Parameter permintaan (Kueri):
Data pengembalian:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}Untuk memfasilitasi akses cepat, pengembang yang antusias telah menyumbangkan banyak SDK akses, https://github.com/wxpusher/wxpusher-client.
SDK disumbangkan oleh pengembang dan mungkin tidak menyertakan API atau fungsi terbaru. Fungsi tersebut tunduk pada antarmuka HTTP di artikel ini.
Dorongan minimalis, tidak perlu mendaftarkan pengguna, masuk ke backend, membuat aplikasi, mendapatkan appToken, dll.
Untuk mencegah pengguna memahami terlalu banyak konsep dan mempersulit akses, dalam beberapa skenario di mana pengguna mengirim pesan ke dirinya sendiri , metode push minimalis dapat digunakan.
Misalnya: beberapa sistem pemesanan pusat perbelanjaan open source mengirim pesan ke pengguna setelah melakukan pemesanan; sebelumnya, pengguna diharuskan membuat aplikasi, mendapatkan appToken, mengikuti aplikasi, mengisi UID, dll. biayanya terlalu tinggi.
Dorongan minimalis hanya membutuhkan 2 langkah untuk menyelesaikan dorongan:
Cukup pindai kode QR di bawah ini untuk mendapatkan SPT push Anda
Jika Anda perlu menampilkan kode QR ini di sistem Anda, Anda dapat menggunakan tautan permanen berikut:
<textarea readonly style="width:100%;height:60px;"> https://wxpusher.zjiecode.com/api/qrcode/RwjGLMOPTYp35zSYQr0HxbCPrV9eU0wKVBXU1D5VVtya0cQXEJWPjqBdW3gKLifS.jpg </textarea>Harap jangan membocorkan SPT. Setelah SPT bocor, pengguna mana pun dapat mengirimi Anda pesan! ! !
Pengiriman permintaan GET yang sederhana
Masukkan SPT yang Anda peroleh pada langkah sebelumnya pada tautan di bawah ini
Permintaan langsung: https://wxpusher.zjiecode.com/api/send/message/SPT yang Anda peroleh/konten yang ingin Anda kirim
Pengiriman permintaan POST yang sederhana
Metode permintaan: POST
URL Permintaan: https://wxpusher.zjiecode.com/api/send/message/simple-push
Format permintaan: Tipe Konten:application/json
Minta konten:
//JSON不支持注释，发送的时候，需要删除注释。
{
//推送内容，必传
"content" : " <h1>极简推送</h1><br/><p style= " color:red; " >欢迎你使用WxPusher，推荐使用HTML发送</p> " ,
//消息摘要，显示在微信聊天页面或者模版消息卡片上，限制长度20(微信只能显示20)，可以不传，不传默认截取content前面的内容。
"summary" : "消息摘要" ,
//内容类型 1表示文字 2表示html(只发送body标签内部的数据即可，不包括body标签，推荐使用这种) 3表示markdown
"contentType" : 2 ,
//发送SPT，如果发送给一个用户，直接传simplePushToken就行了，不用传simplePushTokenList
"spt" : " SPT_xx1 " ,
//发送SPT，如果发送给多个用户，只传simplePushTokenList即可，请注意，【这是一个数组】！！，最多不能超过10个
"sptList" :[ " SPT_xx1 " , " SPT_xx2 " ],
//原文链接，可选参数
"url" : " https://wxpusher.zjiecode.com " ,
}
Harap diperhatikan: Hanya metode satu (push standar) yang mendukung panggilan balik
Ketika pengguna mengikuti aplikasi atau mengirim pesan perintah ke akun resmi, WxPusher akan mengirimkan pesan tersebut kepada Anda. Jika Anda tidak memiliki layanan latar belakang, Anda juga dapat melakukan pelatihan rotasi. Silakan merujuk ke antarmuka UID pengguna kode QR pemindaian permintaan.
Untuk mengirim pesan ke pengguna, Anda perlu mengetahui UID pengguna. Ada dua cara untuk mengetahui UID pengguna:
{
"action" : " app_subscribe " , //动作，app_subscribe 表示用户关注应用回调，后期可能会添加其他动作，请做好兼容。
"data" :{
"appId" : 123 , //创建的应用ID
"appKey" : " AK_xxxxxx " , //关注应用的appKey，请不要再使用，将来可能会被删除
"appName" : "应用名字" ,
"source" : " scan " , //用户关注渠道，scan表示扫码关注，link表示链接关注，command表示通过消息关注应用，后期可能还会添加其他渠道。
"userName" : " " , //新用户微信不再返回 ，强制返回空
"userHeadImg" : " " , //新用户微信不再返回 ，强制返回空
"time" : 1569416451573 , //消息发生时间
"uid" : " UID_xxxxxx " , //用户uid
"extra" : " xxx " //用户扫描带参数的二维码，二维码携带的参数。扫描默认二维码为空
}
}Untuk produk perpesanan, pengembang mungkin perlu mengetahui status langganan berbayar pengguna setelah pengguna membayar atau mengembalikan dana.
Oleh karena itu, ketika status langganan berbayar pengguna berubah, Anda akan diberitahu melalui pesan panggilan balik berikut. Saat Anda menerima pemberitahuan, Anda dapat menanyakan waktu berakhirnya langganan pengguna dan informasi lainnya dengan menanyakan daftar pengguna V2.
{
"action" : " order_pay " , //动作，表示用户付费或者退款。后期可能会添加其他动作，请做好兼容。
"data" :{
"addTime" : 86400000 , //付费增加的时间，毫秒。退款是负数，表示减少的订阅时间。
"amount" : 50 , //金额，单位分，退款是负数
"appId" : 30630 , //发生的应用id
"createTime" : 1664118481675 , //发生时间，毫秒级时间戳
"prodId" : 12 , //产品id
"tradeNo" : " 202209252308016755383125546 " , //支付或者退款的交易号，和用户微信账单中的商户号对应
"type" : 1 , //1表示付款，2表示退款
"uid" : " UID_xxxxxxx " //发生用户的uid
}
}Saat ini, WxPusher sudah mendukung pesan upstream bertipe perintah. Saat pengguna mengirimkan perintah, WxPusher akan memanggil kembali pesan perintah tersebut ke pengembang.
arahan standar
Format perintahnya adalah: #{appID} content . Misalnya, untuk mengirim pesan ke program demo, Anda dapat mengirimkan: #97 test.
Instruksi berlangganan
Jika Anda hanya mengirimkan appID: #{appID} , misalnya: #97, dan tidak ada konten setelahnya, berarti Anda memperhatikan aplikasi dengan appID 97.
Instruksi yang disederhanakan
Jika Anda hanya mengirim konten: xxx, misalnya: restart server, kali ini dibagi menjadi dua situasi:
AppID dapat dilihat di latar belakang manajemen, manajemen aplikasi-informasi aplikasi-id aplikasi.
Callback menggunakan metode POST, dan format datanya adalah sebagai berikut:
{
"action" : " send_up_cmd " , //动作，send_up_cmd 表示上行消息回调，后期可能会添加其他动作，请做好兼容。
"data" :{
"uid" : " UID_xxx " , //用户uid
"appId" : 97 , //应用id
"appName" : " WxPusher演示" , //应用名称
"time" : 1603002697386 , //发生时间
"content" : "内容" //用户发送的内容
}
}Harap dicatat: Hanya metode satu (push standar) yang mendukung pengisian produk pesan
Harap dicatat bahwa biaya ini mengacu pada: pengembang pesan membebankan biaya kepada penerima pesan melalui WxPusher, bukan WxPusher membebankan biaya kepada pengembang atau pengguna.
Sebagai pengembang, Anda bertanggung jawab untuk memberikan informasi berharga, dan kami bertanggung jawab membantu Anda menghasilkan uang.
Proses aksesnya adalah sebagai berikut:
Produk pesan adalah paket pesan aplikasi yang dikirim tunggal dan pesan topik yang dikirim grup. Beberapa pesan dapat dikemas menjadi satu produk pesan untuk dijual.
Harap dicatat bahwa saat ini kami tidak menerima berita rekomendasi strategi mengenai saham, opsi, obligasi, dana, dll.
Anda perlu memperhatikan sebuah konsep, yang kami jual adalah sumber daya yang terikat dengan produk. Misalnya, jika sumber daya umumnya dikirim dalam jumlah besar, maka akan terikat pada tema jika dikirim satu-satu melalui uid, mereka akan terikat pada aplikasi.
Harap dicatat bahwa produk saat ini tidak mendukung modifikasi setelah dibuat. Harap diisi dengan jelas sebelum dikirimkan.
Setelah pengiriman, silakan hubungi layanan pelanggan WeChat "wxpusher-kefu" untuk peninjauan dan negosiasi mengenai strategi harga pembayaran. Setelah selesai, dapat dimasukkan ke pasar pesan, dan pengguna dapat membayar dan membeli langsung di pasar pesan.
| menjelaskan | pasar berita | Daftar produk pesan | Pengenalan produk pesan |
|---|---|---|---|
| Contoh |  |  |  |
Informasi pengguna dapat ditanyakan dengan menanyakan daftar pengguna V2, dengan payEndTime adalah waktu berakhirnya langganan pengguna.
Saat mengirim pesan ke aplikasi atau tema yang dikemas sebagai produk, Anda dapat membedakan apakah pesan ini hanya dapat diterima oleh pengguna dalam periode berlangganan berbayar. Buat perbedaan berdasarkan bidang verifikasiPayType
Untuk detailnya, Anda dapat memeriksa deskripsi antarmuka untuk mengirim pesan. Jika tidak ada aplikasi atau topik yang terkait dengan produk pesan, bidang verifikasiPayType tidak valid dan tidak perlu diteruskan.
Anda perlu memperhatikan sebuah konsep. Kami menjual sumber daya yang terikat pada produk, jadi yang kami tanyakan adalah waktu kedaluwarsa yang sesuai dengan sumber daya tersebut. Misalnya, jika pesan umumnya dikirim secara massal, pesan tersebut terikat pada topik; jika pesan dikirim satu-ke-satu melalui uid, pesan tersebut terikat pada aplikasi, dan kuerinya adalah waktu berakhirnya topik berlangganan. atau aplikasi.
Metode permintaan: DAPATKAN
Deskripsi: Waktu kedaluwarsa pengguna tertentu pada sumber daya tertentu Karena suatu produk dapat diikat ke beberapa sumber daya, sebuah array dikembalikan (tetapi umumnya beberapa sumber daya tidak terikat).
Alamat permintaan: https://wxpusher.zjiecode.com/api/product/query-pay-end-time?uid={uid}&prodId={product id}
Deskripsi parameter:
Parameter respons:
{
"code": 1000,
"msg": "处理成功",
"data": [
{
"resourceType": 2, //资源类型，1对1uid发送的应用为1，群发主题为2
"resourceID": 123, //应用id或者主题id
"payEndTime": 1737560859272 //用户付费订阅到期时间，毫秒级的时间戳
}
],
"success": true
}
Jika produk Anda adalah produk perangkat lunak, silakan akses otorisasi WxPusher, sehingga pengguna dapat dengan mudah mengikatnya ke waktu kedaluwarsa yang sesuai setelah pembelian. Proses verifikasi umumnya adalah:
Untuk pengalaman pengguna yang lebih baik, kami bekerja keras untuk mengembangkan lebih banyak klien guna meningkatkan pengalaman pengguna.
Ekstensi Chrome adalah ekstensi yang didasarkan pada browser Chrome. Selama browser terbuka, Anda dapat menerima pesan. Saat ini mendukung komputer Mac dan Windows. Pengalaman menerima pesan lebih baik daripada WeChat. Anda dapat mengunjungi di sini https://github.com/wxpusher/wxpusher-chrome-extensions untuk mengunduh dan menginstal ekstensi browser.
Anda juga dapat mengunjungi di sini untuk melihat metode instalasi dan penggunaan spesifik: https://mp.weixin.qq.com/s/zrUdVqrE0odhUTiD7qhWiQ
Karena saat ini dikembangkan berdasarkan API browser V2, Google tidak akan mengizinkannya disimpan di rak. Kami akan menaruhnya di Toko Chrome setelah kami bermigrasi ke V3.
Karena pembatasan konten WeChat, untuk pengalaman pengguna yang lebih baik, Anda dapat mengunduh klien iOS Apple untuk menerima pesan demi pengalaman pengguna yang lebih baik. Metode pengunduhan adalah sebagai berikut:
Karena masalah ekologi Android dalam negeri, aplikasi Android masih dalam pengembangan.
WxPusher adalah layanan push gratis. Untuk melayani semua orang dengan lebih baik, berikut adalah batasan data terkait sistem.
