wxpusher docs
1.0.0
WxPusher (บริการพุช WeChat) เป็นแพลตฟอร์มพุชข้อมูลแบบเรียลไทม์ที่ใช้บัญชีอย่างเป็นทางการของ WeChat เป็นช่องทาง คุณสามารถพุชข้อมูลไปยัง WeChat ได้โดยการเรียก API โดยไม่ต้องติดตั้งซอฟต์แวร์เพิ่มเติม และคุณสามารถรับการแจ้งเตือนข้อมูลแบบเรียลไทม์ได้ คุณสามารถใช้ WxPusher เพื่อสร้างการแจ้งเตือนเซิร์ฟเวอร์ การแจ้งเตือนคลาสเร่งด่วน การแจ้งเตือนตั๋วเร่งด่วน ข้อความแจ้งการอัพเดทข้อมูล ฯลฯ
คุณสามารถเข้าถึงโปรแกรมสาธิตและสัมผัสกับฟังก์ชันการทำงาน: https://wxpusher.zjiecode.com/demo/
ซอร์สโค้ดโปรแกรมสาธิต: https://github.com/wxpusher/wxpusher-sdk-java/
ประวัติการจัดการ: https://wxpusher.zjiecode.com/admin/
โปรดอย่าเรียกโปรแกรมสาธิตและส่งข้อความถึงผู้ใช้โดยตรง! - -
อินเทอร์เฟซ WeChat ได้รับการปรับเปลี่ยนแล้ว วิธีการส่งข้อความโดยตรงเป็นแบบออฟไลน์ เรากำลังพัฒนาวิธีการพุชแบบใหม่ ดังนั้นโปรดคอยติดตาม
| พิมพ์ | รับรหัสผู้ใช้ | ข้อความเทมเพลต | |||
|---|---|---|---|---|---|
| ดูตัวอย่าง |  |  |  |  |  |
เพื่ออำนวยความสะดวกให้กับกลุ่มผู้ใช้ที่แตกต่างกันและสถานการณ์การใช้งานที่แตกต่างกันในการส่งข้อความได้รวดเร็วและสะดวกยิ่งขึ้น ขณะนี้เราสนับสนุนการใช้ WxPusher ได้ 2 วิธี
- โปรดทราบว่าวิธีการส่งทั้งสองนี้มีเครื่องหมายประจำตัวที่แตกต่างกัน และไม่สามารถโยกย้ายหรือสลับระหว่างกันได้
- หากเป็นไปได้ ขอแนะนำให้ใช้วิธีแรกเพื่อความสามารถที่ดีขึ้น
| วิธีการส่ง | ข้อดีข้อเสียและสถานการณ์ที่เกี่ยวข้อง |
|---|---|
| การกดแบบมาตรฐาน [แนะนำ] (การพัฒนาแอพพลิเคชั่นมาตรฐาน) |
|
| การกดแบบมินิมัลลิสต์ (SPT การกดเพียงคลิกเดียว) |
|
ตามโครงการใดโครงการหนึ่งของคุณ ส่วนใหญ่จะใช้สำหรับการตรวจสอบสิทธิ์ การแยกทรัพยากร ฯลฯ (คล้ายกับการใช้ Amap SDK, การเข้าสู่ระบบ WeChat ฯลฯ คุณจะต้องสร้างแอปพลิเคชันใหม่ก่อน) แต่ละแอปพลิเคชันจะมีชื่ออิสระ รหัส QR และที่อยู่สำหรับติดต่อกลับ ขั้นตอนแรกในการเรียกทรัพยากร ข้อมูลการตรวจสอบสิทธิ์ ฯลฯ และส่งข้อความคือการสร้างแอปพลิเคชันใหม่
เพื่อให้เข้าใจง่าย คุณมีโปรเจ็กต์ในการคว้าตั๋วรถไฟ เมื่อคุณคว้าตั๋วแล้ว คุณจะต้องส่งข้อความถึงผู้ใช้ คุณก็จะมีโปรเจ็กต์แจ้งเตือนเซิร์ฟเวอร์ด้วย เมื่อเซิร์ฟเวอร์ขัดข้อง ให้ส่งข้อความไปยังบุคคลที่เกี่ยวข้อง รับผิดชอบ การใช้งานของทั้งสองต่างกันคุณสามารถสร้าง 2 แอปพลิเคชันเพื่อส่งข้อมูลแยกกันได้
ผู้ใช้สามารถติดตามแอปพลิเคชันนี้ผ่านรหัส QR หรือลิงก์ เราจะโทรกลับ UID ของผู้ใช้ไปยังเซิร์ฟเวอร์ที่คุณระบุ คุณสามารถส่งข้อมูลไปยังผู้ใช้รายนี้ผ่าน UID
หัวข้อคือชุดของข้อความภายใต้แอปพลิเคชัน ตัวอย่างเช่น แอปพลิเคชันที่เกี่ยวข้องกับส่วนลดถูกสร้างขึ้นเพื่อส่งข้อมูลส่วนลดต่างๆ ให้กับผู้ใช้ อย่างไรก็ตาม ผู้ใช้บางคนให้ความสนใจกับข้อมูลส่วนลดที่แตกต่างกัน ให้ความสนใจกับ Taobao ผู้คนให้ความสนใจกับ JD.com ในสถานการณ์นี้ คุณสามารถสร้างหัวข้อ Taobao จากนั้นสร้างหัวข้อ JD.com เพียงส่งข้อมูลไปยังหัวข้อที่เกี่ยวข้องโดยตรง แต่ละหัวข้อจะมีลิงก์การสมัครรับข้อมูลและรหัส QR ที่เกี่ยวข้อง ท่านสามารถรับข้อมูลตามหัวข้อนี้ได้
หัวข้อสามารถส่งไปยังกลุ่มตามอำเภอใจเท่านั้น และไม่สามารถปรับแต่งข้อความสำหรับผู้ใช้ได้ หลังจากที่ผู้ใช้ติดตามแล้ว จะไม่มีข้อมูลการติดต่อกลับ
| โครงการ | แอปพลิเคชัน | หัวข้อ |
|---|---|---|
| แนวคิด | ใบสมัครเป็นนิติบุคคลอิสระ | ธีมนี้เป็นของแอปพลิเคชัน และการเรียกธีมต้องได้รับอนุมัติจาก APP_TOKEN ของแอปพลิเคชันที่เกี่ยวข้อง |
| วิธีการติดตาม | รหัส QR และลิงค์ | รหัส QR และลิงค์ |
| ส่งกลุ่ม | ส่งแบบตัวต่อตัวโดย UID | หลังจากที่ข้อความถูกส่งไปยังหัวข้อแล้ว หัวข้อนั้นจะถูกกระจายไปยังผู้ใช้ที่ติดตามหัวข้อซึ่งเป็นข้อความกลุ่ม |
| โครงการ | ใช้รหัส QR | รหัส QR ของธีม |
|---|---|---|
| ใช้ | ใช้สำหรับผู้ใช้ WeChat เพื่อติดตามแอปพลิเคชัน ผู้ใช้ติดตามแอปพลิเคชันของคุณเท่านั้น จากนั้นคุณจะได้รับ UID ของเขาและส่งข้อความถึงเขา | ใช้เพื่อสมัครรับหัวข้อ หลังจากผู้ใช้สมัครรับหัวข้อ คุณจะไม่สามารถรับ UID ของหัวข้อนั้นได้ |
| แบบไดนามิกและแบบคงที่ | รหัส QR ไดนามิกเริ่มต้น | รหัส QR ไดนามิกเริ่มต้น |
รหัส QR แบบไดนามิก : ลิงก์รหัส QR จะไม่เปลี่ยนแปลง แต่กราฟิกรหัส QR จะเปลี่ยน ดังนั้นจึงสามารถใช้ได้เฉพาะลิงก์รหัส QR แบบไดนามิกเท่านั้น และไม่อนุญาตให้จับภาพหน้าจอ การพิมพ์ ฯลฯ
รหัส QR แบบคงที่ : ลิงก์รหัส QR และกราฟิกยังคงไม่เปลี่ยนแปลงและสามารถใช้งานได้ตามต้องการ
โทเค็นประจำตัวของแอปพลิเคชันจะเป็นที่รู้จักสำหรับคุณในฐานะนักพัฒนาเท่านั้น ด้วย APP_TOKEN คุณสามารถส่งข้อความไปยังผู้ใช้แอปพลิเคชันที่เกี่ยวข้องได้ ดังนั้นโปรดเก็บเป็นความลับอย่างเคร่งครัดและอย่าส่งไปยังสถานที่เช่น GitHub
โลโก้ผู้ใช้ WeChat ใช้เพื่อระบุว่าควรส่งข้อความถึงผู้ใช้รายใดเมื่อส่งข้อความถึงผู้ใช้เพียงลำพัง
ก่อนที่จะเข้าถึง คุณสามารถดูแผนภาพสถาปัตยกรรมเพื่อช่วยให้คุณเข้าใจความแตกต่างระหว่างการส่งข้อมูลแบบเดี่ยวและการส่งข้อมูลแบบกลุ่ม 
https://wxpusher.zjiecode.com/admin/ ใช้ WeChat เพื่อสแกนโค้ด QR เพื่อเข้าสู่ระบบ ไม่จำเป็นต้องลงทะเบียน และผู้ใช้ใหม่จะถูกลงทะเบียนโดยอัตโนมัติโดยการสแกนโค้ด QR เป็นครั้งแรก
สร้างแอปพลิเคชันตามที่แสดงด้านล่าง:
ที่อยู่สำหรับติดต่อกลับ: คุณไม่จำเป็นต้องกรอก หากคุณไม่กรอก จะไม่มีการโทรกลับเมื่อผู้ใช้ติดตาม คุณไม่สามารถรับ UID ของผู้ใช้ได้ โปรดดูคำอธิบายการโทรกลับ
ตั้งค่า URL: คุณไม่จำเป็นต้องกรอก หลังจากกรอกแล้ว ผู้ใช้สามารถเปิด “การสมัครสมาชิกของฉัน” บน WeChat และข้ามไปยังที่อยู่นี้โดยตรง จากนั้น uid จะถูกนำไปใช้เป็นพารามิเตอร์เพื่ออำนวยความสะดวกในการแสดงเพจแบบกำหนดเอง
ข้อมูลติดต่อ: คุณไม่จำเป็นต้องกรอกข้อมูล บอกผู้ใช้ว่าจะติดต่อคุณอย่างไรและให้ข้อเสนอแนะ
ปฏิบัติตามพร้อมท์: ข้อความแจ้งที่ส่งถึงผู้ใช้เมื่อผู้ใช้ติดตามหรือสแกนโค้ดแอปพลิเคชัน คุณไม่จำเป็นต้องกรอก Wxpusher จะให้สำเนาเริ่มต้น คุณยังสามารถส่งข้อความเตือนไปยังผู้ใช้ได้เมื่อผู้ใช้ให้ความสนใจกับการโทรกลับและให้ UID แก่คุณ
คำอธิบาย: อธิบายแอปพลิเคชันของคุณและเนื้อหาที่พุช ผู้ใช้สามารถดูได้เมื่อพวกเขาคลิกลิงก์หรือดูบน WeChat
ในระหว่างกระบวนการสร้างแอปพลิเคชันของคุณ คุณควรเห็น appToken แล้ว หากไม่ได้บันทึก คุณสามารถสร้างใหม่ได้ด้วยวิธีต่อไปนี้
เปิดแบ็กเอนด์ของแอปพลิเคชัน https://wxpusher.zjiecode.com/admin/ และค้นหาเมนู appToken จากแถบเมนูด้านซ้าย ที่นี่ คุณสามารถรีเซ็ต appToken ได้ โปรดทราบว่าหลังจากรีเซ็ตแล้ว appToken เก่าจะใช้งานไม่ได้ การเรียกอินเทอร์เฟซจะล้มเหลวทันที
หลังจากสร้างแอปพลิเคชันแล้ว คุณสามารถดูรหัสแอปพลิเคชันและติดตามลิงก์ของแอปพลิเคชันได้ คุณสามารถให้ผู้ใช้ติดตามแอปพลิเคชันของคุณได้สองวิธีต่อไปนี้ หลังจากติดตามแอปพลิเคชันของคุณแล้ว คุณสามารถส่งข้อความถึงเขาได้
ขณะนี้มี 3 วิธีในการรับ UID:
หลังจากได้รับ UID แล้ว ให้จับคู่ appToken ของแอปพลิเคชัน จากนั้นเรียกอินเทอร์เฟซการส่งเพื่อส่งข้อความ
อินเทอร์เฟซทั้งหมดรองรับ https แล้ว
อินเทอร์เฟซ POST อินเทอร์เฟซ POST เป็นอินเทอร์เฟซที่ทำงานได้อย่างสมบูรณ์ และแนะนำให้ใช้
ประเภทเนื้อหา: application/json
ที่อยู่: https://wxpusher.zjiecode.com/api/send/message
ข้อมูลคำขอถูกวางไว้ในเนื้อหา และพารามิเตอร์เฉพาะมีดังนี้:
JSON ไม่รองรับความคิดเห็น เมื่อส่ง จะต้องลบความคิดเห็น
{
"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>
คำอธิบายข้อมูลส่งคืน:
{
"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
}
อินเทอร์เฟซ GET อินเทอร์เฟซ GET เป็นการแบ่งส่วนอินเทอร์เฟซ POST เป็นหลัก เพื่อความสะดวกในการโทรในบางกรณีเท่านั้น
https://wxpusher.zjiecode.com/api/send/message/?appToken=AT_qHT0cTQfLwYOlBV9cJj9zDSyEmspsmyM&content=123&uid=c1BcpqxEbD8irqlGUh9BhOqR2BvH8yWZ&url=http%3a%2f%2fwxpusher.zjiecode.com
ร้องขอการสนับสนุนพารามิเตอร์: appToken, uid , topicId , เนื้อหา, url, VerifyPayType โปรดดำเนินการเข้ารหัส urlEncode กับเนื้อหาและ url
อินเทอร์เฟซ GET รองรับการส่ง uid หรือ topicId เท่านั้น ขอแนะนำให้ใช้อินเทอร์เฟซ POST
ข้อความจะถูกส่งไปยัง Wxpusher ซึ่งจะถูกแคช พุชแบบอะซิงโครนัสไปยัง WeChat ในเบื้องหลัง จากนั้นจึงแจกจ่ายให้กับผู้ใช้ เมื่อจำนวนข้อความมีขนาดใหญ่ อาจมีความล่าช้า คุณสามารถตรวจสอบสถานะการส่งข้อความได้ ผู้ใช้ตาม sendRecordId ที่ส่งคืนโดยการส่งข้อความ
วิธีการขอ: GET
หมายเหตุ: สอบถามสถานะข้อความ แคชของข้อความเป็นแบบไวต่อเวลา ปัจจุบันตั้งเวลาแคชไว้ที่ 7 วัน หากคุณสอบถามข้อความหลังจากผ่านไป 7 วัน อาจส่งคืนได้ว่าไม่มีข้อความอยู่
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/send/query/status?sendRecordId={sendRecordId}
คำอธิบายพารามิเตอร์:
วิธีการร้องขอ: DELETE
หมายเหตุ: หลังจากส่งข้อความแล้ว คุณสามารถเรียกอินเทอร์เฟซรองเพื่อลบข้อความได้ อย่างไรก็ตาม โปรดทราบว่าเฉพาะหน้า Landing Page ที่ผู้ใช้คลิกเพื่อดูรายละเอียดเท่านั้นที่สามารถลบได้ จะถูกลบ
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/send/message?messageContentId=${messageContentId}&appToken=${appToken}
คำอธิบายพารามิเตอร์:
มีสถานการณ์ที่คุณจำเป็นต้องรู้ว่าใครสแกนโค้ด QR เช่น มีข้อความใหม่ในโพสต์ในฟอรัมที่ต้องส่งไปยังผู้ใช้ หากผู้ใช้สแกนโค้ดเพื่อติดตาม คุณจำเป็นต้องรู้ว่าใครสแกน QR รหัสและใส่ ID ผู้ใช้ฟอรัม ผูกกับ UID ของผู้ใช้ Wxpusher เมื่อมีข้อความใหม่จาก ID ผู้ใช้ฟอรัม ข้อความนั้นจะถูกส่งไปยังผู้ใช้ Wxpusher สถานการณ์นี้ต้องใช้รหัส QR พร้อมพารามิเตอร์
วิธีการขอ: POST
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/fun/create/qrcode
ประเภทเนื้อหา: application/json
คำอธิบาย: สร้างโค้ด QR พร้อมพารามิเตอร์ หลังจากที่ผู้ใช้สแกนโค้ดแล้ว พารามิเตอร์จะรวมอยู่ในการโทรกลับ
เนื้อหาคำขอ:
{
"appToken" : " xxx " , //必填，appToken,前面有说明，应用的标志
"extra" : " xxx " , //必填，二维码携带的参数，最长64位
"validTime" : 1800 //可选，二维码的有效期，默认30分钟，最长30天，单位是秒
}
หลังจากที่ผู้ใช้สแกนโค้ด QR ของพารามิเตอร์และตั้งค่าที่อยู่สำหรับติดต่อกลับ เราจะพุช UID ของผู้ใช้ไปยังบริการของคุณผ่านทางที่อยู่สำหรับติดต่อกลับ สำหรับรายละเอียด โปรดดูคำอธิบายในการติดต่อกลับ
อย่างไรก็ตาม สถานการณ์ผู้ใช้บางอย่างนั้นเรียบง่ายหรือไม่มีบริการแบ็คเอนด์ เช่น ซอฟต์แวร์ไคลเอ็นต์ ซึ่งไม่สะดวกในการใช้งานมาก ดังนั้นเราจึงเพิ่มอินเทอร์เฟซการสืบค้นนี้ผ่านอินเทอร์เฟซโค้ด QR ของพารามิเตอร์การสร้างข้างต้น และคุณจะได้รับรหัส QR ใช้รหัสนี้กับอินเทอร์เฟซนี้เพื่อค้นหา UID ของผู้ใช้ที่สแกนรหัส QR พารามิเตอร์ครั้งล่าสุด
ช่วงเวลาการฝึกต้องไม่น้อยกว่า 10 วินาที! - ห้ามใช้การฝึกวนซ้ำแบบไม่มีที่สิ้นสุด หลังจากที่ผู้ใช้ออกจากการฝึกแล้ว จะต้องปิดการฝึก มิฉะนั้นบัญชีจะถูกแบน
วิธีการขอ: GET
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid
พารามิเตอร์คำขอ (แบบสอบถาม):
ตัวอย่าง
https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid?code=xxxxx
อินเทอร์เฟซนี้เลิกใช้แล้ว โปรดใช้อินเทอร์เฟซผู้ใช้ V2 ต่อไปนี้เพื่อสอบถามแอป คุณสามารถใช้อินเทอร์เฟซนี้เพื่อค้นหาผู้ใช้ WeChat ทั้งหมดที่ติดตามแอปของคุณทีละหน้า
วิธีการขอ: GET
คำอธิบาย: รับข้อมูลผู้ใช้ของผู้ใช้ WeChat ทุกคนที่ติดตามแอปพลิเคชัน
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/fun/wxuser
พารามิเตอร์คำขอ:
ส่งคืนข้อมูล:
{
"page" : 1 , //当前数据页码
"pageSize" : 50 , //当前页码大小
"records" :[
{
"createTime" : 1572755754416 , //用户关注时间
"enable" : true , //是否可用，也就是用户是否开启接收消息
"headImg" : " xxxxxx " , //用户头像
"nickName" : " 0XFF " , //用户昵称
"uid" : " xxxxxxx " //用户的UID
}
],
"total" : 3 //所有的用户数量
}คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสอบถามผู้ใช้ทั้งหมดที่ติดตามแอปพลิเคชันและหัวข้อตามหน้า
วิธีการขอ: GET
คำอธิบาย: รับข้อมูลผู้ใช้ของผู้ใช้ WeChat ทั้งหมดที่ติดตามแอปพลิเคชัน/หัวข้อ ควรสังเกตว่าหากผู้ใช้ WeChat ติดตามแอปพลิเคชัน หัวข้อ หรือแม้แต่หลายหัวข้อพร้อมกัน ระบบจะส่งคืนบันทึกหลายรายการ
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/fun/wxuser/v2
พารามิเตอร์คำขอ:
{
"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
}คุณสามารถลบความสนใจของผู้ใช้ต่อแอปพลิเคชันและหัวข้อต่างๆ ได้ผ่านอินเทอร์เฟซนี้
วิธีการร้องขอ: DELETE
หมายเหตุ: คุณสามารถลบความสนใจของผู้ใช้ต่อแอปพลิเคชันหรือหัวข้อได้ หลังจากลบแล้ว ผู้ใช้สามารถติดตามได้อีกครั้ง หากคุณไม่ต้องการให้ผู้ใช้ติดตามอีกครั้ง คุณสามารถเรียกอินเทอร์เฟซบล็อกเพื่อบล็อกผู้ใช้ได้
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/fun/remove
พารามิเตอร์คำขอ (แบบสอบถาม):
ส่งคืนข้อมูล:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}คุณสามารถใช้อินเทอร์เฟซนี้เพื่อบล็อกผู้ใช้
วิธีการขอ: PUT
หมายเหตุ: ไม่สามารถส่งข้อความได้อีกหลังจากถูกบล็อก และผู้ใช้ไม่สามารถติดตามเขาได้อีก เว้นแต่คุณจะยกเลิกการบล็อก เรียกอินเทอร์เฟซบัญชีดำแทนที่จะเรียกอินเทอร์เฟซลบ
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/fun/reject
พารามิเตอร์คำขอ (แบบสอบถาม):
ส่งคืนข้อมูล:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}เพื่ออำนวยความสะดวกในการเข้าถึงที่รวดเร็ว นักพัฒนาที่มีความกระตือรือร้นได้สนับสนุน SDK การเข้าถึงจำนวนมาก https://github.com/wxpusher/wxpusher-client
SDK ได้รับการสนับสนุนโดยนักพัฒนาและอาจไม่รวม API หรือฟังก์ชันล่าสุด ฟังก์ชันต่างๆ ขึ้นอยู่กับอินเทอร์เฟซ HTTP ในบทความนี้ คุณยังสามารถส่ง PR ให้เราได้ด้วย
Minimalist push ไม่จำเป็นต้องลงทะเบียนผู้ใช้ เข้าสู่ระบบแบ็กเอนด์ สร้างแอปพลิเคชัน รับ appToken ฯลฯ
เพื่อป้องกันไม่ให้ผู้ใช้เข้าใจแนวคิดมากเกินไปและทำให้การเข้าถึงทำได้ยาก ในบาง สถานการณ์ที่ผู้ใช้ส่งข้อความถึงตัวเอง จึง สามารถใช้วิธีพุชแบบมินิมอลได้
ตัวอย่างเช่น: ระบบสั่งซื้อของห้างสรรพสินค้าโอเพ่นซอร์สบางระบบส่งข้อความถึงผู้ใช้หลังจากทำการสั่งซื้อ ระบบส่งต่อ SMS ฯลฯ ก่อนหน้านี้ผู้ใช้จำเป็นต้องสร้างแอปพลิเคชัน รับ appToken ติดตามแอปพลิเคชัน กรอก UID ฯลฯ ซึ่งมีค่าใช้จ่ายสูงเกินไป สำหรับผู้ใช้ทั่วไป
การผลักดันแบบมินิมัลลิสต์ต้องการเพียง 2 ขั้นตอนในการผลักดันให้เสร็จสมบูรณ์:
เพียงสแกนโค้ด QR ด้านล่างเพื่อรับ Push SPT ของคุณ
หากคุณต้องการแสดงโค้ด QR นี้ในระบบของคุณ คุณสามารถใช้ลิงก์ถาวรต่อไปนี้:
<textarea แบบอ่านอย่างเดียว style="width:100%;height:60px;"> https://wxpusher.zjiecode.com/api/qrcode/RwjGLMOPTYp35zSYQr0HxbCPrV9eU0wKVBXU1D5VVtya0cQXEJWPjqBdW3gKLifS.jpg </textarea>กรุณาอย่ารั่วไหล SPT หลังจาก SPT รั่วไหล ผู้ใช้ทุกคนสามารถส่งข้อความถึงคุณได้! - -
การส่งคำขอ GET อย่างง่าย
ใส่ SPT ที่คุณได้รับในขั้นตอนก่อนหน้าในลิงก์ด้านล่าง
คำขอโดยตรง: https://wxpusher.zjiecode.com/api/send/message/SPT ที่คุณได้รับ/เนื้อหาที่คุณต้องการส่ง
การส่งคำขอ POST อย่างง่าย
วิธีการขอ: POST
URL คำขอ: https://wxpusher.zjiecode.com/api/send/message/simple-push
รูปแบบคำขอ: Content-Type:application/json
ขอเนื้อหา:
//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 " ,
}
โปรดทราบ: เฉพาะวิธีที่หนึ่ง (การพุชมาตรฐาน) เท่านั้นที่รองรับการโทรกลับ
เมื่อผู้ใช้ติดตามแอปพลิเคชันหรือส่งข้อความคำสั่งไปยังบัญชีอย่างเป็นทางการ WxPusher จะส่งข้อความถึงคุณ หากคุณไม่มีบริการพื้นหลัง คุณสามารถดำเนินการฝึกอบรมการหมุนเวียนได้ โปรดดูอินเทอร์เฟซ UID ของผู้ใช้โค้ด QR
หากต้องการส่งข้อความถึงผู้ใช้ คุณต้องทราบ UID ของผู้ใช้ มีสองวิธีในการทราบ UID ของผู้ใช้:
{
"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 " //用户扫描带参数的二维码，二维码携带的参数。扫描默认二维码为空
}
}สำหรับผลิตภัณฑ์การรับส่งข้อความ นักพัฒนาอาจจำเป็นต้องทราบสถานะการสมัครรับข้อมูลแบบชำระเงินของผู้ใช้หลังจากที่ผู้ใช้ชำระเงินหรือคืนเงินแล้ว
ดังนั้น เมื่อสถานะการสมัครสมาชิกแบบชำระเงินของผู้ใช้เปลี่ยนแปลง คุณจะได้รับแจ้งผ่านข้อความโทรกลับต่อไปนี้ เมื่อคุณได้รับการแจ้งเตือน คุณสามารถสอบถามเวลาหมดอายุการสมัครสมาชิกของผู้ใช้และข้อมูลอื่น ๆ ได้โดยการสอบถามรายชื่อผู้ใช้ 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
}
}ปัจจุบัน WxPusher รองรับข้อความอัปสตรีมประเภทคำสั่งแล้ว เมื่อผู้ใช้ส่งคำสั่ง WxPusher จะโทรกลับข้อความคำสั่งไปยังผู้พัฒนา
คำสั่งมาตรฐาน
รูปแบบของคำสั่งคือ: #{appID} content ตัวอย่าง เช่น หากต้องการส่งข้อความไปยังโปรแกรมสาธิต คุณสามารถส่ง: #97 test โปรดทราบว่ามีช่องว่างตรงกลาง
คำแนะนำการสมัครสมาชิก
หากคุณส่งเฉพาะ appID: #{appID} เช่น #97 และไม่มีเนื้อหาหลังจากนั้น แสดงว่าคุณกำลังให้ความสนใจกับแอปพลิเคชันที่มี appID 97
คำแนะนำแบบง่าย
หากคุณส่งเฉพาะเนื้อหา: xxx เช่น: รีสตาร์ทเซิร์ฟเวอร์ เวลานี้จะแบ่งออกเป็นสองสถานการณ์:
สามารถดู appID ได้ในพื้นหลังการจัดการ การจัดการแอปพลิเคชัน ข้อมูลแอปพลิเคชัน รหัสแอปพลิเคชัน
การโทรกลับใช้วิธีการ POST และรูปแบบข้อมูลจะเป็นดังนี้:
{
"action" : " send_up_cmd " , //动作，send_up_cmd 表示上行消息回调，后期可能会添加其他动作，请做好兼容。
"data" :{
"uid" : " UID_xxx " , //用户uid
"appId" : 97 , //应用id
"appName" : " WxPusher演示" , //应用名称
"time" : 1603002697386 , //发生时间
"content" : "内容" //用户发送的内容
}
}โปรดทราบ: เฉพาะวิธีที่หนึ่ง (การกดมาตรฐาน) รองรับการชาร์จผลิตภัณฑ์ข้อความ
โปรดทราบว่าการเรียกเก็บเงินนี้หมายถึง: นักพัฒนาข้อความที่เรียกเก็บเงินจากตัวรับข้อความผ่าน WxPusher ไม่ใช่ WxPusher ที่เรียกเก็บเงินจากนักพัฒนาหรือผู้ใช้
ในฐานะนักพัฒนา คุณมีหน้าที่รับผิดชอบในการให้ข้อมูลอันมีค่า และเรามีหน้าที่รับผิดชอบในการช่วยให้คุณสร้างรายได้
กระบวนการเข้าถึงมีดังนี้:
ผลิตภัณฑ์ข้อความคือแพ็คเกจข้อความแอปพลิเคชันที่ส่งครั้งเดียวและข้อความหัวข้อที่ส่งเป็นกลุ่ม
โปรดทราบว่าขณะนี้เราไม่ยอมรับข่าวสารคำแนะนำกลยุทธ์เกี่ยวกับหุ้น ออฟชั่น พันธบัตร กองทุน ฯลฯ
คุณต้องใส่ใจกับแนวคิด สิ่งที่เราขายคือทรัพยากรที่ผูกกับผลิตภัณฑ์ ตัวอย่างเช่น ทรัพยากรที่ส่งเป็นกลุ่มโดยทั่วไปจะถูกผูกไว้กับธีม .
โปรดทราบว่าผลิตภัณฑ์ปัจจุบันไม่รองรับการแก้ไขหลังจากสร้างแล้ว โปรดกรอกให้ชัดเจนก่อนส่ง
หลังจากส่งแล้ว โปรดติดต่อฝ่ายบริการลูกค้า WeChat "wxpusher-kefu" เพื่อตรวจสอบและเจรจาเกี่ยวกับกลยุทธ์ราคาการชำระเงิน หลังจากเสร็จสิ้น ก็สามารถวางตลาดข้อความได้ และผู้ใช้สามารถชำระเงินและซื้อได้โดยตรงในตลาดข้อความ
| แสดงให้เห็น | ตลาดข่าว | รายการสินค้าทางข้อความ | ข้อความแนะนำผลิตภัณฑ์ |
|---|---|---|---|
| ตัวอย่าง |  |  |  |
สามารถสืบค้นข้อมูลผู้ใช้ได้โดยการสืบค้นรายชื่อผู้ใช้ V2 โดยที่ payEndTime คือเวลาหมดอายุการสมัครของผู้ใช้
เมื่อส่งข้อความไปยังแอปพลิเคชันหรือธีมที่รวมเป็นผลิตภัณฑ์ คุณสามารถแยกแยะได้ว่าผู้ใช้สามารถรับข้อความนี้ได้ภายในระยะเวลาการสมัครแบบชำระเงินเท่านั้นหรือไม่ สร้างความแตกต่างตามฟิลด์ VerifyPayType
สำหรับรายละเอียด คุณสามารถตรวจสอบคำอธิบายอินเทอร์เฟซสำหรับการส่งข้อความ หากไม่มีแอปพลิเคชันหรือหัวข้อที่เกี่ยวข้องกับผลิตภัณฑ์ข้อความ ช่อง VerifyPayType จะไม่ถูกต้องและไม่จำเป็นต้องส่งผ่าน
คุณต้องใส่ใจกับแนวคิด เราขายทรัพยากรที่เชื่อมโยงกับผลิตภัณฑ์ ดังนั้น สิ่งที่เราค้นหาคือเวลาหมดอายุที่สอดคล้องกับทรัพยากร ตัวอย่างเช่น หากโดยทั่วไปข้อความถูกส่งเป็นกลุ่ม ข้อความนั้นจะถูกผูกไว้กับหัวข้อ หากข้อความถูกส่งแบบตัวต่อตัวผ่าน uid ข้อความนั้นจะถูกผูกไว้กับแอปพลิเคชัน และการสืบค้นคือเวลาหมดอายุของหัวข้อการสมัครสมาชิก หรือแอปพลิเคชัน
วิธีการขอ: GET
คำอธิบาย: เวลาหมดอายุของผู้ใช้บางรายในทรัพยากรบางอย่าง เนื่องจากผลิตภัณฑ์สามารถเชื่อมโยงกับทรัพยากรหลายรายการได้ จึงส่งคืนอาร์เรย์ (แต่โดยทั่วไปแล้วทรัพยากรหลายรายการจะไม่ถูกผูกไว้)
ที่อยู่คำขอ: https://wxpusher.zjiecode.com/api/product/query-pay-end-time?uid={uid}&prodId={product id}
คำอธิบายพารามิเตอร์:
พารามิเตอร์การตอบสนอง:
{
"code": 1000,
"msg": "处理成功",
"data": [
{
"resourceType": 2, //资源类型，1对1uid发送的应用为1，群发主题为2
"resourceID": 123, //应用id或者主题id
"payEndTime": 1737560859272 //用户付费订阅到期时间，毫秒级的时间戳
}
],
"success": true
}
หากคุณเป็นผลิตภัณฑ์ซอฟต์แวร์ โปรดเข้าถึงการอนุญาตของ WxPusher เพื่อให้ผู้ใช้สามารถผูกเข้ากับเวลาหมดอายุที่สอดคล้องกันหลังจากการซื้อได้อย่างง่ายดาย กระบวนการตรวจสอบทั่วไปคือ:
เพื่อประสบการณ์ผู้ใช้ที่ดีขึ้น เรากำลังทำงานอย่างหนักเพื่อพัฒนาลูกค้าให้มากขึ้นเพื่อปรับปรุงประสบการณ์ผู้ใช้
ส่วนขยาย Chrome เป็นส่วนขยายที่ใช้เบราว์เซอร์ Chrome ตราบใดที่เบราว์เซอร์เปิดอยู่ คุณก็สามารถรับข้อความได้ ปัจจุบันรองรับคอมพิวเตอร์ Mac และ Windows ดีกว่ายินดีให้ลองใช้ คุณสามารถเยี่ยมชมที่นี่ https://github.com/wxpusher/wxpusher-chrome-extensions เพื่อดาวน์โหลดและติดตั้งส่วนขยายเบราว์เซอร์
คุณยังสามารถเยี่ยมชมที่นี่เพื่อดูวิธีการติดตั้งและการใช้งานเฉพาะ: https://mp.weixin.qq.com/s/zrUdVqrE0odhUTiD7qhWiQ
เนื่องจากปัจจุบันได้รับการพัฒนาโดยใช้เบราว์เซอร์ V2 API Google จึงไม่อนุญาตให้วางบนชั้นวาง เราจะนำไปไว้ใน Chrome Store หลังจากที่เราย้ายไปยัง V3
เนื่องจากข้อจำกัดด้านเนื้อหาของ WeChat เพื่อประสบการณ์การใช้งานที่ดีขึ้น คุณสามารถดาวน์โหลดไคลเอนต์ iOS Apple เพื่อรับข้อความเพื่อประสบการณ์การใช้งานที่ดีขึ้น วิธีการดาวน์โหลดมีดังนี้:
เนื่องจากปัญหาทางนิเวศวิทยาในประเทศของ Android แอปพลิเคชัน Android ยังอยู่ระหว่างการพัฒนา เราต้องขออภัยเป็นอย่างสูง
WxPusher เป็นบริการพุชฟรี เพื่อให้บริการทุกคนได้ดียิ่งขึ้น นี่คือข้อจำกัดด้านข้อมูลที่เกี่ยวข้องกับระบบ
