1、短信通讯 WebService 接口设计功能函数及流程图A、短信发送操作函数 SmsSend:public string SmsSend(string EncryptUser_ID,string flag,string EncryptSms)注:短信各参数需使用特殊符号连接作为接口条用参数 EncryptSms,需要判断短信各参数中不存在连接各参数的特殊符号。短信各参数说明:参数名 类型 备注EncryptUser_ID string接口使用方使用的小端口号码(在小端口划分平台中规划)使用小端口公用加密密钥 DES 加密后的值flag string使用接口使用方和提供方提前约定好的密码,经过
2、MD5 后的字符串EncryptSms string短信各字段使用特殊符号连接后,经过接口使用方和提供方提前约定好的发送私钥,经过 DES 加密后的字符串返回值说明:参数名 类型 长度 备注Dest_Mobile string目标收集号码,单个手机号码长度为 11 位,多个手机号码之间使用分号相连,每次群发不超过 30个Content string 260字 短信内容,长度在 260 字以内,即最长长度限制为 4 条Event_ID string 6短信事件 ID,在多人会话短信时使用,用户回复到此事件短信同样具有此参数。可为空值Reserve1 string 50保留参数,可不填,默认值为“
3、0”Reserve2 string 50保留参数,可不填,默认值为“0”Reserve3 string 50保留参数,可不填,默认值为“0”返回值 类型 定义0 string 发送成功1 string 参数 EncryptUser_ID 错误,即小端口号码加密错误2 string 参数 flag 错误,即调用密码错误或时间不同步3 string 短信参数 EncryptSms 错误,解密失败,即调用方加密错误或私钥错误4 string 短信参数中接收号码错误5 string 短信参数中接收号码分隔符错误或单个号码长度不正确6 string 短信参数中群发短信时部分错误接收号码已被删除,其他已发
4、送7 string 发送号码超过 30 个8 string 短信内容错误或长度超过限制9 string 短信事件 ID 错误短信发送方法流程图:10 string 未知错误B、短信接收操作函数 SmsReceive:public string SmsReceive(tring EncryptUser_ID,string flag)函数参数列表:函数返回值及说明:参数名 类型 备注EncryptUser_ID string接口使用方使用的小端口号码(在小端口划分平台中规划)使用小端口公用加密密钥 DES 加密后的值flag string使用接口使用方和提供方提前约定好的密码和当前时间字符串连接后
5、的字符串,经过 MD5 后的字符串返回值 类型 定义1 string 参数 EncryptUser_ID 错误,即小端口号码加密错误2 string 参数 flag 错误,即调用密码错误或时间不同步-1 string 目前没有发送到此小端口的短信3 string 未知错误短信字符串 string短信各字段使用特殊符号连接后,经过接口使用方和提供方提前约定好的接收私钥,经过 DES 加密后的字符串,短信各字段详细定义见下表短信字符串中各参数说明:接收方法流程图:参数名 类型 长度 备注Dest_Mobile string 11 目标收集号码,单个手机号码长度为 11 位Content strin
6、g 70 汉字 单条短信内容,长度在 70 字以内 Event_ID string 6短信事件 ID,在多人会话短信时使用,用户回复到此事件短信同样具有此参数。可为空值Reserve1 string 50 保留参数,可不填,默认值为“0”Reserve2 string 50 保留参数,可不填,默认值为“0”Reserve3 string 50 保留参数,可不填,默认值为“0”数据库结构短信接口主要使用数据库表数据表名 内容tb_ws_shortport 小端口调用密码和接收、发送私钥等内容tb_ws_sms_receive 小端口接收短信相关信息tb_ws_sms_receive_log 小端
7、口接收短信相关信息日志tb_ws_sms_send 小端口发送短信相关信息tb_ws_sms_send_log 小端口发送短信相关信息日志表 tb_ws_shortport 字段信息数据表名 类型 长度 备注shortport varchar 50 短信小端口号码flag varchar 100 短信接口调用密码send_key varchar 100 发送私钥receive_key varchar 100 接收私钥表 tb_ws_sms_receive、tb_ws_sms_receive_log 字段信息数据表名 类型 长度 备注id varchar 50 短信 ID 号码,为时间字符串,精
8、确到毫秒shortport varchar 50 小端口号码send_mobile varchar 50 发送短信手机号码content varchar 200 短信内容event_id varchar 50 事件 ID 号码,可为空Reserve1 varchar 50 保留字段,默认值为“0”Reserve2 varchar 50 保留字段,默认值为“0”Reserve3 varchar 50 保留字段,默认值为“0”表 tb_ws_sms_send、tb_ws_sms_send_log 字段信息数据表名 类型 长度 备注id varchar 50 短信 ID 号码,为时间字符串,精确到毫秒shortport varchar 50 小端口号码dest_mobile varchar 50 接收短信手机号码content varchar 600 短信内容event_id varchar 50 事件 ID 号码,可为空Reserve1 varchar 50 保留字段,默认值为“0”Reserve2 varchar 50 保留字段,默认值为“0”Reserve3 varchar 50 保留字段,默认值为“0”