标准短彩协议V24.xls

基基本本数数据据类类型型 类类型型描描述述 Integer整数 可为正整数 负整数或零 Octet String右补0 补二进制的零以表示字符串的结束符 消消息息结结构构 项项目目说说明明 Message Header消息头 所有消息公共包头 Message Body消息体 消消息息头头格格式式 Message Header 字字段段名名字字节节数数类类型型描描述述 totalLength4Integer包长度 commandID4Integer命令标识 sequenceId8Integer唯一序列号 commandStatus4Integer 命令状态 消息为如下对象时填写规则 Login 连接类型 0 上下行兼容 1 只上行 2 只下行 Login Resp 发送Login消息的响应结果 0 成功 其他 失败 Logout 无意义默认填 0 Logout Resp 发送Logout消息的响应结果 0 成功 其他 失败 Deliver 无意义默认填 0 Deliver Resp 接收Deliver消息的响应结果 0 成功 其他 失败 Report 网关返回的msgfmt值 目前彩信为30 个性化彩信33 Report Resp 接收Report消息的响应结果 0 成功 其他 失败 Submit 合作方编号 填写 srcclientID Submit MMS 合作方编号 填写 srcclientID Submit Response 发送Submit或Submit MMS消息的响应结果 0 成功 其他 失败 Content MMS 无意义默认填 0 Content MMS Resp 发送Content MMS消息的响应结果 0 成功 其他 失败 Standard LoginStandard Login 字字段段名名字字节节数数类类型型描描述述 clientID4Integer合作方编号 必添字段 userName16Octet String登录用户名 必添字段 passWard16Octet String登录密码 必添字段 Standard Login RespStandard Login Resp 无消息体 Standard LogoutStandard Logout 字字段段名名字字节节数数类类型型描描述述 coagentID4Integer合作方编号 必添字段 userName16Octet String登录用户名 必添字段 passWard16Octet String登录密码 必添字段 Standard Logout RespStandard Logout Resp 无消息体 Standard DeliverStandard Deliver 字字段段名名字字节节数数类类型型描描述述 srcMobile21Octet String源手机号 必添字段 destNumber21Octet String目的号码 默认填写 messageFormat2Integer消息的编码格式 0 ASCII串 3 短信写卡操作 4 二进制信息 8 UCS2编码 15 GBK编码 30 彩信 linkID20Octet String临时订购关系 默认填写 operatorID2Integer运营商编号 1 移动 2 联通 3 电信 provinceID2Integer省编号 默认填写 0 保留字段 暂无意义 cityID2Integer市编号 默认填写 0 保留字段 暂无意义 channelID4Integer渠道编号 默认填写 0 保留字段 暂无意义 productID4Integer通道组Id 默认填写 0 messageType2Integer消息的类型 默认填写 0 保留字段 暂无意义 userLevel2Integer用户级别 默认填写 0 保留字段 暂无意义 reserve20Octet String保留字段 默认填写 messageLength2Integer消息的长度 必添字段 messageContent变长Octet String消息的内容 必添字段 Standard Deliver RespStandard Deliver Resp 无消息体 Standard ReportStandard Report 字字段段名名字字节节数数类类型型描描述述 destMobile21Octet String目的手机号 必添字段 state4Integer消息状态 0 发送成功 1 网关失败 2 发送失败 errorCode8Octet String消息错误码 默认填写 srcSequenceId8Integer唯一序列号 系统生成 pkNumber2Integer Standard Report RespStandard Report Resp 无消息体 Standard SubmitStandard Submit 字字段段名名字字节节数数类类型型描描述述 srcNumber21Octet String下发的源号码 默认填写 messagePriority2Integer消息的优先级 0 最低 3 最高 reportType2Integer是否需要状态报告 0 不需要 1 需要 2 其它 messageFormat 2Integer 消息的编码格式 15 GBK编码 31 wappush 32 长短信 41 加密普通短信 42 加密长短信 linkID20Octet String下行临时订购关系 默认填写 srcSequenceId8Integer唯一序列号 系统生成 不填写 channelID4Integer渠道编号 默认填写 0 保留字段 暂无意义 sendGroupID4Integer下发批次 默认填写 0 保留字段 暂无意义 productID4Integer产品编号 必添字段 默认填写 0 messageType2Integer消息的下发类型 0 免费下发 1 按条下发 2 包月下发 3 订阅请求 4 取消请求 5 包月扣费 reserve20Octet String保留字段 默认填写 destMobileCount2Integer接收信息的用户数量 小于100 必添字段 destMobiledestMobileCount 21Octet String目的手机号 必添字段 messageLength2Integer消息的长度 必添字段 messageContent变长Octet String消息的内容 必添字段 93 Standard Submit ResponseStandard Submit Response 字字段段名名字字节节数数类类型型描描述述 srcSequenceId8Integer唯一序列号 系统生成 Standard ActiveStandard Active 无消息体 Standard Active RespStandard Active Resp 无消息体 Standard Submit MMSStandard Submit MMS 字字段段名名字字节节数数类类型型描描述述 srcNumber21Octet String下发的源号码 默认填写 messagePriority2Integer消息的优先级 0 最低 3 最高 reportType2Integer是否需要状态报告 0 不需要 1 需要 2 其它 messageFormat2Integer消息的编码格式 30 普通彩信 33 个性化彩信 linkID20Octet String下行临时订购关系 默认填写 srcSequenceId8Integer唯一序列号 系统生成 不填写 channelID4Integer渠道编号 默认填写 0 保留字段 暂无意义 sendGroupID4Integer下发批次 默认填写 0 保留字段 暂无意义 productID4Integer产品编号 必添字段 默认填写 0 messageType2Integer消息的下发类型 0 免费下发 1 按条下发 2 包月下发 3 订阅请求 4 取消请求 5 包月扣费 reserve20Octet String保留字段 默认填写 subjectLength2Integer彩信主题长度 subjectContent变长Octet String彩信主题内容 destMobileCount2Integer接收信息的用户数量 小于100 必添字段 destMobile变长 MMS Individ ual手机号码和个性化内容 messageContentType2Integer消息的内容类型 0 彩信资源ID 1 彩信内容 messageFileSize2Integer资源文件个数 messageLength4Integer消息的长度 必添字段 messageContent变长Octet String 或者 MMS Resou rceContent 消息的内容 必添字段 消息内容类型为0时 messageContent类型为String 内容是彩信资源 ID 消息内容类型为1时 messageContent类型为 Standard Resource Submit MMS IndividualMMS Individual 内内嵌嵌对对象象用用于于描描述述手手机机号号码码和和个个性性化化信信息息 字字段段名名字字节节数数类类型型描描述述 destMbile21Octet String目标手机号码 individualLength4Integer个性化彩信内容数组的总长度 individualContents变长Octet String个性化内容数组 使用 进行属性拆分 MMS ResourceContentMMS ResourceContent 内内嵌嵌对对象象用用于于描描述述彩彩信信资资源源信信息息 字字段段名名字字节节数数类类型型描描述述 fileNameLength2Integer fileName变长Octet String文件名 fileContentLength4Integer文件内容长度 fileContent变长Octet String文件内容 Standard Submit ResponseStandard Submit Response 状状态态返返回回对对象象同同短短信信的的相相同同 字字段段名名字字节节数数类类型型描描述述 srcSequenceId8Integer唯一序列号 系统生成 Standard Content MMSStandard Content MMS 字字段段名名字字节节数数类类型型描描述述 messageKeepDate2Integer消息保留时长 单位 天 当值 7 时 默认保留7天 messageFileSize2Integer资源文件个数 messageLength4Integer消息的长度 必添字段 messageContent变长MMS Resou rceContent 消息的内容 必添字段 messageContent类型为Standard Resource Submit resourceID30Octet String彩信资源在资源中心的编号 系统生成 不填写 Standard Content MMS RespStandard Content MMS Resp 状状态态返返回回对对象象同同短短信信的的相相同同 字字段段名名字字节节数数类类型型描描述述 resourceID30Octet String彩信资源在资源中心的编号 连连接接方方式式 通信双方以客户 服务器方式建立TCP连接 用于双方信息的相互提交 当信 道上没有数据传输时 通信双方应每隔时间C发送链路检测包以维持此连接 当链路检测包发出超过时间T后未收到响应 应立即再发送链路检测包 再连 续发送N 1次后仍未得到响应则断开此连接 参数C T N原则上应可配置 现阶段建议取值为 C 10秒 T 10秒 N 3 服务器与合作方之间 网关之间的消息发送后等待T秒后未收到响应 应立即 重发 再连续发送N 1次后仍未得到响应则停发 参数T N原则上应可配置 现阶段建议取值为 T 10秒 N 3 commandIDcommandID定定义义序序列列号号的的定定义义 Login 0 x000000011001 7 05 21 20 04 56 0001 Login Resp 0 x80000001合作方编号 年份 最后一位 月份日期小时分钟 秒 流水号 0 9999 Logout 0 x000000021001705212004560000 Logout Resp 0 x80000002 Active 0 x00000003 Active Resp 0 x8000000