短信网关SP端应用程序接口使用详细说明

1、更多企业学院：中小企业管理全能版183套讲座+89700份资料总经理、高层管理49套讲座+16388份资料中层管理学院46套讲座+6020份资料国学智慧、易经46套讲座人力资源学院56套讲座+27123份资料各阶段员工培训学院77套讲座+ 324份资料员工管理企业学院67套讲座+ 8720份资料工厂生产管理学院52套讲座+ 13920份资料财务管理学院53套讲座+ 17945份资料销售经理学院56套讲座+ 14350份资料销售人员培训学院72套讲座+ 4879份资料更多企业学院：中小企业管理全能版183套讲座+89700份资料总经理、高层管理49套讲座+16388份资料中层管理学院46套讲座+

2、6020份资料国学智慧、易经46套讲座人力资源学院56套讲座+27123份资料各阶段员工培训学院77套讲座+ 324份资料员工管理企业学院67套讲座+ 8720份资料工厂生产管理学院52套讲座+ 13920份资料财务管理学院53套讲座+ 17945份资料销售经理学院56套讲座+ 14350份资料销售人员培训学院72套讲座+ 4879份资料短信网关SP端应用程序接口使用说明- SXIT_ISMG_CMPP_API一、使用说明本接口遵循 CMPPV2.0协议标准，以提供消息发送和接收函数的方式，向SP提供同移动网关进行信息交换的实现途径客户可以依据具体需要，利用所提供的函数实现不同的连接方式(长连

3、接和短连接)以及何时自动建立和中断连接，除此之外， API作为应用的接口，对 CMPP描述的其它功能，象流量控制、重发机制和并发处理都不预干预，需要应用程序处理。二、函数说明：1、与网关建立连接(CMPP_Connect)函数功能与网关建立网络连接，返回值 0时，标识一个连接，在以下的函数中使用返回值0连接成功0连接失败参数说明：参数名数据长度数据类型说明gwp20字符串网关的IP地址port4短整型端口号，一般为 7890user name6字符串SP的名称passwd20字符串密码注意：username是接入局分配的接入用户名，而不是企业代码。2、向网关提交信息(CMPP_Submit)函

4、数功能向网关提交短信返回值=0标识成功0标识发送失败参数说明：参数名数据长度数据类型说明conn id4整型CMPP Co nn ect 返回的连接标识p msgd8无符号整型消息ID,由网关返回msg_level1无符号整型消息级别serviced10字符串业务代码msg_format1无符号整型消息格式0: ASCII串 3:短信写卡操作4 :二进制信息8: UCS2编码15 :含 GB 汉字。msg src6字符串消息来源(SP ld)fee_type2字符串计费类型01 :对“计费用户号码”免费02 :对“计费用户号码”按条计信息费03 :对“计费用户号码”按包月收取信息费04 :对“

5、计费用户号码”的信息费封顶05 :对“计费用户号码”的收费是由SP实现fee code6字符串资费代码，以分为单位valid time14字符串存活时间，格式为 YYYYMMDDHHMISSat time14字符串发送时间，格式为 YYYYMMDDHHMISStp pid1无符号整型参见GSM03.40, 一般为0udhi1无符号整型参见GSM03.40, 一般为0fee_user_type1无符号整型计费用户类型0=对目的手机收费， 仁对源手机收费，2=对SP收费，3=对charge num收费charge mobile21字符串收费手机号，没有写“ 0”src mobile21字符串源手机

6、号，没有写“ 0 “user num1无符号整型接收手机个数 100dest mobiles21字符串接收手机号码，以空格分隔msg160字符串消息内容msg len4整型消息长度n eed_resp onse1无符号整型是否需要状态报告0：不需要1 需2:生成包月话单、八.,、注意:如果建立好连接后一段时间没有发送消息，网关将关闭连接，CMPP_Submit返回ERROR_SOCKET_CLOSE ，这时，必须重新建立连接并发送消息3、查询网关(CMPP_Query )函数功能向网关提交查询包，并得到查询结果。返回值=0 标识成功0 标识失败 参数说明：参数名数据长度数据类型说明conn i

7、d4整型连接标识date8字符串日期，格式为yyyymmddtype1无符号整型查询类型0=查询总数，1=按业务代码查询service10字符串查询代码当Query_Type为0时，此项无效；当Query_Type为1时，此项填与业务类型Serviced.P resX结构体返回的结构体注意：username是接入局分配的接入用户名，而不是企业代码。4、主动与网关断开连接 函数功能主动和网关断开链接返回值=0 标识成功0标识成功 返回值标识一个连接，在以下的函数中使用 0 标识失败参数说明：参数说明:参数名数据长度数据类型说明gwp20字符串网关的IP地址port4短整型端口号，一般为 7910

8、user name6字符串SP的名称passwd20字符串密码注意：username是接入局分配的接入用户名，而不是企业代码。6、等待并接收 M0消息函数功能连接M0虚拟链路到网关返回值=0标识成功 返回值标识一个连接，在以下的函数中使用 0 标识失败参数说明：参数名数据长度数据类型说明Con n id4整型连接标识p MOX结构体返回的MO消息、八.,、注意:如果没有M0消息将阻塞，直至 M0消息到达或连接被网关关闭7、删除短信(CMPP_Cancel)函数功能向网关提交查询包，并得到查询结果。返回值=0 标识成功0 标识失败参数说明：参数名数据长度数据类型说明conn id4整型连接标识m

