>  기사  >  위챗 애플릿  >  미니 프로그램 개발 로그인, 결제, 템플릿 메시지 예시에 대한 자세한 설명

미니 프로그램 개발 로그인, 결제, 템플릿 메시지 예시에 대한 자세한 설명

Y2J
Y2J원래의
2017-05-11 13:29:282551검색

이 글에서는 주로 WeChat 미니 프로그램인 WeChat 로그인, WeChat 결제, 템플릿 메시지를 소개합니다. 이는 특정 참조 가치가 있으며 필요한 경우 자세히 알아볼 수 있습니다.

WeChat 공개 플랫폼은 최근 WeChat 미니 프로그램(WeChat 공개 계정) 기능에 대한 내부 테스트를 조용히 시작했으며, 수많은 개발자와 일반 사용자의 관심을 끌었습니다. 미니 프로그램의 소개는 다음과 같습니다.

wx.login(OBJECT)

로그인 자격 증명을 얻기 위해 인터페이스를 호출합니다( 코드) 그런 다음 사용자의 고유 식별자(openid)와 이 로그인에 대한 세션 키(session_key)를 포함하여 사용자 로그인 상태 정보를 교환합니다. 사용자 데이터 통신의 암호화 및 암호 해독은 세션 키에 따라 다릅니다.

OBJECT 매개변수 설명:

성공 반환 매개변수 설명:

샘플 코드:

//app.js
App({
 onLaunch: function() {
  wx.login({
   success: function(res) {
    if (res.code) {
     //发起网络请求
     wx.request({
      url: 'https://test.com/onLogin',
      data: {
       code: res.code
      }
     })
    } else {
     console.log('获取用户登录态失败!' + res.errMsg)
    }
   }
  });
 }
})

code session_key

를 대신하여 개발자 서버는 로그인 자격 증명 코드를 사용하여 session_key 및 openid를 얻습니다. 여기서 session_key는 사용자 데이터를 암호화하고 서명하는 데 사용되는 키입니다. 애플리케이션의 보안을 위해 session_key는 업로드되어 네트워크에서 손실되어서는 안 됩니다.

인터페이스 주소:

api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code

요청 매개변수

반환 매개변수:

반환 설명:

//正常返回的JSON数据包
{
   "openid": "OPENID",
   "session_key": "SESSIONKEY"
   "expires_in": 2592000
}
//错误时返回JSON数据包(示例为Code无效)
{
  "errcode": 40029,
  "errmsg": "invalid code"
}

로그인 상태 유지

wx.login()을 통해 사용자 로그인 상태를 얻은 후에는 로그인 상태를 유지해야 합니다. 개발자는 session_key 및 openid와 같은 필드를 사용자 식별자 또는 세션 식별자로 직접 사용하지 않도록 주의해야 합니다. 대신 세션 로그인 상태를 직접 전달해야 합니다(로그인 시퀀스 다이어그램 참조). 개발자가 직접 생성한 세션의 경우 보안이 보장되어야 하며 만료 시간을 길게 설정해서는 안 됩니다. 세션이 미니 프로그램 클라이언트로 디스패치된 후 후속 통신을 위해 스토리지에 저장할 수 있습니다.

로그인 순서도

wx.checkSession(OBJECT)

로그인 상태 확인 만료되었습니다

샘플 코드:

wx.checkSession({
 success: function(){
  //登录态未过期
 },
 fail: function(){
  //登录态过期
  wx.login()
 }
})

서명 확인 및 사용자 데이터 암호화 및 복호화

데이터 서명 검증

