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

1、更多企业学学院： 中小企业业管理全全能版183套讲讲座+8897000份资料总经理、高高层管理理49套讲座座+1663888份资料中层管理理学院46套讲座座+60020份份资料国学智慧慧、易经经46套讲座座人力资源源学院56套讲座座+2771233份资料各阶段员员工培训训学院77套讲座座+ 3324份份资料员工管理理企业学学院67套讲座座+ 887200份资料工厂生产产管理学学院52套讲座座+ 1139220份资料财务管理理学院53套讲座座+ 1179445份资料销售经理理学院56套讲座座+ 1143550份资料销售人员员培训学学院72套讲座座+ 448799份资料更多企业学学院： 中小企业业

2、管理全全能版183套讲讲座+8897000份资料总经理、高高层管理理49套讲座座+1663888份资料中层管理理学院46套讲座座+60020份份资料国学智慧慧、易经经46套讲座座人力资源源学院56套讲座座+2771233份资料各阶段员员工培训训学院77套讲座座+ 3324份份资料员工管理理企业学学院67套讲座座+ 887200份资料工厂生产产管理学学院52套讲座座+ 1139220份资料财务管理理学院53套讲座座+ 1179445份资料销售经理理学院56套讲座座+ 1143550份资料销售人员员培训学学院72套讲座座+ 448799份资料短信网关SSP端应应用程序序接口使使用说明明 - SXI

3、IT_IISMGG_CMMPP_APII一、 使使用说明明本接口遵遵循 CCMPPPv2.0 协协议标准准，以提提供消息息发送和和接收函函数的方方式， 向 SSP 提提 供供同移动动网关进进行信息息交换的的实现途途径.客客户可以以依据具具体需要要，利用用所提供供的函数数实 现现不同的的连接方方式(长长连接和和短连接接)以及及何时自自动建立立和中断断连接， 除此之之外， APII 作作为应用用的接口口，对 CMPPP 描描述的其其它功能能，象流流量控制制 、重重发机制制和并发发处理都都不预 干干预，需需要应用用程序处处理。 二、 函函数说明明：1、 与与网关建建立连接接(CMMPP_Connne

4、cct) 函数功功能与网关建立立网络连连接，返返回值0时，标标识一个个连接，在在以下的的函数中中使用返回值0 连连接成功功 0 连连接失败败参数说明：参数名数据长度数据类型说明gw_ipp20字符串网关的IPP地址port4短整型端口号，一一般为778900usernnamee6字符串SP的名称称passwwd20字符串密码注意：useernaame是是接入局局分配的的接入用用户名，而而不是企企业代码码。 2、向网关关提交信信息 (CMPPP_SSubmmit)函数功能向网关提交交短信返回值=0 标识成成功0 标识发发送失败败 参数说说明：参数名数据长度数据类型说明conn_id4整型CMPP

5、_Connnecct 返回的的连接标标识p_msgg_idd8无符号整型型消息 IDD，由网网关返回回msg_lleveel1无符号整型型消息级别serviice_id10字符串业务代码msg_fformmat1无符号整型型消息格式0：ASCCII串串 33：短信信写卡操操作4：二进制制信息 8：UCSS2编码码15：含GGB汉字字 。msg_ssrc6字符串消息来源(SP_Id)fee_ttypee2字符串计费类型01：对“计费用用户号码码”免费02：对“计费用用户号码码”按条计计信息费费03：对“计费用用户号码码”按包月月收取信信息费04：对“计费用用户号码码”的信息息费封顶顶05：对“计

6、费用用户号码码”的收费费是由SSP实现现fee_ccodee6字符串资费代码，以以分为单单位validd_tiime14字符串存活时间，格格式为YYYYYYMMDDDHHHMISSSat_tiime14字符串发送时间，格格式为YYYYYYMMDDDHHHMISSStp_piid1无符号整型型参见GSMM03.40，一一般为00udhi1无符号整型型参见GSMM03.40，一一般为00fee_uuserr_tyype1无符号整型型计费用户类类型0=对目的的手机收收费，11=对源源手机收收费，2=对SPP收费，33=对ccharrge_numm收费chargge_mmobiile21字符串收费手机

