短信统一提交ebService 接口说明.doc

短信统一提交WebService 接口说明 接口地址： 电信：:6003/submitdata/Service.asmx 网通：:6003/submitdata/Service.asmx 短信提交接口 接口说明 类型 命名 描述 接口定义 g_Submit( string sname, string spwd, string scorpid, string sprdid, string sdst, string smsg) 提交短信 参数 sname 提交账户 参数 spwd 提交账户密码 参数 scorpid 企业代码 参数 sprdid 产品编号 参数 sdst 接收号码，多个以,分割,最大10000个号码 参数 smsg 信息内容,通常为70汉字以内，具体由平台内部决定 返回值说明 返回值CSubmitState结构说明： 命名 类型 描述 State int //提交结果值,返回值为0时，表示提交成功 MsgID string //提交结果ID，仅当提交成功后，此字段值才有意义 MsgState string //提交结果描述 Reserve int //保留，扩展用 返回值枚举 State MsgState 0 提交/审查 6002 信息内容超长 6003 提交参数不可为空，或参数类型错误 6004 提交速度限制 6005 提交池限制 6006 接收号码异常,或号码总数超过10000 100028 帐号余额不足 100030 记录入库失败 100031 用户帐号无效 100033 用户计费失败 100045 用户没有购买该类产品 100050 IP地址不符合 100051 企业号错误 200053 数据库操作异常 201005 接收号码被过滤，【过滤类型】：【过滤号码】，【过滤类型】：【过滤号码】……….. 201054 产品编号错误 201056 短信内容超长 -1 接口提交异常 其他值 提交结果未定义 说明： 针对 201005（接收号码被过滤）这个返回值时，MsgState的内容格式为 接收号码被过滤，【过滤类型】：【过滤号码】，【过滤类型】：【过滤号码】……….. 【过滤类型】定义：1.号码异常 2.号码归属省份异常 3.黑名单用户 【过滤号码】定义：实际被过滤的号码 信息发送状态查询接口 接口说明 类型 命名 描述 接口定义 g_QuerySendState( string sname, string msgid) 查询成功提交信息的发送状态 参数 Sname 提交账户 参数 Msgid 成功提交短信后的信息编号 返回值说明 返回值CSendState结构说明： 命名 类型 描述 State Int //状态返回值 TelNum Int //提交总数 SndNum Int //已发送的数量 SndErr Int //发送失败的数量 OutFailedNum Int //屏蔽过滤的数量 MsgState String //信息包状态 Reserve Int //保留，扩展用 返回值枚举? State 说明 0 成功 -1 系统异常 6004 无对应MSGID的信息记录 6007 日查询表尚未创建 用户帐号信息余量查询 接口说明 类型 命名 描述 接口定义 Sm_GetRemain( string sname, string spwd, string scorpid, string sprdid) 用户帐号信息余量查询 参数 Sname 提交账户 参数 Spwd 提交账户密码 参数 Scorpid 企业代码 参数 Sprdid 产品编号 返回值说明 返回值CRemain结构说明： 命名 类型 描述 State Int //状态返回值 Remain Int //余额 返回值枚举 State 说明 0 成功 -1 系统异常 6001 无效的帐号或密码 6012 当前的IP禁止查询 6021 无效的企业介入号 6024 帐号处于冻结状态