微信支付开发(7) 收货地址共享接口V2

重点字:微信公众平台 JSSDK 发送给情人 收货地址共享接口 openAddress 
笔者:方倍工作室 
原文:http://www.cnblogs.com/txw1958/p/weixin-openaddress.html

 

以马上篇微信公众平台支付教程被,我们用介绍如何当网页遭到落实获取收货地址的法力。

收货地址共享接口 在2016年4月13日
进行了升级,2016年5月20日只得用新接口,本课程为新版接口的教程!

正文分为以下二单部分:

  1. 生成JS-SDK权限验证签名
  2. 落实获取共享收货地址

 

 

一、微信JS-SDK

1. 获得Access Token

access token的取得艺术在头里来介绍,详情见 微信公众平台开发(26) ACCESS
TOKEN

2. 获取jsapi_ticket

浮动签名之前务必先行了解一下jsapi_ticket,jsapi_ticket是民众号用于调用微信JS接口的临时票据。正常情形下,jsapi_ticket的有效期为7200秒,通过access_token来获得。由于获得jsapi_ticket的api调用次数非常少,频繁刷新jsapi_ticket会招api调用受限,影响自己工作,开发者必须在大团结之服务大局缓存jsapi_ticket

参照以下文档获取access_token(有效期7200秒,开发者必须以协调之劳动全局缓存access_token):
据此第一步将到的access_token 采用http
GET方式要获得jsapi_ticket(有效期7200秒,开发者必须在大团结的服务大局缓存jsapi_ticket),接口地址如下

https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi

马到成功返回如下JSON:

{
    "errcode":0,
    "errmsg":"ok",
    "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
    "expires_in":7200
}

获得jsapi_ticket之后,就可以生成JS-SDK权限验证的签字了。

3. 签约算法实现

签署生成规则如下:参与签署的字段包括noncestr(随机字符串),
有效的jsapi_ticket, timestamp(时间穿),
url(当前网页的URL,不包含#随同背后有)
。对所有待签名参数按照字段名的ASCII
码从小到非常排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1。这里用注意的是具有参数叫作全为稍写字符。对string1发sha1加密,字段名和许段值都应用原始值,不开展URL
转义。

即signature=sha1(string1)。 示例:

noncestr=Wm3WZYTPz0wzccnW
jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg
timestamp=1414587457
url=http://mp.weixin.qq.com?params=value

步骤1. 针对所有待签名参数按照字段名的ASCII
码从小到非常排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1:

jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW&timestamp=1414587457&url=http://mp.weixin.qq.com?params=value

步骤2.
对string1进行sha1签名,得到signature:

0f9de62fce790f9a083d5c99e95740ceb90c27ed

整体代码如下

<?php
class JSSDK {
  private $appId;
  private $appSecret;

  public function __construct($appId, $appSecret) {
    $this->appId = $appId;
    $this->appSecret = $appSecret;
  }

  public function getSignPackage() {
    $jsapiTicket = $this->getJsApiTicket();

    // 注意 URL 一定要动态获取,不能 hardcode.
    $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off' || $_SERVER['SERVER_PORT'] == 443) ? "https://" : "http://";
    $url = "$protocol$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";

    $timestamp = time();
    $nonceStr = $this->createNonceStr();

    // 这里参数的顺序要按照 key 值 ASCII 码升序排序
    $string = "jsapi_ticket=$jsapiTicket&noncestr=$nonceStr&timestamp=$timestamp&url=$url";

    $signature = sha1($string);

    $signPackage = array(
      "appId"     => $this->appId,
      "nonceStr"  => $nonceStr,
      "timestamp" => $timestamp,
      "url"       => $url,
      "signature" => $signature,
      "rawString" => $string
    );
    return $signPackage; 
  }

  private function createNonceStr($length = 16) {
    $chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
    $str = "";
    for ($i = 0; $i < $length; $i++) {
      $str .= substr($chars, mt_rand(0, strlen($chars) - 1), 1);
    }
    return $str;
  }

  private function getJsApiTicket() {
    // jsapi_ticket 应该全局存储与更新,以下代码以写入到文件中做示例
    $data = json_decode(file_get_contents("jsapi_ticket.json"));
    if ($data->expire_time < time()) {
      $accessToken = $this->getAccessToken();
      // 如果是企业号用以下 URL 获取 ticket
      // $url = "https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token=$accessToken";
      $url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?type=jsapi&access_token=$accessToken";
      $res = json_decode($this->httpGet($url));
      $ticket = $res->ticket;
      if ($ticket) {
        $data->expire_time = time() + 7000;
        $data->jsapi_ticket = $ticket;
        $fp = fopen("jsapi_ticket.json", "w");
        fwrite($fp, json_encode($data));
        fclose($fp);
      }
    } else {
      $ticket = $data->jsapi_ticket;
    }

    return $ticket;
  }

  private function getAccessToken() {
    // access_token 应该全局存储与更新,以下代码以写入到文件中做示例
    $data = json_decode(file_get_contents("access_token.json"));
    if ($data->expire_time < time()) {
      // 如果是企业号用以下URL获取access_token
      // $url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=$this->appId&corpsecret=$this->appSecret";
      $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$this->appId&secret=$this->appSecret";
      $res = json_decode($this->httpGet($url));
      $access_token = $res->access_token;
      if ($access_token) {
        $data->expire_time = time() + 7000;
        $data->access_token = $access_token;
        $fp = fopen("access_token.json", "w");
        fwrite($fp, json_encode($data));
        fclose($fp);
      }
    } else {
      $access_token = $data->access_token;
    }
    return $access_token;
  }

  private function httpGet($url) {
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_TIMEOUT, 500);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($curl, CURLOPT_URL, $url);

    $res = curl_exec($curl);
    curl_close($curl);

    return $res;
  }
}

 

