微信开发详细教程

时间 2019-11-29

标签微信开发详细教程繁體版

原文原文链接

1、准备工做html

a) 帐号api

在SAE上面注册一个帐号。
在微信公众号开发平台地址 https://mp.weixin.qq.com 注册一个微信公众号。

注意：1、我的只能申请到我的类型的订阅号。数组

2、微信公众号认证须要300大洋。安全

申请公众号测试号地址

http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index服务器

2、微信公众帐号介绍微信

服务号、订阅号、企业号的介绍（区别） 微信公众平台

一、订阅号：主要偏于为用户传达资讯（相似报纸杂志），认证先后都是天天只能够群发一条消息；curl

二、服务号：主要偏于服务交互（相似银行，114，提供服务查询），认证先后都是每月可群发4条消息；post

三、企业号：主要用于公司内部通信使用，须要先有成员的通信信息验证才能够关注成功企业号；测试

舒适提示：

一、若是想简单的发送消息，达到宣传效果，建议可选择订阅号；

二、若是想进行商品销售，进行商品售卖，建议可申请服务号；

三、若是想用来管理内部企业员工、团队，对内使用，可申请企业号。

3、微信数据收发原理以及消息数据格式

3、1 开发者模式成为开发者时的消息校验原理

开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，而且带上四个参数(signature、timestamp、nonce、echostr)，开发者经过对签名(signature)的检验，来判断此条信息的真实性。

验证成功以后，开发者接受用户消息的时候，微信也都会带上前面三个参数(signature、timestamp、nonce)访问开发者设置的URL，开发者依然经过签名的校验判断消息的真实性。

加密/校验流程以下：

1. 将token、timestamp、nonce三个参数进行字典序排序

2. 将三个参数字符串拼接成一个字符串进行sha1加密

3. 开发者得到加密后的字符串可与signature对比，标识该请求来源于微信

3、2 成为开发者后消息收发的原理

微信消息收发原理图：

其实，咱们须要作的事情，就是对HTTP请求，作出响应。也就是拿到微信服务器给咱们的数据，而后处理后再返回去。

上图的消息收发过程是这样的：用户用手机发送一个?给微信公众号，微信服务器接受到? 而后组装一个消息发送给咱们本身的服务器，咱们的服务器回复一个时间，而且将时间也按照必定的规则组装，回复给公众号，公众号所在的服务器再回复给用户。

4、接入指南

接入微信公众号平台开发，须要按照以下步骤：

一、填写服务器配置

二、验证服务器地址的有效性

三、依据接口文档实现业务逻辑

第一步：填写服务器配置

进入微信公众平台https://mp.weixin.qq.com

在左侧列表中最下方，找到基本配置，点击进入

点击启用，若是编辑模式开启了。那就先把编辑模式关闭。

点击“修改配置”按钮，按照要求填写。

参数说明：

其中URL是开发者用来接收微信消息和事件的接口URL。

Token是开发者任意填写的，可是填写的要与代码中的一致。Token是用做签名(填写的Token会和接口URL中包含的Token进行对比，从而验证安全性),Token是为了用来验证发送咱们的信息是否来自微信服务器。

第二步：验证服务器地址的有效性

开发者提供信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带四个参数：

开发者经过检验signature对请求进行校验。若确认这次GET请求来自微信服务器，须要原样返回echostr参数的内容。这样就接入成功了，不然接入失败。

接入的代码以下：

//得到参数 signature nonce token timestamp echostr

$nonce = $_GET['nonce'];

$token = 'imooc';

$timestamp = $_GET['timestamp'];

$echostr = $_GET['echostr'];

$signature = $_GET['signature'];

//第一步：造成数组，而后按字典序排序

$array = array();

$tmpArr= array($nonce, $timestamp, $token);

sort($tmpArr,SORT_STRING);

//第二步：拼接成字符串,sha1加密，而后与signature进行校验

$str = sha1( implode( $tmpArr ) );

//第三步：得到加密后的字符串与signature对比

if( $str == $signature && $echostr ){

//第一次接入weixin api接口的时候

echo $echostr;

exit;

}

第三部：依据接口文档实现业务逻辑

验证URL有效性后即接入生效，成为开发者。