개방형 인터페이스에서 반환된 사용자 데이터의 보안을 보장하기 위해 WeChat은 일반 텍스트 데이터에 서명합니다. 개발자는 데이터 무결성을 보장하기 위해 비즈니스 요구 사항에 따라 데이터 패킷에 대한 서명 확인을 수행할 수 있습니다.

  • 서명 검증 알고리즘에는 wx.login 로그인 프로세스를 통해 얻은 사용자의 session_key가 포함되며, 애플리케이션 자체 로그인 상태와 대응 관계를 유지합니다.

  • 인터페이스(예: wx.getUserInfo)를 호출하여 데이터를 얻을 때 인터페이스는 rawData와 서명을 동시에 반환합니다. 여기서 서명 = sha1( rawData + session_key )

  • 개발자는 검증을 위해 서명과 rawData를 개발자 서버로 보냅니다. 서버는 사용자의 해당 session_key를 이용하여 동일한 알고리즘으로 서명(signature2)을 계산하고, 서명(signature)과 서명2(signature2)를 비교하여 데이터의 무결성을 검증한다.

예를 들어 wx.getUserInfo의 데이터 확인:

인터페이스에서 반환된 rawData:

{
 "nickName": "Band",
 "gender": 1,
 "language": "zh_CN",
 "city": "Guangzhou",
 "province": "Guangdong",
 "country": "CN",
 "avatarUrl": "http://wx.qlogo.cn/mmopen/vi_32/1vZvI39NWFQ9XM4LtQpFrQJ1xlgZxx3w7bQxKARol6503Iuswjjn6nIGBiaycAjAtpujxyzYsrztuuICqIM5ibXQ/0"
}

사용자의 세션 키:

HyVFkGl5F5OQWJZZaNzBBg==

그래서 서명에 사용된 문자열 은 다음과 같습니다.

{
 "nickName": "Band",
 "gender": 1,
 "language": "zh_CN",
 "city": "Guangzhou",
 "province": "Guangdong",
 "country": "CN",
 "avatarUrl": "http://wx.qlogo.cn/mmopen/vi_32/1vZvI39NWFQ9XM4LtQpFrQJ1xlgZxx3w7bQxKARol6503Iuswjjn6nIGBiaycAjAtpujxyzYsrztuuICqIM5ibXQ/0"
}HyVFkGl5F5OQWJZZaNzBBg==

sha1을 사용하여 얻은 결과는

75e81ceda165f4ffa64f4068af58c64b8f54b88c

암호화된 데이터 암호 해독 알고리즘

인터페이스에 민감한 데이터(예: wx.getUserInfo의 openId 및 UnionId)가 포함된 경우 삭제 인터페이스의 텍스트 콘텐츠에는 이러한 민감한 데이터가 포함되지 않습니다. 개발자가 중요한 데이터를 확보해야 하는 경우 인터페이스에서 반환된 암호화된 데이터(encryptedData)를 대칭적으로 해독해야 합니다. 복호화 알고리즘은 다음과 같습니다.

  • 대칭 복호화에 사용되는 알고리즘은 AES-128-CBC이며, 데이터는 PKCS#7로 채워집니다.

  • 대칭 복호화의 대상 암호문은 Base64_Decode(encryptedData),

  • 대칭 복호화 비밀 키 aeskey = Base64_Decode(session_key), aeskey는 16바이트

  • 대칭 복호화 알고리즘 초기 벡터 iv가 데이터 인터페이스에 반환됩니다.

微信官方提供了多种编程语言的示例代码(点击下载)。每种语言类型的接口名字均一致。调用方式可以参照示例。

注:此前提供的加密数据(encryptData)以及对应的加密算法将被弃用,请开发者不要再依赖旧逻辑。

用户信息:

### wx.getUserInfo(OBJECT)

获取用户信息,需要先调用 wx.login 接口。

OBJECT参数说明:

success返回参数说明:

示例代码:

wx.getUserInfo({
 success: function(res) {
  var userInfo = res.userInfo
  var nickName = userInfo.nickName
  var avatarUrl = userInfo.avatarUrl
  var gender = userInfo.gender //性别 0:未知、1:男、2:女 
  var province = userInfo.province
  var city = userInfo.city
  var country = userInfo.country
 }
})

