分享者：腾讯移动开发工程师罗广镇，感谢无私分享。

1、前言

2、相关文章

3、技术背景

4、传统的文本协议方案

4.1请求与响应

User-Agent：tgclub/4.1.0.63(OPPO R7;android 4.4.4;Scale/480;android;868979027609987)

       [url=http://xxx.xxx.com/xyapp/api/]http://xxx.xxx.com/xyapp/api/[/url]{mod}/{act}?c_ver={version}

       version:协议版本号, 默认当前版本号码为1.0

       mod:模块名称

       act:动作名称

      如，获取游戏信息,接口名称为 game/get_game_info，地址为：[url=http://xxx.xx.com/xyapp/api/game/get_game_info]http://xxx.xx.com/xyapp/api/game/get_game_info[/url]

{"status":0,"errcode":10002,"data":"签名校验错误"}

4.2安全性

HTTP调用需以GET形式传递一下两个参数：签名参数(sn)和时间戳(time_st)。

例如请求request为：?param_b=1¶m_a=2&time_st=123，sn_key=aaa
那么签名参数：sn = md5('param_a2param_b1time_st123aaa')

5、二进制协议方案

5.1请求与响应

1.png (134.47 KB, 下载次数: 1043)

下载附件  保存到相册

6 年前 上传

2.png (156.29 KB, 下载次数: 1082)

下载附件  保存到相册

6 年前 上传

• 1）截取协议头后，用PkgReq结构体解析协议头中指定长度的数据包。
• 2）PkgReq包括明文的协议包头PkgReqHead和密文的二进制流。
• 3）PkgReqHead中会包括客户端生成的请求序列号，密文的加密方式、压缩方式等信息，用这些信息解开加密压缩过的PkgReqBody。
• 4）PkgReqBody包含通用请求数据ReqHead和业务请求数据ReqBody数组。
• 5）ReqHead中主要包括用户的设备信息、App版本信息、账号信息、网络环境等等基础信息，ReqBody则是具体请求命令字和业务请求结构体的封装。
• 6）若是多个命令字的合并请求则会有多个ReqBody，而ReqHead只需要有一份。
• 7）后台路由层根据ReqBody中的命令字cmdid将ReqBody中的businessReqBody字段转发到具体的后台服务进行处理。
• 8）并且ReqHead中设计了guid字段，后台会存储用户的设备信息并且给用户分配唯一的guid，客户端拿到guid之后，后续的请求就不需要上报不变的设备信息字段，只需要上传guid，后端可以根据guid按需获取用户设备信息，减小请求数据量。
  

3.png (27.72 KB, 下载次数: 1049)

下载附件  保存到相册

6 年前 上传

4.png (74.83 KB, 下载次数: 1111)

下载附件  保存到相册

6 年前 上传

5.2安全性

6、本文小结

• 1）文本协议直观、描述性强，容易理解、便与调试，并且协议修改方便，但是数据冗余较多，安全性稍差；
• 2）二进制协议格式精简、冗余数据少，窃听成本更高，但是数据不直观、调试略微复杂，使用、升级维护都需要约定好规则。
  

附录：更多技术文章