7、号号，没有有写“0”src_mmobiile21字符串源手机号，没没有写“0“user_numm1无符号整型型接收手机个个数 1000dest_mobbilees21字符串接收手机号号码，以以空格分分隔msg160字符串消息内容msg_llen4整型消息长度need_ressponnse1无符号整型型是否需要状状态报告告0：不需要要1：需要2：生成包包月话单单 注意：如果建立立好连接接后一段段时间没没有发送送消息，网网关将关关闭连接接，CMPP_Subbmitt返回EERROOR_SSOCKKET_CLOOSE ，这时时，必须须重新建建立连接接并发送送消息 3、 查询询网关（CMPP_Quer

8、y） 函数功功能向网关提交交查询包包，并得得到查询询结果。返回值=0 标标识成功功 0 标标识失败败参数说明：参数名数据长度数据类型说明conn_id4整型连接标识date8字符串日期，格式式为yyyyymmmdddtype1无符号整型型查询类型00=查询询总数，11=按业业务代码码查询serviice10字符串查询代码当Querry_TTypee为0时时，此项项无效；当Querry_TTypee为1时时，此项项填写业业务类型型Serrvicce_IId.p_ressX结构体返回的结构构体注意：uuserrnamme是接接入局分分配的接接入用户户名，而而不是企企业代码码。4、 主动动与网关关断

9、开连连接 函数功功能主动和网关关断开链链接返回值=0 标标识成功功 0 标标识成功功 返返回值标标识一个个连接，在在以下的的函数中中使用0 标标识失败败参数说明：参数说明：参数名数据长度数据类型说明gw_ipp20字符串网关的IPP地址port4短整型端口号，一一般为779100usernnamee6字符串SP的名称称passwwd20字符串密码注意：uuserrnamme是接接入局分分配的接接入用户户名，而而不是企企业代码码。 6、等待并并接收 MO 消息 函数功功能连接MO虚虚拟链路路到网关关返回值=0 标标识成功功 返返回值标标识一个个连接，在在以下的的函数中中使用0 标标识失败败参数说

10、明：参数名数据长度数据类型说明Conn_id4整型连接标识p_MOX结构体返回的MOO消息注意： 如果果没有MMO消息息将阻塞塞，直至至MO消消息到达达或连接接被网关关关闭7、 删除除短信（CMPP_Cancel） 函数功功能向网关提交交查询包包，并得得到查询询结果。返回值=0 标标识成功功 0 标标识失败败参数说明：参数名数据长度数据类型说明conn_id4整型连接标识msg_iid8无符号整型型消息 IDD，由网网关返回回p_Canncell_Rep_MMsgX结构体返回的删除除短信响响应结果果短连接（以以短连接接的方式式向网关关提交消消息，直直接调用用即可）函数功能向网关提交交短信返回值

11、=0 一一次连接接发送成成功0 连连接或发发送失败败 参数说说明：参数名数据长度数据类型说明gw_ipp20字符串网关的IPP地址port4短整型端口号，一一般为779000usernnamee6字符串SP的名称称passwwd20字符串密码p_msgg_idd8无符号整型型消息 IDD，由网网关返回回msg_lleveel1无符号整型型消息级别serviice_id10字符串业务代码msg_fformmat1无符号整型型消息格式0：ASCCII串串 33：短信信写卡操操作4：二进制制信息 8：UCSS2编码码15：含GGB汉字字 。msg_ssrc6字符串消息来源(SP_Id)fee_tty

12、pee2字符串计费类型01：对“计费用用户号码码”免费02：对“计费用用户号码码”按条计计信息费费03：对“计费用用户号码码”按包月月收取信信息费04：对“计费用用户号码码”的信息息费封顶顶05：对“计费用用户号码码”的收费费是由SSP实现现fee_ccodee6字符串资费代码，以以分为单单位validd_tiime14字符串存活时间，格格式为YYYYYYMMDDDHHHMISSSat_tiime14字符串发送时间，格格式为YYYYYYMMDDDHHHMISSStp_piid1无符号整型型参见GSMM03.40，一一般为00udhi1无符号整型型参见GSMM03.40，一一般为00fee_uu

13、serr_tyype1无符号整型型计费用户类类型0=对目的的手机收收费，11=对源源手机收收费，2=对SPP收费，33=对ccharrge_numm收费chargge_mmobiile21字符串收费手机号号，没有有写“0”src_mmobiile21字符串源手机号，没没有写“0“user_numm1无符号整型型接收手机个个数 1000dest_mobbilees21字符串接收手机号号码，以以空格分分隔msg160字符串消息内容msg_llen4整型消息长度need_ressponnse1无符号整型型是否需要状状态报告告0：不需要要1：需要2：取消包包月 检查MO消消息是否否是状态态报告（is_

