ホームページ > 記事 > バックエンド開発 > WeChat決済開発 (7) 受信アドレス共有インターフェースV2

WeChat決済開発 (7) 受信アドレス共有インターフェースV2

WBOYオリジナル: 2016-06-13 12:29:281240ブラウズ

WeChat 決済開発 (7) 受信アドレス共有インターフェース V2

キーワード: WeChat パブリックプラットフォーム JSSDK 友達に送信受信アドレス共有インターフェース openAddress
著者: Fangbei Studio
原文: http://www. cnblogs.com/txw1958/p/weixin-openaddress.html

この WeChat パブリックプラットフォーム開発チュートリアルでは、Web ページに実装する方法を紹介します。アドレス機能。

配送先住所共有インターフェースは、2016 年 4 月 13 日にアップグレードされました。2016 年 5 月 20 日からは、新しいインターフェースのみが使用可能になります。このチュートリアルは、インターフェースの新しいバージョンのチュートリアルです！

この記事は次の 2 つの部分に分かれています:

JS-SDK 権限検証署名の生成
共有配送先アドレスの取得の実装

1. WeChat JS-SDK

1. アクセストークンの取得

アクセストークンの取得方法は前述しました。 , 詳細については、「WeChat パブリックプラットフォームの開発 (26) アクセストークン

2. jsapi_ticket

を取得する」を参照してください。署名を生成する前に、jsapi_ticket がパブリックアカウントによって呼び出される一時的なチケットであることを理解する必要があります。 WeChat JS インターフェース。通常の状況では、access_token によって取得される jsapi_ticket の有効期間は 7200 秒です。 jsapi_ticket を取得するための API 呼び出しの数は非常に限られているため、jsapi_ticket を頻繁に更新すると API 呼び出しが制限され、開発者は jsapi_ticket を独自のサービスでグローバルにキャッシュする必要があります。

access_token を取得するには、次のドキュメントを参照してください (有効期間は 7200 秒、開発者は access_token を独自のサービスでグローバルにキャッシュする必要があります):
最初の手順で取得した access_token を使用し、http GET メソッドを使用してリクエストしますjsapi_ticket (有効期間は 7200 秒)、開発者は jsapi_ticket を独自のサービスでグローバルにキャッシュする必要があります)、インターフェイスアドレスは次のとおりです

https:<span style="color: #008000;">//</span><span style="color: #008000;">api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi</span>

正常に次の JSON が返されます。

<span style="color: #000000;">{    </span><span style="color: #800000;">"</span><span style="color: #800000;">errcode</span><span style="color: #800000;">"</span>:<span style="color: #800080;">0</span><span style="color: #000000;">,    </span><span style="color: #800000;">"</span><span style="color: #800000;">errmsg</span><span style="color: #800000;">"</span>:<span style="color: #800000;">"</span><span style="color: #800000;">ok</span><span style="color: #800000;">"</span><span style="color: #000000;">,    </span><span style="color: #800000;">"</span><span style="color: #800000;">ticket</span><span style="color: #800000;">"</span>:<span style="color: #800000;">"</span><span style="color: #800000;">bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA</span><span style="color: #800000;">"</span><span style="color: #000000;">,    </span><span style="color: #800000;">"</span><span style="color: #800000;">expires_in</span><span style="color: #800000;">"</span>:<span style="color: #800080;">7200</span><span style="color: #000000;">}</span>

jsapi_ticket を取得した後、JS-SDK 権限検証用の署名を生成できます。

3. 署名アルゴリズムの実装

署名の生成ルールは次のとおりです。署名に含まれるフィールドには、noncestr (ランダムな文字列)、有効な jsapi_ticket、timestamp (タイムスタンプ)、url (ファイルの URL) が含まれます。現在の Web ページ)、# とそれに続く部分を除く)。署名されるすべてのパラメータをフィールド名の ASCII コードに従って小さいものから大きいもの (辞書順) に並べ替えた後、URL キーと値のペアの形式 (つまり、key1=value1&key2=value2...) を使用してそれらを連結します。文字列 string1。ここで、パラメータ名はすべて小文字であることに注意してください。 string1 に対して sha1 暗号化を実行し、フィールド名とフィールド値には元の値を使用し、URL エスケープは実行しません。

