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

1、更多企业业学院：中小企企业管理理全能版版183套套讲座+897700份份资料总经理理、高层层管理49套讲讲座+1163888份资料中层管管理学院院46套讲讲座+660200份资料国学智智慧、易易经46套讲讲座人力资资源学院院56套讲讲座+2271223份资料各阶段段员工培培训学院院77套讲讲座+ 3244份资料员工管管理企业业学院67套讲讲座+ 87220份资料工厂生生产管理理学院52套讲讲座+ 139920份份资料财务管管理学院院53套讲讲座+ 179945份份资料销售经经理学院院56套讲讲座+ 143350份份资料销售人人员培训训学院72套讲讲座+ 48779份资料更多企业业学院：中小企企

2、业管理理全能版版183套套讲座+897700份份资料总经理理、高层层管理49套讲讲座+1163888份资料中层管管理学院院46套讲讲座+660200份资料国学智智慧、易易经46套讲讲座人力资资源学院院56套讲讲座+2271223份资料各阶段段员工培培训学院院77套讲讲座+ 3244份资料员工管管理企业业学院67套讲讲座+ 87220份资料工厂生生产管理理学院52套讲讲座+ 139920份份资料财务管管理学院院53套讲讲座+ 179945份份资料销售经经理学院院56套讲讲座+ 143350份份资料销售人人员培训训学院72套讲讲座+ 48779份资料短信网关关SP端端应用程程序接口口使用说说明-

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

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

5、_Coonneect 返回回的连接接标识p_mssg_iid8无符号整整型消息 IID，由由网关返返回msg_levvel1无符号整整型消息级别别servvicee_idd10字符串业务代码码msg_forrmatt1无符号整整型消息格式式0：ASSCIII串 3：短短信写卡卡操作4：二进进制信息息 88：UCCS2编编码15：含含GB汉汉字。msg_srcc6字符串消息来源源(SPP_Idd)fee_typpe2字符串计费类型型01：对对“计费用用户号码码”免费02：对对“计费用用户号码码”按条计计信息费费03：对对“计费用用户号码码”按包月月收取信信息费04：对对“计费用用户号码码”的信息

6、息费封顶顶05：对对“计费用用户号码码”的收费费是由SSP实现现fee_codde6字符串资费代码码，以分分为单位位valiid_ttimee14字符串存活时间间，格式式为YYYYYMMMDDDHHMMISSSat_ttimee14字符串发送时间间，格式式为YYYYYMMMDDDHHMMISSStp_ppid1无符号整整型参见GSSM033.400，一般般为0udhii1无符号整整型参见GSSM033.400，一般般为0fee_useer_ttypee1无符号整整型计费用户户类型0=对目目的手机机收费，1=对对源手机机收费，2=对SSP收费费，3=对chhargge_nnum收收费charrg

7、e_mobbilee21字符串收费手机机号，没没有写“0”src_mobbilee21字符串源手机号号，没有有写“0“userr_nuum1无符号整整型接收手机机个数 1000destt_moobilles21字符串接收手机机号码，以空格格分隔msg160字符串消息内容容msg_lenn4整型消息长度度needd_reespoonsee1无符号整整型是否需要要状态报报告0：不需需要1：需要要2：生成成包月话话单 注意：如果建建立好连连接后一一段时间间没有发发送消息息，网关关将关闭闭连接，CMPPP_Suubmiit返回回ERRROR_SOCCKETT_CLLOSEE ，这这时，必必须重新新建立

8、连连接并发发送消息息3、 查查询网关关（CMMPP_Queery） 函数数功能向网关提提交查询询包，并并得到查查询结果果。返回值=0 标识成成功 0 标识失失败参数说明明：参数名数据长度度数据类型型说明connn_idd4整型连接标识识datee8字符串日期，格格式为yyyyyymmdddtypee1无符号整整型查询类型型0=查查询总数数，1=按业务务代码查查询servvicee10字符串查询代码码当Queery_Typpe为00时，此此项无效效；当Queery_Typpe为11时，此此项填写写业务类类型Seerviice_Id.p_reesX结构体返回的结结构体注意：useernaame是是

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

10、 返回值值标识一一个连接接，在以以下的函函数中使使用0 标识失失败参数说明明：参数名数据长度度数据类型型说明Connn_idd4整型连接标识识p_MOOX结构体返回的MMO消息息注意： 如如果没有有MO消消息将阻阻塞，直直至MOO消息到到达或连连接被网网关关闭闭7、 删删除短信信（CMMPP_Canncell） 函数数功能向网关提提交查询询包，并并得到查查询结果果。返回值=0 标识成成功 0 标识失失败参数说明明：参数名数据长度度数据类型型说明connn_idd4整型连接标识识msg_id8无符号整整型消息 IID，由由网关返返回p_Caanceel_Rep_MsggX结构体返回的删删除短信信

11、响应结结果短连接（以短连连接的方方式向网网关提交交消息，直接调调用即可可）函数功能能向网关提提交短信信返回值=0 一次连连接发送送成功0 连接或或发送失失败 参数数说明：参数名数据长度度数据类型型说明gw_iip20字符串网关的IIP地址址portt4短整型端口号，一般为为79000userrnamme6字符串SP的名名称passswd20字符串密码p_mssg_iid8无符号整整型消息 IID，由由网关返返回msg_levvel1无符号整整型消息级别别servvicee_idd10字符串业务代码码msg_forrmatt1无符号整整型消息格式式0：ASSCIII串 3：短短信写卡卡操作4：二

