wxpusher docs
1.0.0
WxPusher (WeChat-Push-Dienst) ist eine Echtzeit-Informations-Push-Plattform, die öffentliche WeChat-Konten als Kanäle verwendet. Sie können Informationen an WeChat übertragen, indem Sie APIs aufrufen, ohne zusätzliche Software zu installieren, um eine Echtzeitbenachrichtigung von Informationen zu erreichen. Sie können WxPusher verwenden, um Serveralarmbenachrichtigungen, Benachrichtigungen über den Ansturm von Kursen, Benachrichtigungen über den Ansturm von Tickets, Aufforderungen zur Informationsaktualisierung usw. zu erstellen.
Sie können auf das Demoprogramm zugreifen und die Funktionalität erleben: https://wxpusher.zjiecode.com/demo/
Quellcode des Demoprogramms: https://github.com/wxpusher/wxpusher-sdk-java/
Managementhintergrund: https://wxpusher.zjiecode.com/admin/
Bitte achten Sie darauf, nicht das Demoprogramm aufzurufen und Nachrichten direkt an Benutzer zu senden! ! !
Die WeChat-Schnittstelle wurde angepasst. Die Methode zum direkten Versenden von Textnachrichten wurde offline angepasst . Wir entwickeln neue Push-Methoden.
| Typ | Benutzer-ID abrufen | Vorlagenachricht | |||
|---|---|---|---|---|---|
| Vorschau |  |  |  |  |  |
Um verschiedenen Benutzergruppen und unterschiedlichen Nutzungsszenarien das schnellere und bequemere Versenden von Nachrichten zu ermöglichen, unterstützen wir derzeit zwei Arten der Verwendung von WxPusher.
- Bitte beachten Sie, dass diese beiden Versandarten unterschiedliche Identitätskennzeichen haben und nicht migriert oder untereinander umgeschaltet werden können;
- Wenn möglich, wird dringend empfohlen, die erste Methode zu verwenden, um bessere Funktionen zu erzielen.
| Sendemethode | Vorteile, Nachteile und anwendbare Szenarien |
|---|---|
| Standard-Push [empfohlen] (Standardanwendungsentwicklung) |
|
| Minimalistischer Push (SPT One-Click-Push) |
|
Entsprechend einem Ihrer Projekte wird es hauptsächlich zur Authentifizierung, Ressourcenisolierung usw. verwendet (ähnlich wie bei der Verwendung von Amap SDK, WeChat-Anmeldung usw. erstellen Sie zunächst eine neue Anwendung. Jede Anwendung verfügt über einen unabhängigen Namen und QR-Code). und Rückrufadresse. Der erste Schritt zum Aufrufen von Ressourcen, Authentifizierungsinformationen usw. und zum Senden von Nachrichten besteht darin, eine neue Anwendung zu erstellen.
Um es einfach zu verstehen: Sie haben ein Projekt, um Bahntickets zu erhalten. Sobald Sie die Tickets erhalten haben, müssen Sie auch eine Nachricht an den Server senden Was sind die unterschiedlichen Verwendungszwecke dieser beiden Personen? Sie können zwei Anwendungen erstellen, um ihre Informationen separat zu senden.
Benutzer können dieser Anwendung über den QR-Code oder Link folgen. Indem wir folgen, rufen wir die UID des Benutzers an Ihren angegebenen Server zurück. Sie können diesem Benutzer Informationen über die UID senden.
Das Thema ist eine Sammlung von Nachrichten unter der Anwendung. Beispielsweise wird eine rabattbezogene Anwendung erstellt, um verschiedene bevorzugte Informationen an Benutzer weiterzugeben. Einige Benutzer achten jedoch auf unterschiedliche bevorzugte Informationen Aufmerksamkeit auf Taobao. Die Leute achten auf JD.com. In diesem Szenario können Sie ein Taobao-Thema erstellen und dann ein JD.com-Thema erstellen. Senden Sie es einfach direkt an das entsprechende Thema. Jedes Thema verfügt über einen entsprechenden Abonnementlink und einen QR-Code Informationen erhalten Sie unter diesem Thema.
Themen können nur wahllos an Gruppen gesendet werden und Nachrichten können nicht für Benutzer angepasst werden. Nachdem Benutzer ihnen gefolgt sind, werden keine Rückrufinformationen angezeigt.
| Projekt | Anwendung | Thema |
|---|---|---|
| Konzept | Die Anwendung ist eine unabhängige Einheit | Das Thema gehört zur Anwendung und der Aufruf des Themas erfordert die APP_TOKEN-Autorisierung der entsprechenden Anwendung. |
| So folgen Sie | QR-Code und Link | QR-Code und Link |
| Gruppe senden | Senden Sie eins zu eins per UID | Nachdem die Nachricht an das Thema gesendet wurde, wird das Thema an Benutzer verteilt, die dem Thema folgen. Dabei handelt es sich um eine Gruppennachricht. |
| Projekt | QR-Code anwenden | Themen-QR-Code |
|---|---|---|
| verwenden | Wird für WeChat-Benutzer verwendet, um Bewerbungen zu folgen. Benutzer folgen nur Ihrer Bewerbung. Nur dann können Sie seine UID erhalten und ihm Nachrichten senden. | Wird zum Abonnieren von Themen verwendet. Nachdem ein Benutzer ein Thema abonniert hat, können Sie dessen UID nicht abrufen. |
| Dynamisch und statisch | Standardmäßiger dynamischer QR-Code | Standardmäßiger dynamischer QR-Code |
Dynamischer QR-Code : Der QR-Code-Link ändert sich nicht, aber die QR-Code-Grafik ändert sich, sodass nur dynamische QR-Code-Links verwendet werden können und Screenshots, Drucken usw. nicht zulässig sind.
Statischer QR-Code : Die QR-Code-Links und Grafiken bleiben unverändert und können beliebig verwendet werden.
Das Identitätstoken der Anwendung kann nur Ihnen als Entwickler bekannt sein. Mit APP_TOKEN können Sie Nachrichten an Benutzer der entsprechenden Anwendung senden. Behandeln Sie es daher streng vertraulich und senden Sie es nicht an Orte wie Github.
Das WeChat-Benutzerlogo wird verwendet, um anzugeben, an welchen Benutzer die Nachricht gesendet werden soll, wenn eine Nachricht nur an einen Benutzer gesendet wird.
Bevor Sie darauf zugreifen, können Sie sich das Architekturdiagramm ansehen, um den Unterschied zwischen Einzelübertragung und Gruppenübertragung zu verstehen. 
https://wxpusher.zjiecode.com/admin/, verwenden Sie WeChat, um den QR-Code zu scannen, um sich anzumelden. Es ist keine Registrierung erforderlich und neue Benutzer werden automatisch registriert, indem sie den QR-Code zum ersten Mal scannen.
Erstellen Sie eine Anwendung wie unten gezeigt:
Rückrufadresse: Sie müssen diese nicht ausfüllen. Wenn Sie sie nicht ausfüllen, erfolgt kein Rückruf, wenn der Benutzer ihr folgt. Bitte beachten Sie die Rückrufbeschreibung.
URL festlegen: Sie müssen diese nicht ausfüllen. Nach dem Ausfüllen kann der Benutzer „Mein Abonnement“ auf WeChat öffnen und direkt zu dieser Adresse springen. Die UID wird als Parameter übertragen, um die benutzerdefinierte Seitenanzeige zu erleichtern.
Kontaktinformationen: Sie müssen diese nicht ausfüllen. Teilen Sie dem Benutzer mit, wie er Sie kontaktieren und Ihnen Feedback geben kann.
Eingabeaufforderung folgen: Eine Eingabeaufforderung, die an den Benutzer gesendet wird, wenn der Benutzer dem Anwendungscode folgt oder ihn scannt. Sie müssen ihn nicht ausfüllen. Wxpusher stellt eine Standardkopie bereit. Sie können dem Benutzer auch aktiv eine Erinnerungsnachricht senden, wenn der Benutzer auf den Rückruf achtet und Ihnen die UID gibt.
Beschreibung: Beschreiben Sie Ihre Anwendung und welche Inhalte sie pusht. Benutzer können sie sehen, wenn sie dem Link folgen oder ihn auf WeChat ansehen.
Während des Erstellungsprozesses Ihrer Anwendung sollten Sie das appToken gesehen haben. Wenn es nicht gespeichert ist, können Sie es wie folgt reproduzieren.
Öffnen Sie das Backend der Anwendung https://wxpusher.zjiecode.com/admin/ und suchen Sie in der linken Menüleiste nach dem AppToken. Hier können Sie das AppToken zurücksetzen. Bitte beachten Sie, dass das alte AppToken ungültig wird Der Aufruf der Schnittstelle schlägt sofort fehl.
Nachdem Sie eine Anwendung erstellt haben, können Sie den Anwendungscode und den Link der Anwendung sehen. Sie können Ihren Benutzern die Möglichkeit geben, Ihrer Anwendung auf die folgenden zwei Arten zu folgen. Nachdem Sie Ihrer Anwendung gefolgt sind, können Sie ihm Nachrichten senden.
Derzeit gibt es drei Möglichkeiten, eine UID zu erhalten:
Nachdem Sie die UID erhalten haben, passen Sie sie dem AppToken der Anwendung an und rufen Sie dann die sendende Schnittstelle auf, um die Nachricht zu senden.
Alle Schnittstellen unterstützen bereits https.
POST-Schnittstelle Die POST-Schnittstelle ist eine voll funktionsfähige Schnittstelle und wird zur Verwendung empfohlen.
Inhaltstyp:application/json
Adresse: https://wxpusher.zjiecode.com/api/send/message
Die Anforderungsdaten werden im Hauptteil platziert und die spezifischen Parameter lauten wie folgt:
JSON unterstützt keine Kommentare. Beim Senden müssen Kommentare gelöscht werden.
{
"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>
Beschreibung der Rückgabedaten:
{
"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-Schnittstelle Die GET-Schnittstelle ist eine Kastration der POST-Schnittstelle. Sie dient in einigen Fällen hauptsächlich der Zweckmäßigkeit des Aufrufs. Sie unterstützt nur das Senden von Text (contentType=1).
https://wxpusher.zjiecode.com/api/send/message/?appToken=AT_qHT0cTQfLwYOlBV9cJj9zDSyEmspsmyM&content=123&uid=c1BcpqxEbD8irqlGUh9BhOqR2BvH8yWZ&url=http%3a%2f%2fwxpusher.zjiecode.com
Unterstützung für Anforderungsparameter: appToken, uid , topicId , content, url, verifyPayType. Bitte führen Sie eine URLEncode-Codierung für Inhalt und URL durch.
Die GET-Schnittstelle unterstützt nur das Senden einer UID oder Topic-ID. Es wird empfohlen, die POST-Schnittstelle zu verwenden.
Die Nachricht wird an Wxpusher gesendet, der zwischengespeichert, im Hintergrund asynchron an WeChat weitergeleitet und dann an Benutzer verteilt wird. Wenn die Anzahl der Nachrichten groß ist, kann es zu einer Verzögerung kommen Benutzer basierend auf der sendRecordId, die durch das Senden der Nachricht zurückgegeben wird.
Anforderungsmethode: GET
Hinweis: Fragen Sie den Nachrichten-Cache ab. Die Cache-Zeit ist derzeit auf 7 Tage eingestellt. Wenn Sie die Nachricht nach 7 Tagen abfragen, wird möglicherweise zurückgegeben, dass die Nachricht nicht vorhanden ist.
Anfrageadresse: https://wxpusher.zjiecode.com/api/send/query/status?sendRecordId={sendRecordId}
Parameterbeschreibung:
Anforderungsmethode: DELETE
Hinweis: Nachdem die Nachricht gesendet wurde, können Sie die sekundäre Schnittstelle aufrufen, um die Nachricht zu löschen. Beachten Sie jedoch, dass nur die Zielseite, auf die der Benutzer geklickt hat, um die Details anzuzeigen, nicht gelöscht werden kann gelöscht werden.
Anfrageadresse: https://wxpusher.zjiecode.com/api/send/message?messageContentId=${messageContentId}&appToken=${appToken}
Parameterbeschreibung:
Es gibt ein Szenario, in dem Sie wissen müssen, wer den QR-Code gescannt hat. Beispielsweise gibt es neue Nachrichten in Forenbeiträgen, die an Benutzer weitergeleitet werden müssen. Wenn der Benutzer den Code scannt, müssen Sie wissen, wer den QR gescannt hat Code eingeben und die Forum-Benutzer-ID an die UID des Wxpusher-Benutzers binden. Wenn eine neue Nachricht von der Forum-Benutzer-ID vorliegt, wird diese an den Wxpusher-Benutzer weitergeleitet. Für dieses Szenario ist ein QR-Code mit Parametern erforderlich.
Anfragemethode: POST
Anfrageadresse: https://wxpusher.zjiecode.com/api/fun/create/qrcode
Inhaltstyp: application/json
Beschreibung: Erstellen Sie einen QR-Code mit Parametern. Nachdem der Benutzer den Code gescannt hat, werden die Parameter in den Rückruf aufgenommen.
Anfragetext:
{
"appToken" : " xxx " , //必填，appToken,前面有说明，应用的标志
"extra" : " xxx " , //必填，二维码携带的参数，最长64位
"validTime" : 1800 //可选，二维码的有效期，默认30分钟，最长30天，单位是秒
}
Nachdem der Benutzer den Parameter-QR-Code gescannt und die Rückrufadresse festgelegt hat, übertragen wir die UID des Benutzers über die Rückrufadresse an Ihren Dienst. Weitere Informationen finden Sie in der Rückrufbeschreibung.
Einige Benutzerszenarien sind jedoch einfach oder es gibt keinen Back-End-Dienst, z. B. Client-Software, was sehr unpraktisch ist. Daher haben wir diese Abfrageschnittstelle hinzugefügt. Erstellen Sie einen QR-Code über die obige QR-Code-Erstellungsschnittstelle , und Sie erhalten einen QR-Code-Code. Verwenden Sie diesen Code mit dieser Schnittstelle, um die UID des Benutzers abzufragen, der den Parameter-QR-Code zuletzt gescannt hat.
Das Trainingsintervall darf nicht weniger als 10 Sekunden betragen! ! Endlosschleifentraining ist verboten. Nach dem Beenden des Benutzers muss das Training deaktiviert werden, andernfalls wird das Konto gesperrt.
Anforderungsmethode: GET
Anfrageadresse: https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid
Anforderungsparameter (Abfrage):
ein Beispiel
https://wxpusher.zjiecode.com/api/fun/scan-qrcode-uid?code=xxxxx
Diese Schnittstelle ist veraltet. Bitte verwenden Sie die folgende Benutzeroberfläche der Version 2, um die App abzufragen. Über diese Schnittstelle können Sie alle WeChat-Benutzer, die Ihrer App folgen, seitenweise abfragen.
Anforderungsmethode: GET
Beschreibung: Rufen Sie die Benutzerinformationen aller WeChat-Benutzer ab, die der Anwendung folgen
Anfrageadresse: https://wxpusher.zjiecode.com/api/fun/wxuser
Anforderungsparameter:
Rückgabedaten:
{
"page" : 1 , //当前数据页码
"pageSize" : 50 , //当前页码大小
"records" :[
{
"createTime" : 1572755754416 , //用户关注时间
"enable" : true , //是否可用，也就是用户是否开启接收消息
"headImg" : " xxxxxx " , //用户头像
"nickName" : " 0XFF " , //用户昵称
"uid" : " xxxxxxx " //用户的UID
}
],
"total" : 3 //所有的用户数量
}Über diese Schnittstelle können Sie alle Benutzer, die der Anwendung und den Themen folgen, seitenweise abfragen.
Anforderungsmethode: GET
Beschreibung: Rufen Sie die Benutzerinformationen aller WeChat-Benutzer ab, die der Anwendung/dem Thema folgen. Es ist zu beachten, dass mehrere Datensätze zurückgegeben werden, wenn ein WeChat-Benutzer Anwendungen, Themen oder sogar mehreren Themen gleichzeitig folgt.
Anfrageadresse: https://wxpusher.zjiecode.com/api/fun/wxuser/v2
Anforderungsparameter:
{
"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
}Über diese Schnittstelle können Sie die Aufmerksamkeit der Benutzer auf Anwendungen und Themen löschen.
Anforderungsmethode: DELETE
Hinweis: Sie können die Aufmerksamkeit des Benutzers auf die Anwendung oder das Thema löschen. Nach dem Löschen kann der Benutzer der Anwendung oder dem Thema erneut folgen. Wenn Sie nicht möchten, dass der Benutzer der Anwendung oder dem Thema erneut folgt, können Sie die Blockschnittstelle aufrufen, um den Benutzer zu blockieren.
Anforderungsadresse: https://wxpusher.zjiecode.com/api/fun/remove
Anforderungsparameter (Abfrage):
Rückgabedaten:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}Über diese Schnittstelle können Sie Benutzer blockieren
Anforderungsmethode: PUT
Hinweis: Nach der Blockierung können keine Nachrichten mehr gesendet werden und der Benutzer kann ihm nicht wieder folgen, es sei denn, Sie entsperren ihn. Rufen Sie die Blacklist-Schnittstelle auf, anstatt die Löschschnittstelle aufzurufen.
Anfrageadresse: https://wxpusher.zjiecode.com/api/fun/reject
Anforderungsparameter (Abfrage):
Rückgabedaten:
{
"code" : 1000 ,
"msg" : "处理成功" ,
"data" : "删除成功" ,
"success" : true
}Um den schnellen Zugriff zu erleichtern, haben begeisterte Entwickler viele Zugriffs-SDKs beigesteuert, https://github.com/wxpusher/wxpusher-client.
Das SDK wird von Entwicklern beigesteuert und enthält möglicherweise nicht die neueste API oder Funktionen. Die Funktionen unterliegen der HTTP-Schnittstelle in diesem Artikel. Sie können uns auch gerne PR senden.
Minimalistischer Push, keine Notwendigkeit, einen Benutzer zu registrieren, sich beim Backend anzumelden, eine Anwendung zu erstellen, AppToken zu erhalten usw.
Um zu verhindern, dass Benutzer zu viele Konzepte verstehen und den Zugriff erschweren, kann in einigen Szenarien, in denen Benutzer Nachrichten an sich selbst senden , eine minimalistische Push-Methode verwendet werden.
Zum Beispiel: Einige Open-Source-Bestellsysteme für Einkaufszentren senden Nachrichten an Benutzer, nachdem sie Bestellungen aufgegeben haben. Bisher mussten Benutzer Anwendungen erstellen, AppTokens erhalten, Anwendungen folgen, UIDs eingeben usw. Für normale Benutzer gilt: die kosten waren zu hoch.
Für den minimalistischen Push sind nur zwei Schritte erforderlich, um den Push abzuschließen:
Scannen Sie einfach den QR-Code unten, um Ihr Push-SPT zu erhalten
Wenn Sie diesen QR-Code in Ihrem System anzeigen müssen, können Sie den folgenden permanenten Link verwenden:
<textarea readonly style="width:100%;height:60px;"> https://wxpusher.zjiecode.com/api/qrcode/RwjGLMOPTYp35zSYQr0HxbCPrV9eU0wKVBXU1D5VVtya0cQXEJWPjqBdW3gKLifS.jpg </textarea>Bitte lassen Sie SPT nicht durchsickern. Nachdem SPT durchgesickert ist, kann Ihnen jeder Benutzer Nachrichten senden! ! !
Einfaches Senden einer GET-Anfrage
Geben Sie die SPT, die Sie im vorherigen Schritt erhalten haben, in den untenstehenden Link ein
Direkte Anfrage: https://wxpusher.zjiecode.com/api/send/message/Die von Ihnen erhaltene SPT/der Inhalt, den Sie senden möchten
Einfaches Versenden von POST-Anfragen
Anfragemethode: POST
Anforderungs-URL: https://wxpusher.zjiecode.com/api/send/message/simple-push
Anforderungsformat: Content-Type:application/json
Inhalt anfordern:
//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 " ,
}
Bitte beachten Sie: Nur Methode eins (Standard-Push) unterstützt Rückrufe
Wenn ein Benutzer einer Anwendung folgt oder eine Befehlsnachricht an ein offizielles Konto sendet, sendet WxPusher die Nachricht an Sie. Wenn Sie keinen Hintergrunddienst haben, können Sie auch ein Rotationstraining durchführen. Weitere Informationen finden Sie in der Benutzer-UID-Benutzeroberfläche zum Abfragen von QR-Codes.
Um eine Nachricht an einen Benutzer zu senden, müssen Sie die UID des Benutzers kennen. Es gibt zwei Möglichkeiten, die UID des Benutzers zu erfahren:
{
"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 " //用户扫描带参数的二维码，二维码携带的参数。扫描默认二维码为空
}
}Bei Messaging-Produkten müssen Entwickler möglicherweise den Status des kostenpflichtigen Abonnements des Benutzers kennen, nachdem der Benutzer bezahlt oder eine Rückerstattung geleistet hat.
Wenn sich der Status des kostenpflichtigen Abonnements des Benutzers ändert, werden Sie daher über die folgende Rückrufnachricht benachrichtigt. Wenn Sie die Benachrichtigung erhalten, können Sie die Ablaufzeit des Abonnements des Benutzers und andere Informationen abfragen, indem Sie die Benutzerliste V2 abfragen.
{
"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
}
}Derzeit unterstützt WxPusher bereits Upstream-Nachrichten des Befehlstyps. Wenn der Benutzer einen Befehl sendet, ruft WxPusher die Befehlsnachricht an den Entwickler zurück.
Standardrichtlinie
Das Format des Befehls ist: #{appID} content . Um eine Nachricht an das Demoprogramm zu senden, können Sie Folgendes senden: #97 test Beachten Sie, dass sich in der Mitte ein Leerzeichen befindet.
Abonnementanweisungen
Wenn Sie nur appID: #{appID} senden, zum Beispiel: #97, und danach kein Inhalt steht, bedeutet das, dass Sie der Anwendung mit appID 97 Aufmerksamkeit schenken.
Vereinfachte Anleitung
Wenn Sie nur den Inhalt senden: xxx, zum Beispiel: Starten Sie den Server neu. Diese Zeit ist in zwei Situationen unterteilt:
Die App-ID kann im Verwaltungshintergrund, Anwendungsverwaltung-Anwendungsinformationen-Anwendungs-ID, angezeigt werden.
Der Rückruf verwendet die POST-Methode und das Datenformat ist wie folgt:
{
"action" : " send_up_cmd " , //动作，send_up_cmd 表示上行消息回调，后期可能会添加其他动作，请做好兼容。
"data" :{
"uid" : " UID_xxx " , //用户uid
"appId" : 97 , //应用id
"appName" : " WxPusher演示" , //应用名称
"time" : 1603002697386 , //发生时间
"content" : "内容" //用户发送的内容
}
}Bitte beachten Sie: Nur Methode eins (Standard-Push) unterstützt das Aufladen von Nachrichtenprodukten
Bitte beachten Sie, dass sich diese Gebühr auf Folgendes bezieht: Nachrichtenentwickler, die Nachrichtenempfängern über WxPusher Gebühren in Rechnung stellen, und nicht, dass WxPusher Entwicklern oder Benutzern Gebühren in Rechnung stellt.
Als Entwickler sind Sie dafür verantwortlich, wertvolle Informationen bereitzustellen, und wir sind dafür verantwortlich, Ihnen dabei zu helfen, Geld zu verdienen.
Der Zugriffsprozess ist wie folgt:
Nachrichtenprodukte sind Pakete aus einzeln versendeten Anwendungsnachrichten und gruppenweise versendeten Themennachrichten, die zum Verkauf in ein Nachrichtenprodukt gepackt werden können.
Bitte beachten Sie, dass wir derzeit keine Strategieempfehlungsnachrichten zu Aktien, Optionen, Anleihen, Fonds usw. akzeptieren.
Sie müssen auf ein Konzept achten. Wenn die Ressourcen beispielsweise im Allgemeinen in großen Mengen gesendet werden, werden sie eins zu eins über die UID gesendet. sie sind an den Antrag gebunden.
Bitte beachten Sie, dass das aktuelle Produkt keine Änderungen nach der Erstellung unterstützt. Bitte füllen Sie es vor dem Absenden deutlich aus.
Nach der Einreichung wenden Sie sich bitte an den WeChat-Kundendienst „wxpusher-kefu“, um die Zahlungspreisstrategie zu überprüfen und auszuhandeln. Nach der Fertigstellung kann es auf den Nachrichtenmarkt gestellt werden und Benutzer können direkt auf dem Nachrichtenmarkt bezahlen und kaufen.
| veranschaulichen | Nachrichtenmarkt | Messaging-Produktliste | Einführung in das Nachrichtenprodukt |
|---|---|---|---|
| Beispiel |  |  |  |
Benutzerinformationen können durch Abfragen der Benutzerliste V2 abgefragt werden, wobei payEndTime die Ablaufzeit des Abonnements des Benutzers ist.
Beim Senden einer Nachricht an eine als Produkt verpackte Anwendung oder ein Theme können Sie unterscheiden, ob diese Nachricht nur von Benutzern innerhalb des kostenpflichtigen Abonnementzeitraums empfangen werden kann. Treffen Sie eine Unterscheidung basierend auf dem Feld „VerifyPayType“.
Einzelheiten finden Sie in der Schnittstellenbeschreibung zum Senden von Nachrichten. Wenn dem Nachrichtenprodukt keine Anwendung oder kein Thema zugeordnet ist, ist das Feld „VerifyPayType“ ungültig und muss nicht übergeben werden.
Sie müssen auf ein Konzept achten. Wir verkaufen an Produkte gebundene Ressourcen. Wir fragen also die Ablaufzeit ab, die der Ressource entspricht. Wenn die Nachricht beispielsweise im Allgemeinen in großen Mengen gesendet wird, ist sie an das Thema gebunden. Wenn die Nachricht eins zu eins über die UID gesendet wird, ist sie an die Anwendung gebunden und die Abfrage ist die Ablaufzeit des Abonnementthemas oder Bewerbung.
Anforderungsmethode: GET
Beschreibung: Die Ablaufzeit eines bestimmten Benutzers für eine bestimmte Ressource. Da ein Produkt an mehrere Ressourcen gebunden sein kann, wird ein Array zurückgegeben (im Allgemeinen sind jedoch mehrere Ressourcen nicht gebunden).
Anfrageadresse: https://wxpusher.zjiecode.com/api/product/query-pay-end-time?uid={uid}&prodId={product id}
Parameterbeschreibung:
Antwortparameter:
{
"code": 1000,
"msg": "处理成功",
"data": [
{
"resourceType": 2, //资源类型，1对1uid发送的应用为1，群发主题为2
"resourceID": 123, //应用id或者主题id
"payEndTime": 1737560859272 //用户付费订阅到期时间，毫秒级的时间戳
}
],
"success": true
}
Wenn es sich bei Ihrem Produkt um ein Softwareprodukt handelt, greifen Sie bitte auf die Autorisierung von WxPusher zu, damit Benutzer es nach dem Kauf einfach an die entsprechende Ablaufzeit binden können. Der allgemeine Verifizierungsprozess ist:
Für ein besseres Benutzererlebnis arbeiten wir hart daran, mehr Clients zu entwickeln, um das Benutzererlebnis zu verbessern.
Die Chrome-Erweiterung ist eine Erweiterung, die auf dem Chrome-Browser basiert. Sie unterstützt derzeit Mac- und Windows-Computer. Probieren Sie es aus. Sie können hier https://github.com/wxpusher/wxpusher-chrome-extensions besuchen, um die Browsererweiterung herunterzuladen und zu installieren.
Sie können auch hier vorbeischauen, um die spezifischen Installations- und Nutzungsmethoden anzuzeigen: https://mp.weixin.qq.com/s/zrUdVqrE0odhUTiD7qhWiQ
Da es derzeit auf der Basis der Browser-V2-API entwickelt wird, lässt Google nicht zu, dass es in den Regalen steht. Wir werden es nach der Migration auf V3 in den Chrome Store stellen.
Aufgrund der Inhaltsbeschränkungen von WeChat können Sie für ein besseres Benutzererlebnis gerne den iOS-Apple-Client herunterladen, um Nachrichten für ein besseres Benutzererlebnis zu erhalten. Die Download-Methode ist wie folgt:
Aufgrund inländischer ökologischer Probleme befinden sich Android-Anwendungen noch in der Entwicklung. Es tut uns sehr leid.
WxPusher ist ein kostenloser Push-Dienst. Um allen einen besseren Service zu bieten, gelten hier die systembedingten Datenbeschränkungen.
