联通短信应用程序使用说明sgip v或语言.pdfVIP

SGIPAPI应用程序使用说明(sgipv1.2)_C/C++语言版本

一、概述

本接口遵循SGIPv1.2协议标准，以提供消息发送和接收函数的方式，向SP提供同联

通网关进行信息交换的实现途径。客户可以依据具体需要，利用所提供的函数实现与

网关的单连接或者多连接发送或接收消息。

二、文件说明

1.API配置文件说明

sgipapi.ini配置文件

[SYSTEM]

;SP与GW之间所建立的发送链路数，1～20条，缺省为1条

SUBMIT_LINKNUM=1

补充说明:这里配置的是API发消息到网关时的链路数。如果单链路不能满足现场的使用

要求，需要提高API接口性能时，可把该参数调大，但是必须注意需要网关侧支持建立相应链

路数，且最大链路数过20条。若采用多链路向网关发送消息，需要网关不对下发消息

的消息序列号顺序做检查。如果网关对消息序列号的下发顺序做检查，可能返回9的错误码。

;SP与GW之间所建立的接收链路数，1～5条，缺省为1条

DELIVER_LINKNUM=1

补充说明:与发送消息相类似，接收消息时如果单链路不能满足使用要求时，可考虑将接

收链路数调大，当然也需要网关侧的支持，且最大数过5条。

;下行消息回响应消息超时时间，1～30秒，缺省为5秒

MTRESP_TIME_OUT_SEC=5

补充说明:API发消息到网关后，需要同步等待相应的应答，该参数设置的就是最长等待时

间。如果某条消息超时，发送消息接口函数将自动返回，不再等待。

;上行消息处理最大时间间隔，5～30秒，缺省为30秒

MOPROC_TIME_OUT_SEC=30

补充说明:API收到网关的消息后，会先把消息放入API的消息队列中等待SP应用程

序去取，该参数设置的就是等待处理的最长时间。如果API收到某条消息，

MOPROC_TIME_OUT_SEC秒后SP应用程序都未来获取消息，则API会把该消息丢弃并将该

消息写到丢弃消息日志（throwmsgXX，XX表示00到99的序列号）中，应用程序将无法接收

到该消息。

;上行消息接收队列大小，10000～100000条，缺省为10000条

MOPROC_QUEEN_SIZE=10000

补充说明:API的接收消息队列大小配置项。如果该队列满，则API会把最早进入该消

息队列的消息丢弃，并将该消息写到丢弃消息日志（throwmsgXX，XX表示00到99的序列号）

中。

;日志级别，0（操作系统出错日志），1（OS函数调用出错日志），2（链路出错日志），3（业

务出错日志），4（消息内容日志），5（接收消息队列大小）默认为级别3

LOG_LEVEL=3

补充说明:API运行日志是为了方便API发布商和排查问题或使用API的第