老二、收货地址共享接口

一. 简介

微信收货地址共享,是赖用户以微信浏览器内打开网页,填写了地方后,后续可以免填写支持快选择,也可是长与编制。此地点为用户属性,可每当各级商户的网页中共享使用。支持原生控件填写地址,地址数据会传递及贾。

地点共享是根据微信JavaScript API
实现,只能以微信内置浏览器被利用,其他浏览器调用无效。同时,需要微信5.0
版本才能够支撑,建议经user agent
来规定用户眼前之版本号后再行调用地址接口。以iPhone
版本也例,可以由此useragent可得到如下微信版本示例信息:”Mozilla/5.0(iphone;CPU
iphone OS 5_1_1 like Mac OS X)AppleWebKit/534.46(KHTML,like Geocko)
Mobile/9B206MicroMessenger/5.0″其中5.0
为用户安装的微信版本号,商户可看清版本号是否超过或者当5.0。

地址格式
微信地址共享应用的数码字段包括:

  • 收货人姓名
  • 地段,省购买区三级
  • 详尽地址
  • 邮编
  • 联系电话

内部,地区针对承诺是国标三级地区码,如“广东省-广州市-天河区”,对应的邮政编码是是510630。详情参见链接:http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116\_501070.html

2. 绑定域名

先期登录微信公众平台上“公众号安装”的“功能设置”里填充“JS接口安全域名”。

3. 到手签名包

<?php
require_once "jssdk.php";
$jssdk = new JSSDK("yourAppID", "yourAppSecret");
$signPackage = $jssdk->GetSignPackage();
?>

4. 引入JS文件

以待调用JS接口的页面引入如下JS文件:

特别注意:JS-SDK版本要采取http://res.wx.qq.com/open/js/jweixin-1.1.0.js

<script src="http://res.wx.qq.com/open/js/jweixin-1.1.0.js"></script>

5.经过config接口注入权限验证配置

拥有需要采用JS-SDK的页面必须优先注入配置信息,否则用无法调用。

        <script>
          wx.config({
            debug: false,
            appId: '<?php echo $signPackage["appId"];?>',
            timestamp: <?php echo $signPackage["timestamp"];?>,
            nonceStr: '<?php echo $signPackage["nonceStr"];?>',
            signature: '<?php echo $signPackage["signature"];?>',
            jsApiList: [
              // 所有要调用的 API 都要加到这个列表中
                'checkJsApi',
                'openAddress',
              ]
          });
        </script>

5.
经ready接口处理成验证

待以页面加载时即调用,需要把有关接口放在ready函数中调用来担保对实施

wx.ready(function () {
});

5.1 通过checkJsApi判断时客户端版本是否支持分享参数自定义

 

 wx.checkJsApi({
                jsApiList: [
                    'openAddress',
                ],
                success: function (res) {
                    alert(JSON.stringify(res));
                }
            });  

5.3. 落实收货地址共享

 

            wx.openAddress({
              trigger: function (res) {
                alert('用户开始拉出地址');
              },
              success: function (res) {
                alert('用户成功拉出地址');
                alert(JSON.stringify(res));
                document.form1.address1.value         = res.provinceName;
                document.form1.address2.value         = res.cityName;
                document.form1.address3.value         = res.countryName;
                document.form1.detail.value           = res.detailInfo;
                document.form1.national.value         = res.nationalCode;
                document.form1.user.value            = res.userName;
                document.form1.phone.value            = res.telNumber;
                document.form1.postcode.value         = res.postalCode;
                document.form1.errmsg.value         = res.errMsg;
                document.form1.qq.value             = 1354386063;
              },
              cancel: function (res) {
                alert('用户取消拉出地址');
              },
              fail: function (res) {
                alert(JSON.stringify(res));
              }
            });

 

回说明

返回值

说明

errMsg

获取编辑收货地址成功返回“openAddress:ok”。

userName

收货人姓名。

postalCode

邮编。

provinceName

国标收货地址第一级地址(省)。

cityName

国标收货地址第二级地址(市)。

countryName

国标收货地址第三级地址(国家)。

detailInfo

详细收货地址信息。

nationalCode

收货地址国家码。

 

其三、实现力量

    

 

相关文章