wxpusher docs
1.0.0
WxPusher (WeChat 푸시 서비스)는 WeChat 공개 계정을 채널로 사용하는 실시간 정보 푸시 플랫폼으로, 추가 소프트웨어를 설치하지 않고도 API를 호출하여 실시간 정보 알림을 달성할 수 있습니다. WxPusher를 사용하여 서버 알람 알림, 수업 러시 알림, 티켓 러시 알림, 정보 업데이트 프롬프트 등을 만들 수 있습니다.
데모 프로그램에 액세스하여 기능을 경험할 수 있습니다: https://wxpusher.zjiecode.com/demo/
데모 프로그램 소스 코드: https://github.com/wxpusher/wxpusher-sdk-java/
관리 배경: https://wxpusher.zjiecode.com/admin/
데모 프로그램을 호출하여 사용자에게 직접 메시지를 보내지 않도록 주의해주세요! ! !
WeChat 인터페이스가 오프라인으로 직접 전송되는 방식이 조정되었습니다. 새로운 푸시 방식을 개발 중이니 계속 지켜봐 주시기 바랍니다.
| 유형 | 사용자 ID 받기 | 템플릿 메시지 | |||
|---|---|---|---|---|---|
| 시사 |  |  |  |  |  |
다양한 사용자 그룹과 다양한 사용 시나리오를 통해 보다 빠르고 편리하게 메시지를 보낼 수 있도록 현재 WxPusher를 사용하는 두 가지 방법을 지원합니다.
- 이 두 가지 전송 방법은 서로 다른 식별 표시를 가지며 서로 마이그레이션하거나 전환할 수 없습니다.
- 가능하다면 더 나은 기능을 위해 첫 번째 방법을 사용하는 것이 좋습니다.
| 전송 방법 | 장점, 단점 및 적용 가능한 시나리오 |
|---|---|
| 표준 푸시 [권장] (표준 애플리케이션 개발) |
|
| 미니멀리스트 푸시(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 코드 링크와 그래픽은 변경되지 않고 마음대로 사용할 수 있습니다.
애플리케이션의 ID 토큰은 개발자 본인만 알 수 있습니다. APP_TOKEN을 사용하면 해당 애플리케이션의 사용자에게 메시지를 보낼 수 있으므로 엄격하게 기밀로 유지하고 github와 같은 곳으로 보내지 마세요.
WeChat 사용자 로고는 사용자에게 단독으로 메시지를 보낼 때 어떤 사용자에게 메시지를 보내야 하는지를 나타내는 데 사용됩니다.
접속하기 전, 단일 전송과 그룹 전송의 차이점을 이해하는 데 도움이 되는 아키텍처 다이어그램을 살펴보세요. 
https://wxpusher.zjiecode.com/admin/, WeChat을 사용하여 QR 코드를 스캔하여 로그인하세요. 등록이 필요하지 않으며 처음으로 QR 코드를 스캔하면 신규 사용자가 자동으로 등록됩니다.
아래와 같이 애플리케이션을 생성합니다.
콜백 주소: 꼭 기재하지 않아도 됩니다. 기재하지 않으면 사용자가 팔로우할 때 콜백이 발생하지 않습니다. 콜백 설명을 참고하세요.
URL 설정: 입력할 필요가 없습니다. 입력한 후 사용자는 WeChat에서 "내 구독"을 열고 이 주소로 직접 이동할 수 있으며 사용자 정의 페이지 표시를 용이하게 하기 위해 uid가 매개변수로 전달됩니다.
연락처 정보: 꼭 입력할 필요는 없습니다. 사용자에게 연락 방법과 피드백 제공 방법을 알려주세요.
프롬프트 따르기: 사용자가 애플리케이션 코드를 따르거나 스캔할 때 사용자에게 전송되는 프롬프트입니다. 이를 입력할 필요가 없습니다. Wxpusher는 기본 복사본을 제공합니다. 사용자가 콜백에 주의를 기울이고 UID를 제공하면 사용자에게 미리 알림 메시지를 적극적으로 푸시할 수도 있습니다.
설명: 애플리케이션과 애플리케이션이 푸시하는 콘텐츠를 설명합니다. 사용자는 링크를 따라가거나 WeChat에서 볼 때 해당 애플리케이션을 볼 수 있습니다.
애플리케이션을 생성하는 과정에서 appToken을 확인해야 합니다. 저장되지 않은 경우 다음 방법으로 재현할 수 있습니다.
애플리케이션 https://wxpusher.zjiecode.com/admin/의 백엔드를 열고 왼쪽 메뉴 표시줄에서 appToken 메뉴를 찾으세요. 여기에서 appToken을 재설정할 수 있습니다. 재설정 후에는 이전 appToken이 무효화된다는 점에 유의하세요. 즉시 인터페이스 호출이 실패합니다.
애플리케이션을 만든 후 애플리케이션 코드를 확인하고 애플리케이션 링크를 따라갈 수 있습니다. 애플리케이션을 팔로우한 후 사용자에게 메시지를 보낼 수 있습니다.
현재 UID를 얻는 방법에는 3가지가 있습니다.
UID를 얻은 후 애플리케이션의 appToken을 일치시킨 다음 전송 인터페이스를 호출하여 메시지를 보냅니다.
모든 인터페이스는 이미 https를 지원합니다.
POST 인터페이스 POST 인터페이스는 완전한 기능을 갖춘 인터페이스이며 사용이 권장됩니다.
콘텐츠 유형:응용 프로그램/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 인터페이스는 주로 일부 경우 호출의 편의를 위한 것입니다(예: contentType=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 콘텐츠 및 URL에 대해 urlEncode 인코딩을 수행하세요.
GET 인터페이스는 uid 또는 topicId 전송만 지원합니다. POST 인터페이스를 사용하는 것이 좋습니다.
메시지는 Wxpusher로 전송되며 캐시된 후 백그라운드에서 WeChat으로 비동기적으로 푸시된 후 사용자에게 배포됩니다. 메시지 수가 많을 경우 메시지 전송 상태를 여기로 쿼리할 수 있습니다. 메시지를 보내 반환된 sendRecordId를 기반으로 하는 사용자입니다.
요청 방법: GET
참고: 메시지 상태를 쿼리하세요. 메시지 캐시는 시간에 민감합니다. 현재 캐시 시간은 7일로 설정되어 있습니다. 7일 후에 메시지를 쿼리하면 메시지가 존재하지 않는다고 반환될 수 있습니다.
요청 주소: https://wxpusher.zjiecode.com/api/send/query/status?sendRecordId={sendRecordId}
매개변수 설명:
요청 방법: DELETE
참고: 메시지가 전송된 후 보조 인터페이스를 호출하여 메시지를 삭제할 수 있습니다. 단, 사용자가 세부정보를 보기 위해 클릭한 랜딩 페이지만 사용자에게 푸시된 메시지 기록은 삭제할 수 없습니다. 삭제됩니다.
요청 주소: https://wxpusher.zjiecode.com/api/send/message?messageContentId=${messageContentId}&appToken=${appToken}
매개변수 설명:
예를 들어, 사용자가 팔로우하기 위해 코드를 스캔한 경우 포럼 게시물에 새 메시지가 있는 경우 QR 코드를 스캔한 사람을 알아야 합니다. 포럼 사용자 ID를 입력하고 Wxpusher 사용자의 UID에 바인딩합니다. 포럼 사용자 ID에서 새 메시지가 있으면 Wxpusher 사용자에게 푸시됩니다. 이 시나리오에는 매개변수가 포함된 QR 코드가 필요합니다.
요청 방법: POST
요청 주소: https://wxpusher.zjiecode.com/api/fun/create/qrcode
콘텐츠 유형: 애플리케이션/json
설명: 매개변수가 포함된 QR 코드를 생성합니다. 사용자가 코드를 스캔하면 콜백에 매개변수가 포함됩니다.
요청 본문:
{
"appToken" : " xxx " , //必填，appToken,前面有说明，应用的标志
"extra" : " xxx " , //必填，二维码携带的参数，最长64位
"validTime" : 1800 //可选，二维码的有效期，默认30分钟，最长30天，单位是秒
}
사용자가 매개변수 QR 코드를 스캔하고 콜백 주소를 설정한 후 콜백 주소를 통해 사용자의 UID를 서비스에 푸시합니다. 자세한 내용은 콜백 방법을 사용하는 것이 좋습니다.
그러나 일부 사용자 시나리오는 간단하거나 클라이언트 소프트웨어와 같은 백엔드 서비스가 없어 사용이 매우 불편하므로 위의 생성 매개변수 QR 코드 인터페이스를 통해 이 쿼리 인터페이스를 추가했습니다. , 그러면 이 인터페이스와 함께 이 코드를 사용하여 매개변수 QR 코드를 마지막으로 스캔한 사용자의 UID를 쿼리할 수 있습니다.
훈련 간격은 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을 제출하실 수도 있습니다.
미니멀리스트 푸시, 사용자 등록, 백엔드에 로그인, 애플리케이션 생성, appToken 획득 등이 필요하지 않습니다.
사용자가 너무 많은 개념을 이해하여 접근을 어렵게 만드는 것을 방지하기 위해 사용자가 자신에게 메시지를 보내는 일부 시나리오 에서는 최소한의 푸시 방법을 사용할 수 있습니다.
예를 들어, 일부 오픈 소스 쇼핑몰 주문 시스템은 주문 후 SMS 전달 시스템 등을 통해 사용자에게 메시지를 보냅니다. 이전에는 사용자가 애플리케이션 생성, appToken 획득, 애플리케이션 팔로우, UID 입력 등을 수행해야 했습니다. 비용이 너무 높았습니다.
미니멀리스트 푸시에는 푸시를 완료하는 데 2단계만 필요합니다.
푸시 SPT를 받으려면 아래 QR 코드를 스캔하세요.
시스템에 이 QR 코드를 표시해야 하는 경우 다음 영구 링크를 사용할 수 있습니다.
<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 요청 전송
요청 방법: 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 " ,
}
참고: 방법 1(표준 푸시)만 콜백을 지원합니다.
사용자가 애플리케이션을 팔로우하거나 공식 계정으로 명령 메시지를 보내면 WxPusher가 해당 메시지를 사용자에게 푸시합니다. 백그라운드 서비스가 없는 경우 회전 훈련을 수행할 수도 있습니다. 쿼리 스캔 QR 코드 사용자 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: #{appID} (예: #97)만 보내고 그 뒤에 내용이 없다면 appID 97을 사용하는 애플리케이션에 주의를 기울이고 있다는 의미입니다.
단순화된 지침
콘텐츠: xxx만 보내는 경우(예: 서버 다시 시작) 이 시간은 두 가지 상황으로 나뉩니다.
appID는 관리백그라운드, 애플리케이션관리-애플리케이션정보-애플리케이션ID에서 확인할 수 있습니다.
콜백은 POST 메서드를 사용하며 데이터 형식은 다음과 같습니다.
{
"action" : " send_up_cmd " , //动作，send_up_cmd 表示上行消息回调，后期可能会添加其他动作，请做好兼容。
"data" :{
"uid" : " UID_xxx " , //用户uid
"appId" : 97 , //应用id
"appName" : " WxPusher演示" , //应用名称
"time" : 1603002697386 , //发生时间
"content" : "内容" //用户发送的内容
}
}참고: 첫 번째 방법(표준 푸시)만 메시지 제품 충전을 지원합니다.
이 요금은 WxPusher가 개발자나 사용자에게 요금을 부과하는 것이 아니라 WxPusher를 통해 메시지 수신자에게 요금을 부과하는 메시지 개발자를 의미합니다.
개발자로서 귀하는 귀중한 정보를 제공할 책임이 있고, 우리는 귀하가 돈을 벌 수 있도록 도울 책임이 있습니다.
액세스 프로세스는 다음과 같습니다.
메시지 상품은 단일 발송 애플리케이션 메시지와 그룹 발송 주제 메시지의 패키지로, 여러 메시지를 하나의 메시지 상품으로 묶어 판매할 수 있습니다.
현재 주식, 옵션, 채권, 펀드 등에 대한 전략 추천 뉴스는 받지 않으니 참고하시기 바랍니다.
우리가 판매하는 것은 제품에 바인딩된 리소스입니다. 예를 들어 리소스가 일반적으로 대량으로 전송되는 경우 uid를 통해 일대일로 전송되면 테마에 바인딩됩니다. 그들은 응용 프로그램에 바인딩됩니다.
현재 제품은 제작 후 수정을 지원하지 않으니, 반드시 정확하게 기재하신 후 제출해주시기 바랍니다.
제출 후 결제 가격 전략에 대한 검토 및 협상을 위해 고객 서비스 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 컴퓨터를 지원하므로 메시지 수신 환경이 WeChat보다 좋습니다. https://github.com/wxpusher/wxpusher-chrome-extensions를 방문하여 브라우저 확장 프로그램을 다운로드하고 설치할 수 있습니다.
여기를 방문하여 구체적인 설치 및 사용 방법을 볼 수도 있습니다: https://mp.weixin.qq.com/s/zrUdVqrE0odhUTiD7qhWiQ
현재 브라우저 V2 API를 기반으로 개발되었기 때문에 Google에서는 V3로 마이그레이션한 후 Chrome 스토어에 올릴 예정입니다.
WeChat의 콘텐츠 제한으로 인해 더 나은 사용자 경험을 위해 iOS Apple 클라이언트를 다운로드하여 더 나은 사용자 경험을 위한 메시지를 수신하실 수 있습니다.
국내 안드로이드 생태학적 문제로 인해 안드로이드 애플리케이션은 아직 개발 중입니다.
WxPusher는 모든 사람에게 더 나은 서비스를 제공하기 위해 다음과 같은 시스템 관련 데이터 제한 사항을 제공하는 무료 푸시 서비스입니다.
