网络营销 微信公众平台开发者文档(整理自微信官网)

网络营销 微信公众平台开发者文档(整理 自微信官网) 网络营销 微信公众平台开发者文档(整理 自微信官网) 微信公众平台开发者文档（腾讯官方）微信公众平台开发者文档（腾讯官方） 一、新手接入一、新手接入 11、接入指南11、接入指南 第一步：申请消息接口第一步：申请消息接口 在公众平台网站的高级功能 开发模式页， 点击 “成为开发者” 按钮， 填写 URL 和 Token， 其中 URL 是开发者用来接收微信服务器数据的接口 URL。Token 可由开发者可以任意填写，用作生成签名（该 Token 会和接口 URL 中包含的 Token 进行比对，从而验证安全性）。 第二步：验证 URL 有效性第二步：验证 URL 有效性 开发者提交信息后，微信服务器将发送 GET 请求到填写的 URL 上，GET 请求携带四个参数： 参数描述 signature 微信加密签名， signature 结合了开发者填写的 token 参数和请求中的 timestamp 参数、nonce 参数。 timestamp时间戳 nonce随机数 echostr随机字符串 开发者通过检验 signature 对请求进行校验（下面有校验方式）。若确认此次 GET 请求来自微信服 务器，请原样返回 echostr 参数内容，则接入生效，成为开发者成功，否则接入失败。 加密/校验流程如下： 1. 将 token、timestamp、nonce 三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行 sha1 加密 3. 开发者获得加密后的字符串可与 signature 对比，标识该请求来源于微信 检验 signature 的 PHP 示例代码： private function checkSignature() $signature = $_GETsignature; $timestamp = $_GETtimestamp; $nonce = $_GETnonce; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); sort($tmpArr); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr = $signature ) return true; else return false; PHP 示例代码下载：（如下：） valid(); class wechatCallbackapiTest public function valid() $echoStr = $_GETechostr; /valid signature , option if($this-checkSignature() echo $echoStr; exit; public function responseMsg() /get post data, May be due to the different environments $postStr = $GLOBALSHTTP_RAW_POST_DATA; /extract post data if (!empty($postStr) $postObj = simplexml_load_string($postStr, SimpleXMLElement, LIBXML_NOCDATA); $fromUsername = $postObj-FromUserName; $toUsername = $postObj-ToUserName; $keyword = trim($postObj-Content); $time = time(); $textTpl = %s 0 ; if(!empty( $keyword ) $msgType = text; $contentStr = Welcome to wechat world!; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); echo $resultStr; else echo Input something.; else echo ; exit; private function checkSignature() $signature = $_GETsignature; $timestamp = $_GETtimestamp; $nonce = $_GETnonce; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); sort($tmpArr); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr = $signature ) return true; else return false; ? 第三步：成为开发者第三步：成为开发者 验证 URL 有效性成功后即接入生效，成为开发者。如果公众号类型为服务号（订阅号只能使用普通 消息接口），可以在公众平台网站中申请认证，认证成功的服务号将获得众多接口权限，以满足开 发者需求。 此后用户每次向公众号发送消息、或者产生自定义菜单点击事件时，响应 URL 将得到推送。 公众号调用各接口时，一般会获得正确的结果，具体结果可见对应接口的说明。返回错误时，可根 据返回码来查询错误原因。全局返回码说明 用户向公众号发送消息时，公众号方收到的消息发送者是一个 OpenID，是使用用户微信号加密后的 结果，每个用户对每个公众号有一个唯一的 OpenID。 此外请注意，微信公众号接口只支持 80 接口微信公众号接口只支持 80 接口。 12、典型案例介绍12、典型案例介绍 值得借鉴的公众帐号主要是服务号，试列举并介绍如下： 招商银行信用卡中心招商银行信用卡中心 如果你是持卡人，可快捷查询信用卡账单、额度及积分；快速还款、申请账单分期；微信转接人工 服务；信用卡消费，微信免费笔笔提醒。如果不是持卡人，可以微信办卡！ 招商银行公众号通过提示消息引导用户将自己的微信号和信用卡号安全绑定。 用户可以通过该公众号查询账单、收取刷卡通知等功能，这是由招行开发人员通过公众号接口实现的功能。 中国南方航空中国南方航空 你可以办理值机手续，挑选座位，查询航班信息，查询目的地城市天气，并为明珠会员提供专业的 服务。 南方航空公众号可以让用户将明珠会员服务和微信号绑定起来。 用户可以通过该公众号预订机票、查询订单，甚至办理登机牌。 广东联通广东联通 你可以在微信里绑定手机号、积分流量，套餐余量、手机上网流量，微信专属流量查询，客服咨询。 广东联通公众号可以绑定手机号，来查询流量、套餐等等功能。 广东联通更与微信深度合作，购买微信沃卡可以获得微信五大特权。 13 开发者规范13 开发者规范 开发者进行公众号开发时，除了需要满足每个接口的规范限制、调用频率限制外，还需特别注意模 版消息、用户数据等敏感信息的使用规范。 涉及用户数据时：涉及用户数据时： 您的服务需要收集用户任何数据的，必须事先获得用户的明确同意，且仅应当收集为运营及功 能实现目的而必要的用户数据， 同时应当告知用户相关数据收集的目的、范围及使用方式等， 保障用户知情权。 您收集用户的数据后，必须采取必要的保护措施，防止用户数据被盗、泄漏等。 您在特定微信公众号中收集的用户数据仅可以在该特定微信公众号中使用，不得将其使用在该 特定微信公众号之外或为其他任何目的进行使用，也不得以任何方式将其提供给他人。 如果腾讯认为您收集、使用用户数据的方式，可能损害用户体验，腾讯有权要求您删除相关数 据并不得再以该方式收集、使用用户数据。 一旦您停止使用本服务，或腾讯基于任何原因终止您使用本服务，您必须立即删除全部因使用 本服务而获得的数据（包括各种备份）， 且不得再以任何方式进行使用。 其他规范：其他规范： 请勿为任何用户自动登录到微信公众平台提供代理身份验证凭据。 请勿提供跟踪功能，包括但不限于识别其他用户在个人主页上查看、点击等操作行为。 请勿自动将浏览器窗口定向到其他网页。 请勿设置或发布任何违反相关法规、公序良俗、社会公德等的玩法、内容等。 请勿公开表达或暗示，您与腾讯之间存在合作关系，包括但不限于相互持股、商业往来或合作 关系等，或声称腾讯对您的认可。 完整的开发者规范和接口限制，请详见开发者接口文档，以及腾讯微信公众平台开发者协议。 二、基础支持二、基础支持 21 获取 access token21 获取 access token ccess_token 是公众号的全局唯一票据，公众号调用各接口时都需使用 access_token。正常情况下 access_token 有效期为 7200 秒access_token 有效期为 7200 秒，重复获取将导致上次获取的 access_token 失效。 公众号可以使用 AppID 和 AppSecret 调用本接口来获取 access_token。AppID 和 AppSecret 可在开 发模式中获得（需要已经成为开发者，且帐号没有异常状态）。注意调用所有微信接口时均需使用 https 协议。 注意调用所有微信接口时均需使用 https 协议。 接口调用请求说明接口调用请求说明 http 请求方式: GET filename=MEDIA_ID.jpg Date: Sun, 06 Jan 2013 10:20:18 GMT Cache-Control: no-cache, must-revalidate Content-Length: 339721 curl -G $timestamp = $_GETtimestamp; $nonce = $_GETnonce; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); sort($tmpArr); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr = $signature ) return true; else return false; PHP 示例代码下载：【如下】 valid(); class wechatCallbackapiTest public function valid() $echoStr = $_GETechostr; /valid signature , option if($this-checkSignature() echo $echoStr; exit; public function responseMsg() /get post data, May be due to the different environments $postStr = $GLOBALSHTTP_RAW_POST_DATA; /extract post data if (!