图书馆微信公众号API接口开发分析

　　摘要：图书馆微信公众平台使用率高, 软件接口丰富, 内容可视化强。通过数据特征分析、模拟HTTP请求、全局唯一票据管理等关键技术和方法, 研究创建微信公众平台自定义菜单、设置系统命令字、接收消息、分析消息数据、发送客服消息、操作业务数据库、发送被动响应消息、网页授权获取用户信息及群发信息等功能, 进一步开发图书馆自助服务微信公众平台。通过链接微信公众平台API接口, 实现图书馆微信公众平台与读者进行消息交互的功能, 使图书馆自助服务微信公众平台作为图书馆泛在化服务系统的重要组成部分。

　　关键词：图书馆服务; 微信公众平台; API;

　　Abstract：Library' s wechat public platform has high utilization rat, rich software interface and strong visual content.Through data characteristic analysis, simulation of HTTP requests and the only global bill management and other key technologies and methods, this paper created public the custom menu, set up the system command words, received and analyzed messages, and sent customer service message, operated databases, sent passive response message, obtain user information and sending information authorized by web page, and further developed the wechat platform service platform. Through the link between wechat public platform and API interface, it achieved the interaction of library' s wechat public platform and the readers, which made the self-service of library wechat public platform as an important part of library' s ubiquitous service system.

　　Keyword：library service; wechat public platform; API;

　　截止2016年底, 微信每月活跃用户已达到6.66亿[1], 成为用户最多的移动即时通讯软件。微信团队积极推出微信公众平台, 这一功能更是受到众多机构、企业的追捧, 国内的图书馆相继开通微信平台, 用于推送、分享馆内信息, 实现馆员与读者的实时交流, 并且通过微信平台提供图书馆各项服务[2]。与移动图书馆相比, 微信公众平台用户覆盖面大, 使用率高, 在开发模式下, 微信公众平台为开发者提供了更丰富的程序接口, 开发者可以结合图书馆的各项业务调用这些接口, 利用微信公众平台开发微信服务程序, 为图书馆用户提供更深入、更细化的服务。图书馆微信成为图书馆与读者交流、为读者服务的新的交互式服务平台[3]。
 

　　1、设计方案

　　1.1、调查高校读者对图书馆微信平台自助服务的需求并进行数据分析

　　针对高校图书馆读者用户对图书馆微信公众平台的接受程度进行调查, 了解读者对微信的使用率和对图书馆利用微信提供各项服务功能的接受度, 充分考虑图书馆现有咨询途径和用户的使用习惯。

　　1.2、构建高校图书馆自助服务微信平台的总体实施框架

　　通过数据分析比对, 确立图书馆自助服务微信平台的建设目标, 构建高校图书馆自助服务微信平台的总体实施框架。通过对图书馆人工、自助咨询服务的分析, 建立起完善的图书馆基本问题知识库, 确保涵盖读者可能遇到的各种具有共性的问题。为了使用户方便地了解图书馆微信自助服务的使用方式, 图书馆还应考虑关键词和用户操作指令的设置。准确全面的关键词和清晰明了的指令索引是将知识库中的丰富内容提供给读者利用的前提。

　　1.3、对图书馆自助服务微信平台各模块进行程序开发

　　以PHP程序设计语言为基础, 在图书馆微信公众平台的开发模式下搭建图书馆微信公众平台的API接口, 采用数据特征分析、模拟HTTP请求、全局唯一票据管理等关键技术和方法, 研究创建微信公众平台自定义菜单、设置系统命令字、接收消息、分析消息数据、发送客服消息、操作业务数据库、发送被动响应消息、网页授权获取用户信息及群发信息等功能, 实现图书馆微信自助服务微信平台的建设目标。
 

　　2、系统程序设计

　　系统程序以图书馆微信自助服务系统的服务体系为目标架构, 以APPServ作为系统开发和调试环境, 使用zendstudio作为PHP语言的IDE, 使用Windows版本的My SQL作为数据存储, 对图书馆微信的自助服务系统进行API接口设计, 进一步开发图书馆自助服务微信公众平台 (图1) 。
 

　　3、服务流程及架构

　　图书馆微信公众平台的功能模块是基于读者需求而建立的。首先, 需要对读者的需求进行调查, 并对读者日常咨询的问题进行统计, 在对读者需求调查和咨询统计分析的基础上, 设计出图书馆微信自助服务系统的功能系统框架。

　　微信公众平台在开发模式下, 图书馆可以通过微信公众平台的消息群发、一对一与读者交流, 微信公众平台自动回复3种方式与读者进行交流。其中微信公众平台自动回复是微信公众平台API接口主要的应用功能。具体流程为: (1) 微信公众平台管理员在微信公众平台中配置消息接口, 接入图书馆开发的微信消息处理模块; (2) 微信用户向微信公众号发送消息指令时, 微信公众平台服务器接收消息, 并将消息转发至图书馆微信公众平台; (3) 图书馆微信公众平台根据预先配置的API接口, 将消息转发给消息处理模块; (4) 消息处理模块会分析用户发送消息的内容, 如果包含关键字, 即按照既定的业务规则调用程序并返回给微信公众平台; (5) 微信用户最终接收到调用程序给予的反馈 (图2) 。
 

