公众平台开发者文档V3.0讲述.docx

公众平台开发者文档 （高级版） 版本号V2.0 公众平台开发部 2014年10月 目录  TOC \o 1-3 \h \z \u  HYPERLINK \l _Toc401044819 1. 产品需求设计  PAGEREF _Toc401044819 \h 2  HYPERLINK \l _Toc401044820 1.1. 开放平台  PAGEREF _Toc401044820 \h 2  HYPERLINK \l _Toc401044821 1.1.1. 开发者申请  PAGEREF _Toc401044821 \h 2  HYPERLINK \l _Toc401044822 1.1.2. 开放接口说明  PAGEREF _Toc401044822 \h 4  HYPERLINK \l _Toc401044823 1.1.3. 开发者权限设定  PAGEREF _Toc401044823 \h 59  HYPERLINK \l _Toc401044824 1.1.4. Web Portal开放平台设计  PAGEREF _Toc401044824 \h 61  HYPERLINK \l _Toc401044825 2. 附录  PAGEREF _Toc401044825 \h 61  HYPERLINK \l _Toc401044826 2.1. 参数总表  PAGEREF _Toc401044826 \h 61  HYPERLINK \l _Toc401044827 2.2. 典型案例介绍  PAGEREF _Toc401044827 \h 62  HYPERLINK \l _Toc401044828 2.3. 融合通信接口规范中定义的返回码说明  PAGEREF _Toc401044828 \h 62  开发者文档（高级版）权限说明 公众平台为高级版开发者提供全部接口权限及服务能力： 开发者申请 基础能力接口 用户管理接口 菜单管理接口 接收消息接口 发送消息接口 开发者申请 开发者申请流程 成为公众平台开发者，要完成以下申请流程 注册开通公众帐号：注册方法：在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参数、no