9、sgd8无符号整型消息ID,由网关返回p_Ca ncel_Rep MsgX结构体返回的删除短信响应结果8、短连接(以短连接的方式向网关提交消息，直接调用即可)函数功能向网关提交短信返回值=0 一次连接发送成功0连接或发送失败参数说明：参数名数据长度数据类型说明gw_ip20字符串网关的IP地址port4短整型端口号，一般为 7900user name6字符串SP的名称passwd20字符串密码p_msgd8无符号整型消息ID,由网关返回msg_level1无符号整型消息级别serviced10字符串业务代码msg_format1无符号整型消息格式0: ASCII串 3:短信写卡操作4 :二进制

10、信息8: UCS2编码15 :含 GB 汉字。msg_src6字符串消息来源(SP ld)fee_type2字符串计费类型01 :对“计费用户号码”免费02 :对“计费用户号码”按条计信息费03 :对“计费用户号码”按包月收取信息费04 :对“计费用户号码”的信息费封顶05 :对“计费用户号码”的收费是由SP实现fee code6字符串资费代码，以分为单位valid time14字符串存活时间，格式为 YYYYMMDDHHMISSat time14字符串发送时间，格式为 YYYYMMDDHHMISStp pid1无符号整型参见GSM03.40, 一般为0udhi1无符号整型参见GSM03.40

11、, 一般为0fee_user_type1无符号整型计费用户类型0=对目的手机收费， 仁对源手机收费，2=对SP收费，3=对charge num收费charge mobile21字符串收费手机号，没有写“ 0”src mobile21字符串源手机号，没有写“ 0 “user num1无符号整型接收手机个数 100dest mobiles21字符串接收手机号码，以空格分隔msg160字符串消息内容msg len4整型消息长度n eed_resp onse1无符号整型是否需要状态报告0：不需要1 需2:取消包月9、检查 MO消息是否是状态报告(is_status_report)函数功能判断MO包是否

12、为状态报告返回值=0 普通MO消息=1 状态报告参数说明：10、从MO消息得到状态报告(get_status_report)函数功能从MO包中得到状态报告返回值状态报告指针参数说明参数名数据长度数据类型说明p MOX结构体CMPP Get MO得到的结构体11、链路检测(CMPP_Active )函数功能保持链路链接正常返回值0 :错误=0 :正常参数说明参数名数据长度1数据类型说明Con n id4整型连接标识结构体说明1、查询结果结构体(Query_Res):参数名数据长度数据类型说明mt total msg4无符号整型:从SP接收的用户总数mt total user4无符号整型从SP接收

13、的信息总数mt succ4无符号整型成功转发数量mt wait4无符号整型r待转发数量mt fail4无符号整型转发失败数量mo succ4无符号整型向SP成功送达数量mo wait4无符号整型向SP待送达数量mo fail4无符号整型向SP送达失败数量2、MO消息参数名数据长度数据类型说明msgID8整型消息IDdest id21字符串接入号码serviced10字符串业务代码tp pid1无符号整型见GSM03.40 ,通常为0tp udhi1无符号整型见GSM03.40 ,通常为0msgFormat1无符号整型r消息格式sourceUser21字符串:发送消息的手机reg deliver

14、1无符号整型是否为应答消息，仁yes, 0=nomsgLe n1无符号整型:消息长度msg160字符串消息内容3、状态报告参数名数据长度数据类型说明msgID8整型消息ID,与CMPP_Submit中返回的消息ID对应stat7字符串状态submit time10字符串提交时间，MMDDHHMMSSdon e time10字符串完成时间，MMDDHHMMSSdestUser21字符串接收手机smsc seq4无符号整型短信中心序列号四、常量说明1状态报告中的状态:常量名说明DELIVRD短信成功传送EXPIRED超过短信的有效期DELETED短信被删除UNDELIV短信无法送达ACCEPTD处

15、于被接受状态UNKNOWN处于非法状态REJECTD处于被拒绝状态DELIVRD短信成功传送2、错误码常量名代表值说明ERROR OK0正常ERROR SOCKET CREATE-100创建socket失败ERROR CONNECT-101联接到网关失败ERROR SOCKET WRITE-102写socket失败ERROR SOCKET READ-103读socket失败ERROR ICP ID-104错误的SP IDERROR AUTH-105认证错误ERROR MSG LEN-106短消息长度错ERROR FEE CODE-107计费代码错ERROR SERVICE ID-108业务代码

16、错ERROR FLOW CONTROL-109流量控制错ERROR SOCKET CLOSE-110当对Socket操作时，socket关闭ERROR INTERNAL-200内部错误，一般为信息结构错ERROR UNKNOWN-201未知错误ERROR ARGUMENT-202调用api函数参数错五、常见问题解答1、 为何联接到网关时网关回复 ERROR_AUTH错误码？答：深讯网关在 SP信息里有企业代码、SP名称、密码三项，网关要求 SP鉴权时填写的用户名 为局方分配的SP名称，而不是企业代码，密码为局方分配的SP密码。2、 为何联接到网关时网关回复ERROR_SOCKET_READ 错误码？答：造成此问题的原因很可能是你的IP同局方管理人员设置的IP不一致。请与局方管理人员核对数据。3、 为何向网关提交短信时会返回ERROR_MSG_LEN错误码？答：CMPP2.0协议有规定：信息长度当 Msg_Fmt值为0时：160个字节；其它=140个字节;当你的短信消息长度超长时，网关