14、status_report） 函数功功能判断MO包包是否为为状态报报告返回值=0 普普通MOO消息=1 状状态报告告参数说明：10、从MMO消息息得到状状态报告告（geet_sstattus_repportt） 函数功功能从MO包中中得到状状态报告告返回值状态报告指指针 参数说说明参数名数据长度数据类型说明p_MOX结构体CMPP_Gett_MOO得到的的结构体体11、链路路检测（CCMPPP_Acctivve） 函数功功能保持链路链链接正常常返回值0：错误误=0：正常常 参数说说明参数名数据长度数据类型说明Conn_id4整型连接标识三、 结结构体说说明1、查询结结果结构构体（QQuerry

15、_RRes）：参数名数据长度数据类型说明mt_tootall_mssg4无符号整型型从SP接收收的用户户总数mt_tootall_usser4无符号整型型从SP接收收的信息息总数mt_suucc4无符号整型型成功转发数数量mt_waait4无符号整型型待转发数量量mt_faail4无符号整型型转发失败数数量mo_suucc4无符号整型型向SP成功功送达数数量mo_waait4无符号整型型向SP待送送达数量量mo_faail4无符号整型型向SP送达达失败数数量2、MO消消息参数名数据长度数据类型说明msgIDD8整型消息IDdest_id21字符串接入号码serviice_id10字符串业务代码

16、tp_piid1无符号整型型见GSM003.440，通通常为00tp_uddhi1无符号整型型见GSM003.440，通通常为00msgFoormaat1无符号整型型消息格式sourcceUsser21字符串发送消息的的手机reg_ddeliiverr1无符号整型型是否为应答答消息，11=yees，00=noomsgLeen1无符号整型型消息长度msg160字符串消息内容3、状态报报告参数名数据长度数据类型说明msgIDD8整型消息ID，与与CMPPP_SSubmmit中中返回的的消息IID一一一对应stat7字符串状态submiit_ttimee10字符串提交时间，MMMDDDHHMMMSS

17、Sdone_timme10字符串完成时间，MMMDDDHHMMMSSSdestUUserr21字符串接收手机smsc_seqq4无符号整型型短信中心序序列号四、常量说说明1、状态报报告中的的状态：常量名说明DELIVVRD短信成功传传送EXPIRRED超过短信的的有效期期DELETTED短信被删除除UNDELLIV短信无法送送达ACCEPPTD处于被接受受状态UNKNOOWN处于非法状状态REJECCTD处于被拒绝绝状态DELIVVRD短信成功传传送2、错误码码常量名代表值说明ERRORR_OKK0正常ERRORR_SOOCKEET_CCREAATE-100创建socckett失败ERRORR

18、_COONNEECT-101联接到网关关失败ERRORR_SOOCKEET_WWRITTE-102写sockket失失败ERRORR_SOOCKEET_RREADD-103读sockket失失败ERRORR_ICCP_IID-104错误的SPP_IDDERRORR_AUUTH-105认证错误ERRORR_MSSG_LLEN-106短消息长度度错ERRORR_FEEE_CCODEE-107计费代码错错ERRORR_SEERVIICE_ID-108业务代码错错ERRORR_FLLOW_CONNTROOL-109流量控制错错ERRORR_SOOCKEET_CCLOSSE-110当对Socckett操

19、作时时，soockeet关闭闭ERRORR_INNTERRNALL-200内部错误，一一般为信信息结构构错ERRORR_UNNKNOOWN-201未知错误ERRORR_ARRGUMMENTT-202调用apii函数参参数错五、常见问问题解答答1、为何联联接到网网关时网网关回复复ERRROR_AUTTH 错误码码？答：深讯网网关在SP信息息里有企企业代码码、SPP名称、密密码三项项，网关关要求SSP鉴权权时填写写的用户户名为局局方分配配的SPP名称，而而不是企企业代码码，密码码为局方方分配的的SP密码码。2、为何联联接到网网关时网网关回复复ERRROR_SOCCKETT_REEAD错错误码？答：造成此此问题的的原因很很可能是是你的IIP同局局方管理理人员设设置的IIP不一一致。请请与局方方管理人人员核对对数据。3、为何向向网关提提交短信信时会返返回ERRRORR_MSSG_LLEN错错误码？答：CMPPP2.0