　　4、功能的实现

　　4.1、配置消息接口

　　图书馆微信公众平台功能的实现, 首要工作就是对图书馆微信公众平台的消息接口进行配置。图书馆开通微信公众号后, 需要进入微信公众平台的“开发模式”下填写图书馆服务器的URL服务器地址。然后需要Token给微信公众平台后台服务器。Token是一个任意字符串, 可以让图书馆微信公众平台服务器确认请求是来自微信后台还是恶意攻击。

　　微信公众平台服务器在发送数据给图书馆服务器的时候, 会使用3个参数:Signature、Timestamp、Nonce。其中:Timestamp是时间戳, Nonce是一个随机数, Signature是对Timestamp、Nonce和Token进行SHA1加密后的字符串。SHA1加密过程是不可逆的, 即不能通过Signature、Timestamp和Nonce计算出Token是什么。在图书馆服务器收到Signature、Timestamp和Nonce后, 同样对Timestamp、Nonce和Token使用SHA1加密算法, 得到自己的签名, 如果签名和Signature中的一样, 那么说明请求有效, 反之接入失败。

　　4.2、接收用户消息

　　当微信用户向图书馆公众账号发送消息时, 微信公众平台服务器会将用户消息发送到我们填的URL上, 校验参数是通过HTTP的GET参数传输的。以下是请求消息样例:
 

　　<xml>

图1 App Serv架构图

图2 基于PHP的图书馆微信公众平台服务流程及架构

　　<To User Name><![CDATA[to U-ser]]></To User Name>

　　<From User Name><![CDATA[from User]]></From User Name>

　　<Create Time>12345678</CreateTime>

　　<Msg Type><![CDATA[text]]></Msg Type>

　　<Content><![CDATA[s#t:医学信息学]]></Content>

　　<Msg Id>1234567890123456</Msg Id>

　　</xml>

　　其中, To User Name为开发者微信账号。From User Name表示发送账号, 即一个Open ID。Create Time是一个整型, 代表消息创建的时间。MsgType为消息类型, “text”表示了这是一个文本消息, 也可以是Image (图片消息) 、Event (事件消息) 等其它类型[4]。Content表示文本消息内容。Msg Id是一个64位整型, 表示消息ID。当用户发送查询题名为《医学信息学》的指令后, 微信公众平台服务会执行execute Module函数, 调用所对应的服务子模块查询相应图书。

　　4.3、回复用户消息

　　服务子模块接收到消息指令后进行响应和处理, 查询结果会返回给指令解析模块重新封装, 生成特定格式的回复消息XML。

　　<xml>

　　<To User Name><![CDATA[to User]]></To UserName>

　　<From User Name><![CDATA[from User]]></From User Name>

　　<Create Time>12345678</Create Time>

　　<Msg Type><![CDATA[text]]></Msg Type>

　　<Content><![CDATA[1、医学信息检索

　　2、医学信息资源检索

　　3、医学信息学

　　……

　　]]></Content>

　　<Func Flag>0</Func Flag>

　　</xml>

　　Content是我们要回复的消息内容, 一个长度不超过2048字节的字符串。

　　如果要向用户发送链接, 可以使用HTML语法的<a>标签, 消息样例如下:

　　<xml>

　　<To User Name><![CDATA[to User]]></To UserName>

　　<From User Name><![CDATA[from User]]></From User Name>

　　<Create Time>12345678</Create Time>

　　<Msg Type><![CDATA[text]]></Msg Type>

　　<Content><![CDATA[<a href=”链接IP地址”>链接文本名称</a>]]></Content>

　　<Func Flag>0</Func Flag>

　　</xml>

　　用户收到的消息会是一个链接文本名称, 单击该消息会打开对应的链接网址。
 

　　5、结语

　　以PHP程序设计语言为基础, 通过对图书馆自助服务微信平台的开发研究, 能够将图书馆的各个服务项目与微信公众平台API接口进行无缝契合, 从自动方式和人工方式两方面出发, 将馆内外服务与公众平台整合, 打造一个综合性的移动图书馆服务平台, 全方位满足用户需求, 更为迅捷地为读者进行服务, 实现真正意义上的24×7全时咨询服务, 并能有效地节约图书馆的人力资源, 同时由于其嵌入读者移动社交网络, 更容易被用户所接受, 使图书馆自助服务微信公众平台作为图书馆泛在化服务系统的重要组成部分。
 

　　参考文献

　　[1]第39次中国互联网络发展状况统计报告[EB/OL].[2017-01-22].

　　[2]叶佩珍.我国高校图书馆微信服务现状调查研究[J].图书馆学研究, 2014, (12) :80-84.

　　[3]吴静.浅谈3G时代的高校图书馆手机读者服务[J].淮海工学院学报 (人文社会科学版) , 2012, (23) :126-128.

　　[4]微信公众平台消息接口指南[EB/OL].[2017-03-01].