つまり、signature=sha1(string1)です。例:

noncestr=<span style="color: #000000;">Wm3WZYTPz0wzccnWjsapi_ticket</span>=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-<span style="color: #000000;">HhTdfl2fzFy1AOcHKP7qgtimestamp</span>=<span style="color: #800080;">1414587457</span><span style="color: #000000;">url</span>=http:<span style="color: #008000;">//</span><span style="color: #008000;">mp.weixin.qq.com?params=value</span>

ステップ 1. フィールド名の ASCII コードに従って、署名されるすべてのパラメーターを小さいものから大きいもの (辞書順) に並べ替えた後、次を使用します。 URL のキーと値のペアの形式 (つまり、key1=value1&key2=value2...) は文字列 string1 に結合されます:

jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW&timestamp=<span style="color: #800080;">1414587457</span>&url=http:<span style="color: #008000;">//</span><span style="color: #008000;">mp.weixin.qq.com?params=value</span>

ステップ2. string1 に sha1 で署名し、署名を取得します。

0f9de62fce790f9a083d5c99e95740ceb90c27ed

完全なコードは次のとおりです

<?<span style="color: #000000;">php</span><span style="color: #0000ff;">class</span><span style="color: #000000;"> JSSDK {  </span><span style="color: #0000ff;">private</span> <span style="color: #800080;">$appId</span><span style="color: #000000;">;  </span><span style="color: #0000ff;">private</span> <span style="color: #800080;">$appSecret</span><span style="color: #000000;">;  </span><span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __construct(<span style="color: #800080;">$appId</span>, <span style="color: #800080;">$appSecret</span><span style="color: #000000;">) {    </span><span style="color: #800080;">$this</span>->appId = <span style="color: #800080;">$appId</span><span style="color: #000000;">;    </span><span style="color: #800080;">$this</span>->appSecret = <span style="color: #800080;">$appSecret</span><span style="color: #000000;">;  }  </span><span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span><span style="color: #000000;"> getSignPackage() {    </span><span style="color: #800080;">$jsapiTicket</span> = <span style="color: #800080;">$this</span>-><span style="color: #000000;">getJsApiTicket();    </span><span style="color: #008000;">//</span><span style="color: #008000;"> 注意 URL 一定要动态获取，不能 hardcode.</span>    <span style="color: #800080;">$protocol</span> = (!<span style="color: #0000ff;">empty</span>(<span style="color: #800080;">$_SERVER</span>['HTTPS']) && <span style="color: #800080;">$_SERVER</span>['HTTPS'] !== 'off' || <span style="color: #800080;">$_SERVER</span>['SERVER_PORT'] == 443) ? "https://" : "http://"<span style="color: #000000;">;    </span><span style="color: #800080;">$url</span> = "<span style="color: #800080;">$protocol$_SERVER</span>[HTTP_HOST]<span style="color: #800080;">$_SERVER</span>[REQUEST_URI]"<span style="color: #000000;">;    </span><span style="color: #800080;">$timestamp</span> = <span style="color: #008080;">time</span><span style="color: #000000;">();    </span><span style="color: #800080;">$nonceStr</span> = <span style="color: #800080;">$this</span>-><span style="color: #000000;">createNonceStr();    </span><span style="color: #008000;">//</span><span style="color: #008000;"> 这里参数的顺序要按照 key 值 ASCII 码升序排序</span>    <span style="color: #800080;">$string</span> = "jsapi_ticket=<span style="color: #800080;">$jsapiTicket</span>&noncestr=<span style="color: #800080;">$nonceStr</span>&timestamp=<span style="color: #800080;">$timestamp</span>&url=<span style="color: #800080;">$url</span>"<span style="color: #000000;">;    </span><span style="color: #800080;">$signature</span> = <span style="color: #008080;">sha1</span>(<span style="color: #800080;">$string</span><span style="color: #000000;">);    </span><span style="color: #800080;">$signPackage</span> = <span style="color: #0000ff;">array</span><span style="color: #000000;">(      </span>"appId"     => <span style="color: #800080;">$this</span>->appId,      "nonceStr"  => <span style="color: #800080;">$nonceStr</span>,      "timestamp" => <span style="color: #800080;">$timestamp</span>,      "url"       => <span style="color: #800080;">$url</span>,      "signature" => <span style="color: #800080;">$signature</span>,      "rawString" => <span style="color: #800080;">$string</span><span style="color: #000000;">    );    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$signPackage</span><span style="color: #000000;">;   }  </span><span style="color: #0000ff;">private</span> <span style="color: #0000ff;">function</span> createNonceStr(<span style="color: #800080;">$length</span> = 16<span style="color: #000000;">) {    </span><span style="color: #800080;">$chars</span> = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"<span style="color: #000000;">;    </span><span style="color: #800080;">$str</span> = ""<span style="color: #000000;">;    </span><span style="color: #0000ff;">for</span> (<span style="color: #800080;">$i</span> = 0; <span style="color: #800080;">$i</span> < <span style="color: #800080;">$length</span>; <span style="color: #800080;">$i</span>++<span style="color: #000000;">) {      </span><span style="color: #800080;">$str</span> .= <span style="color: #008080;">substr</span>(<span style="color: #800080;">$chars</span>, <span style="color: #008080;">mt_rand</span>(0, <span style="color: #008080;">strlen</span>(<span style="color: #800080;">$chars</span>) - 1), 1<span style="color: #000000;">);    }    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$str</span><span style="color: #000000;">;  }  </span><span style="color: #0000ff;">private</span> <span style="color: #0000ff;">function</span><span style="color: #000000;"> getJsApiTicket() {    </span><span style="color: #008000;">//</span><span style="color: #008000;"> jsapi_ticket 应该全局存储与更新，以下代码以写入到文件中做示例</span>    <span style="color: #800080;">$data</span> = json_decode(<span style="color: #008080;">file_get_contents</span>("jsapi_ticket.json"<span style="color: #000000;">));    </span><span style="color: #0000ff;">if</span> (<span style="color: #800080;">$data</span>->expire_time < <span style="color: #008080;">time</span><span style="color: #000000;">()) {      </span><span style="color: #800080;">$accessToken</span> = <span style="color: #800080;">$this</span>-><span style="color: #000000;">getAccessToken();      </span><span style="color: #008000;">//</span><span style="color: #008000;"> 如果是企业号用以下 URL 获取 ticket      // $url = "https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token=$accessToken";</span>      <span style="color: #800080;">$url</span> = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?type=jsapi&access_token=<span style="color: #800080;">$accessToken</span>"<span style="color: #000000;">;      </span><span style="color: #800080;">$res</span> = json_decode(<span style="color: #800080;">$this</span>->httpGet(<span style="color: #800080;">$url</span><span style="color: #000000;">));      </span><span style="color: #800080;">$ticket</span> = <span style="color: #800080;">$res</span>-><span style="color: #000000;">ticket;      </span><span style="color: #0000ff;">if</span> (<span style="color: #800080;">$ticket</span><span style="color: #000000;">) {        </span><span style="color: #800080;">$data</span>->expire_time = <span style="color: #008080;">time</span>() + 7000<span style="color: #000000;">;        </span><span style="color: #800080;">$data</span>->jsapi_ticket = <span style="color: #800080;">$ticket</span><span style="color: #000000;">;        </span><span style="color: #800080;">$fp</span> = <span style="color: #008080;">fopen</span>("jsapi_ticket.json", "w"<span style="color: #000000;">);        </span><span style="color: #008080;">fwrite</span>(<span style="color: #800080;">$fp</span>, json_encode(<span style="color: #800080;">$data</span><span style="color: #000000;">));        </span><span style="color: #008080;">fclose</span>(<span style="color: #800080;">$fp</span><span style="color: #000000;">);      }    } </span><span style="color: #0000ff;">else</span><span style="color: #000000;"> {      </span><span style="color: #800080;">$ticket</span> = <span style="color: #800080;">$data</span>-><span style="color: #000000;">jsapi_ticket;    }    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$ticket</span><span style="color: #000000;">;  }  </span><span style="color: #0000ff;">private</span> <span style="color: #0000ff;">function</span><span style="color: #000000;"> getAccessToken() {    </span><span style="color: #008000;">//</span><span style="color: #008000;"> access_token 应该全局存储与更新，以下代码以写入到文件中做示例</span>    <span style="color: #800080;">$data</span> = json_decode(<span style="color: #008080;">file_get_contents</span>("access_token.json"<span style="color: #000000;">));    </span><span style="color: #0000ff;">if</span> (<span style="color: #800080;">$data</span>->expire_time < <span style="color: #008080;">time</span><span style="color: #000000;">()) {      </span><span style="color: #008000;">//</span><span style="color: #008000;"> 如果是企业号用以下URL获取access_token      // $url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=$this->appId&corpsecret=$this->appSecret";      <span style="color: #800080;">$url</span> = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=<span style="color: #800080;">$this</span>->appId&secret=<span style="color: #800080;">$this</span>->appSecret"<span style="color: #000000;">;      </span><span style="color: #800080;">$res</span> = json_decode(<span style="color: #800080;">$this</span>->httpGet(<span style="color: #800080;">$url</span><span style="color: #000000;">));      </span><span style="color: #800080;">$access_token</span> = <span style="color: #800080;">$res</span>-><span style="color: #000000;">access_token;      </span><span style="color: #0000ff;">if</span> (<span style="color: #800080;">$access_token</span><span style="color: #000000;">) {        </span><span style="color: #800080;">$data</span>->expire_time = <span style="color: #008080;">time</span>() + 7000<span style="color: #000000;">;        </span><span style="color: #800080;">$data</span>->access_token = <span style="color: #800080;">$access_token</span><span style="color: #000000;">;        </span><span style="color: #800080;">$fp</span> = <span style="color: #008080;">fopen</span>("access_token.json", "w"<span style="color: #000000;">);        </span><span style="color: #008080;">fwrite</span>(<span style="color: #800080;">$fp</span>, json_encode(<span style="color: #800080;">$data</span><span style="color: #000000;">));        </span><span style="color: #008080;">fclose</span>(<span style="color: #800080;">$fp</span><span style="color: #000000;">);      }    } </span><span style="color: #0000ff;">else</span><span style="color: #000000;"> {      </span><span style="color: #800080;">$access_token</span> = <span style="color: #800080;">$data</span>-><span style="color: #000000;">access_token;    }    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$access_token</span><span style="color: #000000;">;  }  </span><span style="color: #0000ff;">private</span> <span style="color: #0000ff;">function</span> httpGet(<span style="color: #800080;">$url</span><span style="color: #000000;">) {    </span><span style="color: #800080;">$curl</span> =<span style="color: #000000;"> curl_init();    curl_setopt(</span><span style="color: #800080;">$curl</span>, CURLOPT_RETURNTRANSFER, <span style="color: #0000ff;">true</span><span style="color: #000000;">);    curl_setopt(</span><span style="color: #800080;">$curl</span>, CURLOPT_TIMEOUT, 500<span style="color: #000000;">);    curl_setopt(</span><span style="color: #800080;">$curl</span>, CURLOPT_SSL_VERIFYPEER, <span style="color: #0000ff;">false</span><span style="color: #000000;">);    curl_setopt(</span><span style="color: #800080;">$curl</span>, CURLOPT_SSL_VERIFYHOST, <span style="color: #0000ff;">false</span><span style="color: #000000;">);    curl_setopt(</span><span style="color: #800080;">$curl</span>, CURLOPT_URL, <span style="color: #800080;">$url</span><span style="color: #000000;">);    </span><span style="color: #800080;">$res</span> = curl_exec(<span style="color: #800080;">$curl</span><span style="color: #000000;">);    curl_close(</span><span style="color: #800080;">$curl</span><span style="color: #000000;">);    </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$res</span><span style="color: #000000;">;  }}</span>

2. 受信アドレス共有インターフェース

1. はじめに

WeChat の配信アドレス共有とは、ユーザーが WeChat ブラウザーで Web ページを開き、アドレスを入力することを意味します。後続の手順を入力せずにすぐに選択でき、追加や編集も可能です。このアドレスはユーザー属性であり、さまざまな販売者の Web ページで共有できます。住所を入力するネイティブコントロールをサポートすると、住所データが販売者に渡されます。

アドレス共有は WeChat JavaScript API に基づいており、WeChat 内蔵ブラウザでのみ使用でき、他のブラウザからの呼び出しは無効です。同時に、これをサポートするには WeChat バージョン 5.0 が必要です。アドレスインターフェイスを呼び出す前に、ユーザーエージェントを使用してユーザーの現在のバージョン番号を確認することをお勧めします。 iPhone のバージョンを例に挙げると、useragent を通じて次の WeChat バージョン例の情報を取得できます。「Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS」。ユーザーがインストールした WeChat のバージョン番号について、販売者は、バージョン番号は 5.0 以上です。

住所形式
WeChat アドレス共有に使用されるデータフィールドには次が含まれます:

荷受人名
地域、省、市の 3 つのレベル
詳細住所
郵便番号
連絡先番号

このうち、地域は「広東省-広州市-天河区」、対応する郵便番号は 510630 です。詳細については、リンクを参照してください: http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116_501070.html

2. バインドドメイン名

最初のログWeChatパブリックプラットフォームへの「公式アカウント設定」の「機能設定」に「JSインターフェースセキュリティドメイン名」を入力します。

3. 署名パッケージを取得します

<?<span style="color: #000000;">php</span><span style="color: #0000ff;">require_once</span> "jssdk.php"<span style="color: #000000;">;</span><span style="color: #800080;">$jssdk</span> = <span style="color: #0000ff;">new</span> JSSDK("yourAppID", "yourAppSecret"<span style="color: #000000;">);</span><span style="color: #800080;">$signPackage</span> = <span style="color: #800080;">$jssdk</span>-><span style="color: #000000;">GetSignPackage();</span>?>

4. JS ファイルを導入します

必要なインターフェイスページでは、次の JS ファイルが紹介されています:

特記事項: JS-SDK バージョンには http://res.wx.qq.com/open/js/jweixin-1.1 が必要です。 .0 .js

<span style="color: #0000ff;"><</span><span style="color: #800000;">script </span><span style="color: #ff0000;">src</span><span style="color: #0000ff;">="http://res.wx.qq.com/open/js/jweixin-1.1.0.js"</span><span style="color: #0000ff;">></</span><span style="color: #800000;">script</span><span style="color: #0000ff;">></span>

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

所有需要使用JS-SDK的页面必须先注入配置信息，否则将无法调用。

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

5. 通过ready接口处理成功验证

需要在页面加载时就调用，需要把相关接口放在ready函数中调用来确保正确执行

wx.ready(<span style="color: #0000ff;">function</span><span style="color: #000000;"> () {});</span>

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

<span style="color: #000000;"> wx.checkJsApi({                jsApiList: [                    </span>'openAddress'<span style="color: #000000;">,                ],                success: </span><span style="color: #0000ff;">function</span><span style="color: #000000;"> (res) {                    alert(JSON.stringify(res));                }            });</span>

5.3. 实现收货地址共享

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

返回说明

返回值	说明
errMsg	获取编辑收货地址成功返回“openAddress:ok”。
userName	收货人姓名。
postalCode	邮编。
provinceName	国标收货地址第一级地址（省）。
cityName	国标收货地址第二级地址（市）。
countryName	国标收货地址第三级地址（国家）。
detailInfo	详细收货地址信息。
nationalCode	收货地址国家码。