《短信网关SP端应用程序接口使用详细说明》由会员分享，可在线阅读，更多相关《短信网关SP端应用程序接口使用详细说明（11页珍藏版）》请在金锄头文库上搜索。
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接收的信息总数mt succ4无符号整型成功转发数量mt wait4无符号整型r待转发数量mt fail4无符号整型转发失败数量mo succ4无符号整型向SP成功送达数量mo wait4无符号整型向SP待送达