encryptedData 解密后为以下 json 结构,详见加密数据解密算法

{
  "appId": "APPID",
  "openId": "OPENID",
  "nickName": "NICKNAME",
  "gender": 1,
  "city": "CITY",
  "province": "PROVINCE",
  "country": "COUNTRY",
  "avatarUrl": "AVATARURL",
  "unionId": "UNIONID"
}

UnionID机制说明:

如果开发者拥有多个移动应用、网站应用、和公众帐号(包括小程序),可通过unionid来区分用户的唯一性,因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号(包括小程序),用户的unionid是唯一的。换句话说,同一用户,对同一个微信开放平台下的不同应用,unionid是相同的。

微信开放平台绑定小程序流程

前提:微信开放平台帐号必须已完成开发者资质认证

开发者资质认证流程:

登录微信开放平台(open.weixin.qq.com) – 帐号中心 – 开发者资质认证

微信支付:

wx.requestPayment(OBJECT)
发起微信支付。

Object参数说明:

示例代码:

wx.requestPayment({
  'timeStamp': '',
  'nonceStr': '',
  'package': '',
  'signType': 'MD5',
  'paySign': '',
  'success':function(res){
  },
  'fail':function(res){
  }
})

基于微信的通知渠道,我们为开发者提供了可以高效触达用户的模板消息能力,以便实现服务的闭环并提供更佳的体验。

模板推送位置:服务通知

模板下发条件:用户本人在微信体系内与页面有交互行为后触发,详见下发条件说明

模板跳转能力:点击查看详情仅能跳转下发模板的该帐号的各个页面

使用说明

获取模板 id

登录mp.weixin.qq.com获取模板,如果没有合适的模板,可以申请添加新模板,审核通过后可使用,详见模板审核说明

页面的 e8b36d49ce73ede15e584e9dd86e79e9 组件,属性report-submit为true时,可以声明为需发模板消息,此时点击按钮提交表单可以获取formId,用于发送模板消息。或者当用户完成支付行为,可以获取prepay_id用于发送模板消息。

调用接口下发模板消息(详见接口说明)

接口说明

1. 获取 access_token

access_token 是全局唯一接口调用凭据,开发者调用各接口时都需使用 access_token,请妥善保存。access_token 的存储至少要保留512个字符空间。access_token 的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的 access_token 失效。

公众平台的 API 调用所需的 access_token 的使用及生成方式说明:

  • 为了保密 appsecrect,第三方需要一个 access_token 获取和刷新的中控服务器。而其他业务逻辑服务器所使用的 access_token 均来自于该中控服务器,不应该各自去刷新,否则会造成 access_token 覆盖而影响业务;

  • 目前 access_token 的有效期通过返回的 expires_in 来传达,目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新新 access_token。在刷新过程中,中控服务器对外输出的依然是老 access_token,此时公众平台后台会保证在刷新短时间内,新老 access_token 都可用,这保证了第三方业务的平滑过渡;

  • access_token 的有效时间可能会在未来有调整,所以中控服务器不仅需要内部定时主动刷新,还需要提供被动刷新 access_token 的接口,这样便于业务服务器在 API 调用获知 access_token 已超时的情况下,可以触发 access_token 的刷新流程。

开发者可以使用 AppID 和 AppSecret 调用本接口来获取 access_token。AppID 和 AppSecret 可登录微信公众平台官网-设置-开发设置中获得(需要已经绑定成为开发者,且帐号没有异常状态)。AppSecret 生成后请自行保存,因为在公众平台每次生成查看都会导致 AppSecret 被重置。注意调用所有微信接口时均需使用 https 协议。如果第三方不使用中控服务器,而是选择各个业务逻辑点各自去刷新 access_token,那么就可能会产生冲突,导致服务不稳定。

接口地址:

api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

HTTP请求方式:

GET

参数说明 :

返回参数说明:

正常情况下,微信会返回下述 JSON 数据包给开发者:

{"access_token": "ACCESS_TOKEN", "expires_in": 7200}

2. 发送模板消息

接口地址:(ACCESS_TOKEN 需换成上文获取到的 access_token)

api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN
HTTP请求方式:

POST

POST参数说明:

示例:

{
 "touser": "OPENID", 
 "template_id": "TEMPLATE_ID", 
 "page": "index",     
 "form_id": "FORMID",     
 "data": {
   "keyword1": {
     "value": "339208499", 
     "color": "#173177"
   }, 
   "keyword2": {
     "value": "2015年01月05日 12:30", 
     "color": "#173177"
   }, 
   "keyword3": {
     "value": "粤海喜来登酒店", 
     "color": "#173177"
   } , 
   "keyword4": {
     "value": "广州市天河区天河路208号", 
     "color": "#173177"
   } 
 },
 "emphasis_keyword": "keyword1.DATA" 
}

返回码说明:

在调用模板消息接口后,会返回JSON数据包。

正常时的返回JSON数据包示例:

{
 "errcode": 0,
 "errmsg": "ok",
}

错误时会返回错误码信息,说明如下:

使用效果:

 注意:内部测试阶段,模板消息下发后,在客户端仅能看到由“公众号安全助手”下发的简单通知。能收到该提示,即表明模板消息功能已经调试成功。待该功能正式上线后,将可以展示成上图效果。

 下发条件说明

1、支付

当用户在小程序内完成过支付行为,可允许开发者向用户在7天内推送有限条数的模板消息(1次支付可下发1条,多次支付下发条数独立,互相不影响)

2、提交表单

当用户在小程序内发生过提交表单行为且该表单声明为要发模板消息的,开发者需要向用户提供服务时,可允许开发者向用户在7天内推送有限条数的模板消息(1次提交表单可下发1条,多次提交下发条数独立,相互不影响)

 审核说明

1.标题

1.1标题不能存在相同

1.2标题意思不能存在过度相似 

1.3标题必须以“提醒”或“通知”结尾

1.4标题不能带特殊符号、个性化字词等没有行业通用性的内容

1.5标题必须能体现具体服务场景

1.6标题不能涉及营销相关内容,包括不限于:

消费优惠类、购物返利类、商品更新类、优惠券类、代金券类、红包类、会员卡类、积分类、活动类等营销倾向通知

2.关键词

2.1同一标题下,关键词不能存在相同

2.2同一标题下,关键词不能存在过度相似

2.3关键词不能带特殊符号、个性化字词等没有行业通用性的内容

2.4关键词内容示例必须与关键词对应匹配

2.5关键词不能太过宽泛,需要具有限制性,例如:“内容”这个就太宽泛,不能审核通过

违规说明

除不能违反运营规范外,还不能违反以下规则,包括但不限于:

  1. 不允许恶意诱导用户进行触发操作,以达到可向用户下发模板目的

  2. 不允许恶意骚扰,下发对用户造成骚扰的模板

  3. 不允许恶意营销,下发营销目的模板

  4. 不允许通过服务号下发模板来告知用户在小程序内触发的服务相关内容

处罚说明

根据违规情况给予相应梯度的处罚,一般处罚规则如下:

  1. 第一次违规,删除违规模板以示警告,

  2. 第二次违规,封禁接口7天,

  3. 세 번째 위반 시 인터페이스가 30일 동안 차단됩니다.

  4. 네 번째 위반 시 인터페이스가 영구적으로 차단됩니다.

벌칙 결과 및 사유는 사이트 내 메시지로 알려드립니다

[관련 추천]

1. WeChat 미니 프로그램 전체 소스 코드

2.

WeChat 미니 프로그램 데모: NetEase Cloud Music 모방

위 내용은 미니 프로그램 개발 로그인, 결제, 템플릿 메시지 예시에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.