公众平台开发者文档V3.0重点.docx

公众平台开发者文档 （高级版）版本号V2.0公众平台开发部2014年10月 开发者文档（高级版）权限说明公众平台为高级版开发者提供全部接口权限及服务能力：开发者申请基础能力接口用户管理接口菜单管理接口接收消息接口发送消息接口开发者申请开发者申请流程成为公众平台开发者，要完成以下申请流程注册开通公众帐号：注册方法：在Web Portal首页点击注册，按注册流程提供相应的手机号及其他注册认证资料。通过人工审核后即可开通公众帐号。准备接口URL：开发者需要提供URL作为数据接收交互的接口地址，在注册填写URL之前，先要在URL地址页面程序里加入验证代码，代码如下：（验证完毕可以删除）if (isset($_POST[echostr])){echo $_POST[echostr];exit();}申请开发者模式：点击公众平台导航栏【开放平台】，进入公众开放平台首页，选择启用开发者模式，填写相关信息内容并提交。填写内容包括URL、Token、和IP白名单。验证URL有效性：开发者提交信息后，公众平台服务器将发送POST请求到填写的URL上，开发者通过检验signature对请求进行校验。若确认此次POST请求来自公众平台服务器，开发者需原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。分配开发者ID和密钥：URL校验通过后，系统自动为开发者分配开发者ID和密钥。开发者模式启用成功。开发者信息说明开发者信息包括以下内容开发者ID：即AppID，系统自动分配给开发者的ID开发者密钥：即AppSecret，系统分配给开发者的随机密钥URL：由开发者填写生成，URL是开发者用来接收公众平台服务器数据的接口URL，所提供的URL地址必须可访问，且响应时间需在5秒以内。提交信息时，平台会校验URL地址的有效性。需http开头，仅支持80端口Token：由开发者填写生成，可由开发者任意填写3-32位字母数字组成的字符串，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。IP白名单：由开发者填写生成，用于开发者采用调取接口回复消息模式时，允许访问开放接口的IP地址。开发者模式启用成功后，编辑模式自动关闭，不支持通过Web Portal进行消息收发的功能。公众账号用户可申请恢复编辑模式。开发者帐号AppID是开发者的唯一标识，开发者帐号与公众帐号一一对应。AppID和开发者后台填写的token将作为接口调用的基本凭证。如何验证URL有效性开发者提交信息后，公众平台服务器将发送POST请求到填写的URL上，POST请求携带四个参数：参数说明signature加密签名，Signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。timestamp时间戳nonce随机数echostr随机字符串开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次POST请求来自公众平台服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验流程如下：1、将token、timestamp、nonce三个参数进行字典序排序2、将三个参数字符串拼接成一个字符串进行sha1加密3、开发者获得加密后的字符串可与signature对比，标识该请求来源于公众平台开发者原理说明验证URL有效性成功后即接入生效，成为开发者。此后用户每次向公众号发送消息、或者产生自定义菜单点击事件时，响应URL将得到推送。公众号调用各接口时，一般会获得正确的结果，具体结果可见对应接口的说明。返回错误时，可根据返回码来查询错误原因。用户向公众号发送消息时，公众号方收到的消息发送者是一个OpenID，是使用用户ID加密后的结果，每个用户对每个公众号有一个唯一的OpenID。公众平台只支持80接口开放接口说明接口资料返回码说明返回码说明-1系统繁忙0请求成功40001获取access_token时AppSecret错误，或者access_token无效40002不合法的凭证类型40003不合法的OpenID40005不合法的文件类型40006不合法的文件大小40007不合法的媒体文件id40008不合法的消息类型40014不合法的access_token40016不合法的按钮个数40017不合法的按钮类型40018不合法的按钮名字长度40019不合法的按钮KEY长度40020不合法的按钮URL长度40023不合法的子菜单按钮个数40024不合法的子菜单按钮类型40025不合法的子菜单按钮名字长度40026不合法的子菜单按钮KEY长度40027不合法的子菜单按钮URL长度40031不合法的openid列表40032不合法的openid列表长度40040文件