中国电信QChat 企业调度台与QCPS接口需求规范 20120712.docVIP

修订历史 时间 修订人 自审人 描述 创建文档 2011-10-31 预定义群组管理章节增加“增加群组”、“删除群组” 2011-12-20 修改http为https方式 2012-2-4 QCPS接口鉴权增加DeviceId用于识别企业调度台 2012-3-27 增加接口相关信息取值范围 2012-3-31 相关接口信息章节的接口取值 2012-4-10 用户登录账号要求为超级管理员账号 2012-5-12 系统返回码补充定义 2012-5-30 补充wsdl文档 2012-07-03 用户密码不返回 2012-07-12 增加群组成员重复错误码和描述定义  目 录 前 言 4 适用范围 5 参考资料 5 缩略语 5 接口位置 5 接口功能需求 5 接口登录和操作鉴权 5 Qchat管理功能 6 集团管理 6 预定义组管理 7 用户管理 8 遥毙/复活 8 管理接口交互流程 8 通讯协议 10 传输层协议及应用层安全机制 10 协议形式 10 数据类型 11 日期与时间 11 参数表示 11 接口约束 13 基础数据定义 13 口描述 14 14 7.2 服务端访问全地址 14 7.3 通用数据结构 15 业务功能信息验证 15 用户名密码验证 15 业务功能接口定义 16 集团管理 16 查询集团 16 查询集团预定义组 17 查询集团用户 18 预定义组管理 19 查询群组 19 增加群组 20 删除群组 20 修改群组 21 查询群组成员 21 增加群组成员 22 修改群组成员 23 删除群组成员 24 用户管理 24 查询用户 24 查询用户归属群组信息 25 修改用户 26 遥毙/复活 26 接口相关信息 27  前 言 本规范定义了中国电信股份有限公司（简称中国电信）CDMA网络中QChat业务部署系统（QCPS）与QChat无线调度台接口相关的接口需求和定义，以规范中国电信的QCPS和无线调度台的接口开发工作。 本规范由中国电信集团公司提出并归口。 本规范起草单位：中国电信股份有限公司广州研究院 本规范主要起草人： 本规范参与制定单位：  适用范围 本规范定义了中国电信股份有限公司（简称中国电信）CDMA网络中QChat业务部署系统（QCPS）与QCha无线调度台接口相关的接口需求和定义，为中国电信定制QCPS和无线调度台之间接口的研制、开发、生产、测试提供依据。 参考资料 [1] 超文本传送协议（Hypertext Transfer Protocol） -- HTTP/1.1RFC 2616 [2] SOAP 协议 V1.1 [3] SOAP 协议 V1.2 缩略语 缩略语 英文全名 中文全名 SMS Short Message Service 短信息服务 GIS Geographic Information System 地理信息系统 PTT Push To Talk 一键通呼叫 QCPS QChat Carrier Provisioning System QChat业务部署系统 接口位置 接口位于QCPS与无线调度台之间。 QChat业务部署系统（QCPS）：是QChat业务提供平台，它完成集团管理、群组管理、用户管理、系统配置等功能，为QChat企业调度台提供管理能力支持。 无线调度台部署在用户侧，QCPS接口应允许无线调度台通过中国电信IP专线、互联网接入，也允许无线调度台通过CTWAP接入。 接口功能需求 接口登录和操作鉴权 使用集团DeviceID、超级管理员账号和密码进行接口登录。DeviceID长度位12的字符串，前4位代表厂家ID，由电信分配给调度台厂家。后8位标识设备ID，调度台厂家自行分配。集团超级管理员账号和密码是由中国电信负责创建并交给集团客户使用的。CPS会对DeviceID前4位厂家ID、超级管理员账号、密码进行鉴权，只账号验证登录。 接口只支持针对集团管理员管理范围的对象操作请求，即只无线调度台只能通过该接口完成用户、群组、群组成员进行相应的操作请求。 超出范围的操作请求，QCPS接口需拒绝。 下图是典型的接口登录和操作鉴权流程： Qchat管理功能 集团管理 查询集团 查询管理员所属集团的详细信息，包括但不限于：集团名称、集团群组数量上限、集团用户数上限、普通管理员数量上限。 集团内预定义组和用户查询 查询集团内所有预定义组（含预定义群组、预定义聊天室）、用户（含在该集团下不属于任何群组的用户）的信息。 预定义组信息包括：群组号码，群组名称，群组主题，成员数上限，加入策略，群组类型，Domain。 用户信息包括：用户名称、用户号码、成员默认优先级、状态、