经历过第一次验证后，此后用户每次向公众号发送消息、或者产生自定义菜单点击事件时，开发者填写的服务器配置URL将获得微信服务器推送过来的消息和事件，而后开发者能够依据自身业务逻辑进行相应，例如回复消息等。

其余须要知道的：

一、用户向公众号发送消息时，公众号收到的消息发送者是一个OpenID，每一个用户对每一个公众号有一个惟一的OpenID。

二、微信公众号接口只支持80端口

5、接受普通消息

当普通微信用户向微信公众帐号发消息时，微信服务器将POST消息的XML数据发送到咱们本身的服务器上，也就是咱们在微信公众平台填写的URL

普通消息有：文本消息、图片消息、语言消息、视频消息、地理位置消息。

接受文本消息的XML格式

<xml>

</xml>

当微信服务器接受到用户发送的消息，微信服务器再把这条消息经过XML格式组装后，发送给咱们的服务器。那么，若是咱们想要回复文本消息。咱们也须要把消息经过XML格式组装好发送给微信服务器，微信服务器再发送给用户。

回复文本消息的XML格式：

<xml>

</xml>

实例代码：

注意，$toUser 是指将这个消息返回给谁。由于咱们是将消息回复给用户的，因此

$toUser = $this->postObj->FromUserName;//获取到发送消息给微信公众号的用户openId

素材管理

新增临时素材

公众号常常须要用到一些临时性的多媒体素材的场景，例如在使用接口特别是发送消息时，对多媒体文件、多媒体消息的获取和调用等操做，是经过media_id来进行的。素材管理接口对全部认证的订阅号和服务号开发。经过本接口，公众号能够新增一些临时素材（即上传临时多媒体文件）。

请注意：

1、对于临时素材，每一个素材（media_id）会在开发者上传或粉丝发送到微信服务器3天后自动删除（因此用户发送给开发者的素材，若开发者须要，应尽快下载到本地），以节省服务器资源。

2、media_id是可复用的。

3、素材的格式大小等要求与公众平台官网一致。具体是，图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式，语音大小不超过2M，长度不超过60秒（公众平台官网能够在文章中插入小于30分钟的语音，但这些语音不能用于群发等场景，只能放在文章内，这方面接口暂不支持），支持mp3/wma/wav/amr格式

4、需使用https调用本接口。

调用接口地址

https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

其余须要注意的问题：

一、文件上传时经过CURL POST方式提交的，POST内容须要是数组格式。

二、上传的文件必须先在你的服务器，而后获取到上传文件所在服务器的绝对路径。而且须要在绝对路径前面加上@以示区分。

三、在Window服务上，路径分隔符为斜杠\，例子：@D:\soft\logo.jpg

而在Linux服务器上，路径分隔符为反斜杠/ 例子：@/tmp/logo.jpg

代码示例：

获取临时素材

公众号可使用本接口从微信服务器下载临时的多媒体素材。

接口调用URL

http请求方式: GET,https调用

https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
media_id	是	媒体文件ID

返回说明

正确状况下的返回HTTP头以下：

HTTP/1.1 200 OK

Connection: close

Content-Type: image/jpeg

Content-disposition: attachment; filename="MEDIA_ID.jpg"

Date: Sun, 06 Jan 2013 10:20:18 GMT

Cache-Control: no-cache, must-revalidate

Content-Length: 339721

curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

发送消息

发送客服消息

当用户主动发消息给公众号的时候（包括发送信息、点击自定义菜单、订阅事件、扫描二维码事件），微信将会把消息数据推送给开发者，开发者在一段时间内能够调用客服消息接口，经过POST一个JSON数据包来发送消息给普通用户，在48小时内不限制发送次数。此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。

调用的接口URL

https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

具体参考文档http://mp.weixin.qq.com/wiki/7/12a5a320ae96fecdf0e15cb06123de9f.html

至于为何须要客服接口呢？

由于微信公众平台一直没有推出手机客服端，除了程序的自动应答，运营者还须要一些人工回复，而人工回复目前通常都是经过电脑端操做，有了客服接口可使运营者使用手机回复。

获取用户基本信息

在关注者与公众号产生消息交互后，公众号可得到关注者的OpenID（加密后的微信号，每一个用户对每一个公众号的OpenID是惟一的。对于不一样公众号，同一用户的openid不一样）。公众号可经过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。