12、进进制信息息 88：UCCS2编编码15：含含GB汉汉字。msg_srcc6字符串消息来源源(SPP_Idd)fee_typpe2字符串计费类型型01：对对“计费用用户号码码”免费02：对对“计费用用户号码码”按条计计信息费费03：对对“计费用用户号码码”按包月月收取信信息费04：对对“计费用用户号码码”的信息息费封顶顶05：对对“计费用用户号码码”的收费费是由SSP实现现fee_codde6字符串资费代码码，以分分为单位位valiid_ttimee14字符串存活时间间，格式式为YYYYYMMMDDDHHMMISSSat_ttimee14字符串发送时间间，格式式为YYYYYMMMDDDHHMM

13、ISSStp_ppid1无符号整整型参见GSSM033.400，一般般为0udhii1无符号整整型参见GSSM033.400，一般般为0fee_useer_ttypee1无符号整整型计费用户户类型0=对目目的手机机收费，1=对对源手机机收费，2=对SSP收费费，3=对chhargge_nnum收收费charrge_mobbilee21字符串收费手机机号，没没有写“0”src_mobbilee21字符串源手机号号，没有有写“0“userr_nuum1无符号整整型接收手机机个数 1000destt_moobilles21字符串接收手机机号码，以空格格分隔msg160字符串消息内容容msg_lenn

14、4整型消息长度度needd_reespoonsee1无符号整整型是否需要要状态报报告0：不需需要1：需要要2：取消消包月 检查MOO消息是是否是状状态报告告（iss_sttatuus_rrepoort） 函数数功能判断MOO包是否否为状态态报告返回值=0 普通MMO消息息=1 状态报报告参数说明明：10、从从MO消消息得到到状态报报告（gget_staatuss_reeporrt） 函数数功能从MO包包中得到到状态报报告返回值状态报告告指针 参数数说明参数名数据长度度数据类型型说明p_MOOX结构体CMPPP_Geet_MMO得到到的结构构体11、链链路检测测（CMMPP_Acttivee）

15、函数数功能保持链路路链接正正常返回值0：错错误=0：正正常 参数数说明参数名数据长度度数据类型型说明Connn_idd4整型连接标识识三、 结构体体说明1、查询询结果结结构体（Queery_Ress）：参数名数据长度度数据类型型说明mt_ttotaal_mmsg4无符号整整型从SP接接收的用用户总数数mt_ttotaal_uuserr4无符号整整型从SP接接收的信信息总数数mt_ssuccc4无符号整整型成功转发发数量mt_wwaitt4无符号整整型待转发数数量mt_ffaill4无符号整整型转发失败败数量mo_ssuccc4无符号整整型向SP成成功送达达数量mo_wwaitt4无符号整整型向

16、SP待待送达数数量mo_ffaill4无符号整整型向SP送送达失败败数量2、MOO消息参数名数据长度度数据类型型说明msgIID8整型消息IDDdestt_idd21字符串接入号码码servvicee_idd10字符串业务代码码tp_ppid1无符号整整型见GSMM03.40，通常为为0tp_uudhii1无符号整整型见GSMM03.40，通常为为0msgFFormmat1无符号整整型消息格式式sourrceUUserr21字符串发送消息息的手机机reg_delliveer1无符号整整型是否为应应答消息息，1=yess，0=nomsgLLen1无符号整整型消息长度度msg160字符串消息内容容

17、3、状态态报告参数名数据长度度数据类型型说明msgIID8整型消息IDD，与CCMPPP_Suubmiit中返返回的消消息IDD一一对对应statt7字符串状态submmit_timme10字符串提交时间间，MMMDDHHHMMMSSdonee_tiime10字符串完成时间间，MMMDDHHHMMMSSdesttUseer21字符串接收手机机smscc_seeq4无符号整整型短信中心心序列号号四、常量量说明1、状态态报告中中的状态态：常量名说明DELIIVRDD短信成功功传送EXPIIREDD超过短信信的有效效期DELEETEDD短信被删删除UNDEELIVV短信无法法送达ACCEEPTDD处

18、于被接接受状态态UNKNNOWNN处于非法法状态REJEECTDD处于被拒拒绝状态态DELIIVRDD短信成功功传送2、错误误码常量名代表值说明ERROOR_OOK0正常ERROOR_SSOCKKET_CREEATEE-1000创建soockeet失败败ERROOR_CCONNNECTT-1011联接到网网关失败败ERROOR_SSOCKKET_WRIITE-1022写socckett失败ERROOR_SSOCKKET_REAAD-1033读socckett失败ERROOR_IICP_ID-1044错误的SSP_IIDERROOR_AAUTHH-1055认证错误误ERROOR_MMSG_LEN

19、N-1066短消息长长度错ERROOR_FFEE_CODDE-1077计费代码码错ERROOR_SSERVVICEE_IDD-1088业务代码码错ERROOR_FFLOWW_COONTRROL-1099流量控制制错ERROOR_SSOCKKET_CLOOSE-1100当对Soockeet操作作时，ssockket关关闭ERROOR_IINTEERNAAL-2000内部错误误，一般般为信息息结构错错ERROOR_UUNKNNOWNN-2011未知错误误ERROOR_AARGUUMENNT-2022调用appi函数数参数错错五、常见见问题解解答1、为何何联接到到网关时时网关回回复ERRRORR_AUUTH错错误码？答：深讯讯网关在在SP信息息里有企企业代码码、SPP名称、密码三三项，网网关要求求SP鉴权权时填写写的用户户名为局局方分配配的SPP名称，而不是是企业代代码，密密码为局局方分配配的SPP密码。2、为何何联接到到网关时时网关回回复ERRRORR_SOOCKEET_RREA