wxpusher docs
1.0.0
WxPusher (خدمة دفع WeChat) عبارة عن نظام أساسي لدفع المعلومات في الوقت الفعلي يستخدم حسابات WeChat العامة كقنوات. يمكنك إرسال المعلومات إلى WeChat عن طريق الاتصال بواجهات برمجة التطبيقات دون تثبيت برامج إضافية لتحقيق إشعار بالمعلومات في الوقت الفعلي. يمكنك استخدام WxPusher لعمل إشعارات إنذار الخادم، وإشعارات الاندفاع للفصل الدراسي، وإخطارات الاندفاع للتذاكر، ومطالبات تحديث المعلومات، وما إلى ذلك.
يمكنك الوصول إلى البرنامج التجريبي وتجربة الوظيفة: https://wxpusher.zjiecode.com/demo/
كود مصدر البرنامج التجريبي: https://github.com/wxpusher/wxpusher-sdk-java/
خلفية الإدارة: https://wxpusher.zjiecode.com/admin/
يرجى التأكد من عدم الاتصال بالبرنامج التجريبي وإرسال الرسائل مباشرة إلى المستخدمين! ! !
تم تعديل واجهة WeChat. أصبحت طريقة إرسال الرسائل النصية مباشرة غير متصلة بالإنترنت . نحن نعمل على تطوير طرق دفع جديدة، لذا تابعنا.
| يكتب | الحصول على معرف المستخدم | رسالة القالب | |||
|---|---|---|---|---|---|
| معاينة |  |  |  |  |  |
من أجل تسهيل مجموعات المستخدمين المختلفة وسيناريوهات الاستخدام المختلفة لإرسال الرسائل بسرعة وسهولة أكبر، فإننا ندعم حاليًا طريقتين لاستخدام WxPusher.
- يرجى ملاحظة أن طريقتي الإرسال هاتين لهما علامات هوية مختلفة ولا يمكن ترحيلهما أو التبديل بينهما؛
- إذا كان ذلك ممكنًا، فمن المستحسن استخدام الطريقة الأولى للحصول على إمكانيات أفضل.
| طريقة الإرسال | المزايا والعيوب والسيناريوهات القابلة للتطبيق |
|---|---|
| الدفع القياسي [مستحسن] (تطوير التطبيقات القياسية) |
|
| دفع الحد الأدنى (SPT دفع بنقرة واحدة) |
|
وفقًا لأحد مشاريعك، يتم استخدامه بشكل أساسي للمصادقة وعزل الموارد وما إلى ذلك (على غرار استخدام Amap SDK وتسجيل الدخول إلى WeChat وما إلى ذلك، ستنشئ أولاً تطبيقًا جديدًا لكل تطبيق اسمًا مستقلاً ورمز QR). وعنوان رد الاتصال الخطوة الأولى للاتصال بالموارد ومعلومات المصادقة وما إلى ذلك وإرسال الرسائل هي إنشاء تطبيق جديد.
لفهم ذلك ببساطة، لديك مشروع للحصول على تذاكر القطار، بمجرد الحصول على التذاكر، تحتاج إلى إرسال رسالة إلى المستخدم، لديك أيضًا مشروع لتنبيه الخادم عندما يكون الخادم غير طبيعي ما هي استخدامات هذين الشخصين المختلفين، يمكنك إنشاء تطبيقين لإرسال المعلومات الخاصة بهما بشكل منفصل.
يمكن للمستخدمين متابعة هذا التطبيق من خلال رمز الاستجابة السريعة أو الرابط. ومن خلال المتابعة، سنعيد معرف المستخدم الفريد إلى خادمك المعين. يمكنك إرسال المعلومات إلى هذا المستخدم من خلال معرف المستخدم الفريد.
الموضوع عبارة عن مجموعة من الرسائل ضمن التطبيق، على سبيل المثال، يتم إنشاء تطبيق متعلق بالخصم لدفع المعلومات التفضيلية المختلفة للمستخدمين، ومع ذلك، يهتم المستخدمون المختلفون بالمعلومات التفضيلية المختلفة، ويهتم بعض الأشخاص بـ Taobao الاهتمام بتاوباو. يهتم الناس بموقع JD.com. في هذا السيناريو، يمكنك إنشاء موضوع Taobao، ثم إنشاء موضوع JD.com. عند إرسال المعلومات، ما عليك سوى إرسالها مباشرة إلى الموضوع المقابل. كل موضوع له رابط اشتراك مطابق ورمز QR للمستخدمين بعد الاشتراك في هذا الموضوع ، يمكنك الحصول على معلومات ضمن هذا الموضوع.
لا يمكن إرسال المواضيع إلا إلى المجموعات بشكل عشوائي، ولا يمكن تخصيص الرسائل للمستخدمين بعد متابعة المستخدمين لها، ولن تكون هناك معلومات رد اتصال.
| مشروع | طلب | عنوان |
|---|---|---|
| مفهوم | التطبيق هو كيان مستقل | ينتمي السمة إلى التطبيق، ويتطلب استدعاء السمة الحصول على إذن APP_TOKEN للتطبيق المقابل. |
| كيفية المتابعة | رمز الاستجابة السريعة والرابط | رمز الاستجابة السريعة والرابط |
| إرسال المجموعة | إرسال واحد إلى واحد عن طريق UID | بعد إرسال الرسالة إلى الموضوع، يتم بعد ذلك توزيع الموضوع على المستخدمين الذين يتابعون الموضوع، وهي رسالة جماعية. |
| مشروع | تطبيق رمز الاستجابة السريعة | موضوع رمز الاستجابة السريعة |
|---|---|---|
| يستخدم | يستخدم لمستخدمي WeChat لمتابعة التطبيقات، ويتبع المستخدمون تطبيقك فقط. عندها فقط يمكنك الحصول على UID الخاص به وإرسال رسائل إليه. | يُستخدم للاشتراك في المواضيع بعد اشتراك المستخدم في موضوع ما، لا يمكنك الحصول على UID الخاص به. |
| ديناميكية وثابتة | رمز الاستجابة السريعة الديناميكي الافتراضي | رمز الاستجابة السريعة الديناميكي الافتراضي |
رمز الاستجابة السريعة الديناميكي : لن يتغير رابط رمز الاستجابة السريعة، لكن رسم رمز الاستجابة السريعة سيتغير، لذا يمكن استخدام روابط رمز الاستجابة السريعة الديناميكية فقط، ولا يُسمح بلقطات الشاشة والطباعة وما إلى ذلك.
رمز الاستجابة السريعة الثابت : تظل روابط ورسومات رمز الاستجابة السريعة دون تغيير ويمكن استخدامها حسب الرغبة.
لا يمكن معرفة رمز هوية التطبيق إلا لك بصفتك المطور. باستخدام APP_TOKEN، يمكنك إرسال رسائل إلى مستخدمي التطبيق المقابل، لذا يرجى الاحتفاظ بها في سرية تامة وعدم إرسالها إلى أماكن مثل github.
يتم استخدام شعار مستخدم WeChat للإشارة إلى المستخدم الذي يجب إرسال الرسالة إليه عند إرسال رسالة إلى مستخدم وحده.
قبل الوصول، يمكنك إلقاء نظرة على مخطط البنية لمساعدتك على فهم الفرق بين الإرسال الفردي والإرسال الجماعي. 
https://wxpusher.zjiecode.com/admin/، استخدم WeChat لمسح رمز الاستجابة السريعة لتسجيل الدخول، ولا يلزم التسجيل، وسيتم تسجيل المستخدمين الجدد تلقائيًا عن طريق مسح رمز الاستجابة السريعة لأول مرة.
قم بإنشاء تطبيق كما هو موضح أدناه:
عنوان رد الاتصال: ليس عليك ملؤه. إذا لم تملأه، فلن يكون هناك رد اتصال عندما يتبعه المستخدم. لا يمكنك الحصول على UID الخاص بالمستخدم، يرجى الرجوع إلى وصف رد الاتصال.
تعيين عنوان URL: لا تحتاج إلى ملؤه. بعد ملئه، يمكن للمستخدم فتح "اشتراكي" على WeChat والانتقال مباشرة إلى هذا العنوان، وسيتم نقل المعرف الفريد (uid) كمعلمة لتسهيل عرض الصفحة المخصصة.
معلومات الاتصال: لا تحتاج إلى ملئها. أخبر المستخدم بكيفية الاتصال بك وإبداء الرأي لك.
اتبع المطالبة: يتم إرسال مطالبة إلى المستخدم عندما يتبع المستخدم رمز التطبيق أو يقوم بمسحه ضوئيًا، ولا تحتاج إلى ملؤه. سيوفر Wxpusher نسخة افتراضية. يمكنك أيضًا إرسال رسالة تذكير إلى المستخدم بشكل فعال عندما ينتبه المستخدم إلى رد الاتصال ويمنحك UID.
الوصف: قم بوصف تطبيقك والمحتوى الذي يدفعه، ويمكن للمستخدمين رؤيته عند اتباع الرابط أو مشاهدته على WeChat.
أثناء عملية إنشاء التطبيق الخاص بك، من المفترض أن تكون قد شاهدت appToken. إذا لم يتم حفظه، فيمكنك إعادة إنتاجه بالطريقة التالية.
افتح الواجهة الخلفية للتطبيق https://wxpusher.zjiecode.com/admin/، وابحث عن قائمة appToken من شريط القائمة الأيسر. هنا، يمكنك إعادة تعيين appToken. يرجى ملاحظة أنه بعد إعادة التعيين، سيصبح appToken القديم غير صالح سوف يفشل الاتصال بالواجهة على الفور.
بعد إنشاء تطبيق، يمكنك رؤية رمز التطبيق واتباع رابط التطبيق. يمكنك السماح للمستخدمين بمتابعة تطبيقك بالطريقتين التاليتين. بعد متابعة تطبيقك، يمكنك إرسال رسائل إليه.
توجد حاليًا ثلاث طرق للحصول على 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 هي واجهة POST مخصصة بشكل أساسي لتسهيل الاتصال في بعض الحالات، وهي تدعم فقط إرسال النص (نوع المحتوى = 1).
https://wxpusher.zjiecode.com/api/send/message/?appToken=AT_qHT0cTQfLwYOlBV9cJj9zDSyEmspsmyM&content=123&uid=c1BcpqxEbD8irqlGUh9BhOqR2BvH8yWZ&url=http%3a%2f%2fwxpusher.zjiecode.com
دعم معلمات الطلب: appToken، وuid ، وtopicId ، وcontent، وurl، وverifyPayType. يرجى إجراء تشفير urlEncode على المحتوى وعنوان url.
تدعم واجهة GET فقط إرسال معرف المستخدم أو معرف الموضوع. يوصى باستخدام واجهة POST.
يتم إرسال الرسالة إلى Wxpusher، والتي سيتم تخزينها مؤقتًا، ودفعها بشكل غير متزامن إلى WeChat في الخلفية، ثم توزيعها على المستخدمين، عندما يكون عدد الرسائل ضخمًا، قد يكون هناك تأخير المستخدم استنادًا إلى sendRecordId الذي تم إرجاعه عن طريق إرسال الرسالة.
طريقة الطلب: الحصول على
ملاحظة: الاستعلام عن حالة الرسالة حساس للوقت. تم تعيين وقت التخزين المؤقت حاليًا على 7 أيام. إذا قمت بالاستعلام عن الرسالة بعد 7 أيام، فقد يُرجع ذلك إلى أن الرسالة غير موجودة.
عنوان الطلب: https://wxpusher.zjiecode.com/api/send/query/status?sendRecordId={sendRecordId}
وصف المعلمة:
طريقة الطلب: حذف
ملاحظة: بعد إرسال الرسالة، يمكنك الاتصال بالواجهة الثانوية لحذف الرسالة، ومع ذلك، يرجى ملاحظة أنه لا يمكن حذف سوى الصفحة المقصودة التي نقر عليها المستخدم لعرض التفاصيل يتم حذفها.
عنوان الطلب: https://wxpusher.zjiecode.com/api/send/message?messageContentId=${messageContentId}&appToken=${appToken}
وصف المعلمة:
هناك سيناريو تحتاج فيه إلى معرفة من قام بمسح رمز الاستجابة السريعة ضوئيًا، على سبيل المثال، هناك رسائل جديدة في منشورات المنتدى يجب إرسالها إلى المستخدمين، إذا قام المستخدم بمسح الرمز ضوئيًا للمتابعة، فأنت بحاجة إلى معرفة من قام بمسح رمز الاستجابة السريعة ضوئيًا رمز ووضع معرف مستخدم المنتدى ربط مع UID لمستخدم Wxpusher. عندما تكون هناك رسالة جديدة من معرف مستخدم المنتدى، سيتم دفعها إلى مستخدم Wxpusher. يتطلب هذا السيناريو رمز الاستجابة السريعة مع المعلمات.
طريقة الطلب: نشر
عنوان الطلب: https://wxpusher.zjiecode.com/api/fun/create/qrcode
نوع المحتوى: application/json
الوصف: قم بإنشاء رمز الاستجابة السريعة مع المعلمات بعد أن يقوم المستخدم بمسح الرمز، سيتم تضمين المعلمات في رد الاتصال.
هيئة الطلب:
{
"appToken" : " xxx " , //必填，appToken,前面有说明，应用的标志
"extra" : " xxx " , //必填，二维码携带的参数，最长64位
"validTime" : 1800 //可选，二维码的有效期，默认30分钟，最长30天，单位是秒
}
بعد أن يقوم المستخدم بمسح رمز الاستجابة السريعة للمعلمة وتعيين عنوان رد الاتصال، سندفع معرف المستخدم الفريد إلى خدمتك من خلال عنوان رد الاتصال للحصول على التفاصيل، راجع وصف رد الاتصال.
ومع ذلك، فإن بعض سيناريوهات المستخدم بسيطة، أو لا توجد خدمة خلفية، مثل برنامج العميل، وهو أمر غير مريح للغاية للاستخدام. لذلك، أضفنا واجهة الاستعلام هذه من خلال واجهة رمز الاستجابة السريعة لمعلمة الإنشاء أعلاه وستحصل على رمز QR Code استخدم هذا الرمز مع هذه الواجهة للاستعلام عن UID الخاص بالمستخدم الذي قام بمسح رمز QR للمعلمة آخر مرة.
لا يمكن أن تكون فترة التدريب أقل من 10 ثوانٍ! ! يحظر التدريب على الحلقات اللانهائية بعد خروج المستخدم، ويجب إيقاف التدريب، وإلا سيتم حظر الحساب.
طريقة الطلب: الحصول على
عنوان الطلب: https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid
معلمات الطلب (الاستعلام):
مثال
https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid?code=xxxxx
لقد تم إهمال هذه الواجهة، يرجى استخدام واجهة المستخدم V2 التالية للاستعلام عن التطبيق. يمكنك استخدام هذه الواجهة للاستعلام عن جميع مستخدمي WeChat الذين يتابعون تطبيقك حسب الصفحة.
طريقة الطلب: الحصول على
الوصف: احصل على معلومات المستخدم لجميع مستخدمي 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 //所有的用户数量
}يمكنك استخدام هذه الواجهة للاستعلام عن جميع المستخدمين الذين يتابعون التطبيق والموضوعات حسب الصفحة.
طريقة الطلب: الحصول على
الوصف: احصل على معلومات المستخدم لجميع مستخدمي 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
}يمكنك حذف اهتمام المستخدمين بالتطبيقات والموضوعات من خلال هذه الواجهة.
طريقة الطلب: حذف
ملحوظة: يمكنك حذف انتباه المستخدم للتطبيق أو الموضوع، بعد الحذف، يمكن للمستخدم متابعته مرة أخرى، إذا كنت لا تريد أن يتابعه المستخدم مرة أخرى، يمكنك استدعاء واجهة الحظر لحظر المستخدم.
عنوان الطلب: https://wxpusher.zjiecode.com/api/fun/remove
معلمات الطلب (الاستعلام):
إرجاع البيانات:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}يمكنك استخدام هذه الواجهة لحظر المستخدمين
طريقة الطلب: وضع
ملاحظة: لا يمكن إرسال المزيد من الرسائل بعد حظرها، ولا يمكن للمستخدم متابعته مرة أخرى إلا إذا قمت بإلغاء الحظر عنه. اتصل بواجهة القائمة السوداء بدلاً من استدعاء واجهة الحذف.
عنوان الطلب: https://wxpusher.zjiecode.com/api/fun/reject
معلمات الطلب (الاستعلام):
إرجاع البيانات:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}من أجل تسهيل الوصول السريع، ساهم المطورون المتحمسون بالعديد من أدوات الوصول إلى SDK، https://github.com/wxpusher/wxpusher-client.
يتم المساهمة في SDK بواسطة المطورين وقد لا تتضمن أحدث واجهة برمجة التطبيقات أو الوظائف. تخضع الوظائف لواجهة HTTP في هذه المقالة. كما نرحب بإرسال العلاقات العامة إلينا.
دفع بسيط، لا حاجة لتسجيل مستخدم، أو تسجيل الدخول إلى الواجهة الخلفية، أو إنشاء تطبيق، أو الحصول على appToken، وما إلى ذلك.
من أجل منع المستخدمين من فهم الكثير من المفاهيم وجعل الوصول إليها صعبًا، في بعض السيناريوهات حيث يرسل المستخدمون رسائل إلى أنفسهم ، يمكن استخدام طريقة الدفع البسيطة.
على سبيل المثال: ترسل بعض أنظمة الطلب في مراكز التسوق مفتوحة المصدر رسائل إلى المستخدمين بعد تقديم الطلبات؛ وأنظمة إعادة توجيه الرسائل النصية القصيرة، وما إلى ذلك، في السابق، كان يُطلب من المستخدمين إنشاء تطبيقات، والحصول على رموز التطبيق، ومتابعة التطبيقات، وملء المعرفات الفريدة (UID)، وما إلى ذلك. وكانت التكلفة مرتفعة للغاية.
يتطلب الدفع البسيط خطوتين فقط لإكمال الدفع:
ما عليك سوى مسح رمز الاستجابة السريعة أدناه للحصول على SPT الخاص بك
إذا كنت بحاجة إلى عرض رمز الاستجابة السريعة هذا في نظامك، فيمكنك استخدام الرابط الدائم التالي:
<textarea readonly 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
طريقة الطلب: نشر
عنوان URL للطلب: https://wxpusher.zjiecode.com/api/send/message/simple-push
تنسيق الطلب: نوع المحتوى: 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 الخاصة بمستخدم رمز الاستجابة السريعة للاستعلام.
لإرسال رسالة إلى مستخدم، تحتاج إلى معرفة 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} ، على سبيل المثال: #97، ولا يوجد محتوى بعده، فهذا يعني أنك تنتبه إلى التطبيق الذي يحمل معرف التطبيق 97.
تعليمات مبسطة
إذا قمت بإرسال المحتوى فقط: xxx، على سبيل المثال: إعادة تشغيل الخادم، فهذه المرة تنقسم إلى حالتين:
يمكن عرض معرف التطبيق في خلفية الإدارة، ومعرف تطبيق معلومات إدارة التطبيق.
يستخدم رد الاتصال طريقة 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 هو وقت انتهاء صلاحية اشتراك المستخدم.
عند إرسال رسالة إلى تطبيق أو سمة مجمعة كمنتج، يمكنك تمييز ما إذا كان من الممكن استلام هذه الرسالة من قبل المستخدمين فقط خلال فترة الاشتراك المدفوع. قم بالتمييز بناءً على حقل VerePayType
للحصول على التفاصيل، يمكنك التحقق من وصف الواجهة لإرسال الرسائل. إذا لم يكن هناك تطبيق أو موضوع مرتبط بمنتج الرسالة، فإن حقل VerePayType غير صالح ولا يلزم تمريره.
أنت بحاجة إلى الانتباه إلى المفهوم الذي نبيع فيه الموارد المرتبطة بالمنتجات، لذا فإن ما نستفسر عنه هو وقت انتهاء الصلاحية المطابق للمورد. على سبيل المثال، إذا تم إرسال الرسالة بشكل جماعي، فهي مرتبطة بالموضوع، وإذا تم إرسال الرسالة من شخص لآخر من خلال uid، فهي مرتبطة بالتطبيق، والاستعلام هو وقت انتهاء صلاحية موضوع الاشتراك؛ أو التطبيق.
طريقة الطلب: الحصول على
الوصف: وقت انتهاء الصلاحية لمستخدم معين على مورد معين لأنه يمكن ربط المنتج بموارد متعددة، يتم إرجاع مصفوفة (ولكن بشكل عام لا يتم ربط الموارد المتعددة).
عنوان الطلب: 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، كما أن تجربة تلقي الرسائل أفضل من WeChat. يمكنك زيارة https://github.com/wxpusher/wxpusher-chrome-extensions هنا لتنزيل ملحق المتصفح وتثبيته.
يمكنك أيضًا زيارة هنا لعرض طرق التثبيت والاستخدام المحددة: https://mp.weixin.qq.com/s/zrUdVqrE0odhUTiD7qhWiQ
نظرًا لأنه تم تطويره حاليًا استنادًا إلى واجهة برمجة تطبيقات المتصفح V2، فلن تسمح Google بوضعه على الرفوف، وسنضعه في متجر Chrome بعد ترحيلنا إلى الإصدار 3.
نظرًا لقيود محتوى WeChat، للحصول على تجربة مستخدم أفضل، نرحب بتنزيل عميل iOS Apple لتلقي الرسائل للحصول على تجربة مستخدم أفضل. طريقة التنزيل هي كما يلي:
نظرًا لمشاكل Android البيئية المحلية، لا تزال تطبيقات Android قيد التطوير. نحن آسفون جدًا.
WxPusher هي خدمة دفع مجانية من أجل تقديم خدمة أفضل للجميع، إليك قيود البيانات المتعلقة بالنظام.
