企业开放开发手册样本.docVIP

公司QQ开放API

开发手册

腾讯科技（上海）有限公司

版权所有侵权必究

目录

TOC\o1-3\h\z\u1 文档目和范畴 3

2 整体阐明 4

2.1 拓扑构造 4

2.2 文献存储位置 4

2.2.1 同一主机存储 4

2.3 存储位置阐明 5

2.4 数据文献命名格式阐明 5

2.4.1 文献命名总体规则 5

3 数据格式详细阐明 7

3.1 文献总体格式阐明 7

3.2 文献头格式阐明 7

3.3 聊天记录格式阐明 7

3.4 会话记录格式阐明 8

3.5 朋友资料格式阐明 8

3.6 朋友分组格式阐明 9

4 数据获取工具使用阐明 10

4.1 QQServer 10

4.2 getQQmsg 10

4.3 getQQsess 10

4.4 getQQfrnd 11

4.5 sendQQmsg 11

4.6 QQTest 11

5 配备阐明 12

5.1 服务程序oapi_qqserver配备 12

5.2 工具类程序oapi_tools_***配备 13

5.3 公司QQ客户端自定义TAB配备 13

5.4 客户端内嵌页面制作规范 16

6 log文献阐明 18

6.1 oapi_qqserver日记文献 18

6.2 oapi_tools_***日记文献 18

7 程序布置阐明 19

7.1 系统规定 19

8 FAQ 20

文档目和范畴

本文档为公司QQ开放API工具包用法和定制开发操作阐明。

整体阐明

公司QQ开放数据以文献方式提供。腾讯公司提供获取文献工具程序，由各公司在需要时运营该工具程序从腾讯获取数据文献，工具程序用法参加“4数据获取工具使用阐明”。

拓扑构造

获取数据程序由daemon程序和tools程序构成，daemon程序通过TCP连接与腾讯服务器进行加密通讯。tools程序向daemon程序发起各项取数据祈求，拓扑构造如下图：

公网TCP加密传播内网TCP

公网TCP

加密传播

内网TCP

明文传播

tools

daemon

腾讯服务器

图2-1拓扑图

文献存储位置

假设TOPDIR为顾客指定存储公司QQ程序及数据顶层目录。

同一主机存储

假设所有内容位于同一台主机，则各类文献存储位置如下：

图2-2同一主机布置目录构造

存储位置阐明

各目录阐明如下：

目录名称

目录下文献

备注

daemon

运营与各公司接口机器上取数据服务程序

用于同腾讯公司服务器通讯，需要有外网接口。此目录下仅有QQServer一种程序文献

tools

详细获取各类数据文献命令工具存储位置

此目录下所有程序与上述daemon目录里服务程序交互以获取数据，此目录下有getQQmsg、getQQsess、getQQfrnd、sendQQmsg、QQTest等五个程序文献

conf

程序配备文献存储途径

此目录下有qqserver.ini和qqtools.ini文献，配备文献格式参见“5配备文献阐明”

log

程序运营产生log文献存储于此

此目录下为各程序运营产生log文献，每类文献每日产生一种，log文献格式阐明参见“6log文献阐明”

msg

聊天消息记录文献存储目录

此目录下为聊天消息记录文献，每工号每日一种文献

sess

会话记录文献存储目录

此目录下为会话记录文献，每工号每日一种文献

frnd

朋友资料文献存储目录

此目录下为朋友资料文献，每日一种朋友详细资料文献和一种朋友分组信息文献

表2-1目录阐明

数据文献命名格式阐明

文献命名总体规则

所有文献命名总体规则如下：

TYPE

TYPE

主号

起始日期

终结日期

后缀

工号

图2-3命名总体规则

各某些之间如下划线分割。

TYPE：为M、S、F、G之一。M标记此文献为聊天消息记录文献；S标记此文献为会话记录文献；F标记此文献为朋友资料文献；G标记此文献为朋友分组信息文献

主号：为公司QQ号码

工号：为公司QQ工号，若工号为9999表达不特定工号

起始日期：数据起始日期，日期格式为年月日以YYYYMMDD格式表达

终结日期：数据终结日期

后缀：各类数据文献后缀，默以为“.dat”

示例：

主号2工号0808日聊天记录文献文献名为M__1002_0808_0808.dat

主号8日朋友分组信息文献文献名为G__9999_0808_0808.dat

数据格式详细阐明

本章节对各类数据格式进行详细阐明。

文献总体格式阐明

所有文献为纯文本格式；

2、每个文献分为两大某些：文献头和文献体

文献头为单独一行内容，是