infoXMAS API接口说明DB.docx
《infoXMAS API接口说明DB.docx》由会员分享，可在线阅读，更多相关《infoXMAS API接口说明DB.docx（18页珍藏版）》请在冰豆网上搜索。
infoXMASAPI接口说明DB
目录
1数据库方式通信适配插件接口1-1
1.1数据库组网方式1-1
1.1.2数据库表结构定义1-2
1.1.3短信数据库表结构1-2
1.1.4定位数据库表结构1-5
1.1.5彩信数据库表结构1-7
1.1.6WAPPUSH数据库表结构1-10
插图目录
图1-1组网方式一1-1
图1-2组网方式二1-2
1
数据库方式通信适配插件接口
数据库方式通信适配插件为MAS服务器内部各模块和插件以及集团客户应用之间提供统一格式的接口，用于实现通信请求及响应。
此文对数据库方式的接口做出具体格式的说明。
1.1数据库组网方式
MAS服务器数据库方式通信适配插件所对应的数据库组网方式有以下两种。
第一种方式，由集团客户提供一个交互用的数据库服务器，要求数据库的结构满足本规范中定义的表结构要求。
如图1-1所示。
图1-1组网方式一
第二种方式，MAS服务器上提供一个符合规范定义的结构要求的标准数据库，供与集团客户应用之间的业务数据交互。
如图1-2所示。
图1-2组网方式二
1.1.2数据库表结构定义
MAS服务器数据库方式通信适配插件支持以下通信能力的数据交互：
●短信
●彩信
●定位
●WAPPUSH
1.1.3短信数据库表结构
短信待发送表（SMS_OUTBOX）
字段名
约束
可否为空
Default
类型
长度
备注
SISMSID
PK
N
VARCHAR
50
UUID/GUID（由应用侧产生）
EXTCODE
Y
VARCHAR
21
扩展号码
DESTADDR
N
VARCHAR
2000
接受手机MSISDN,多个用“;”分割,最大不超过50个
MESSAGECONTENT
N
VARCHAR
2000
短信内容
当MSGFMT为4时,消息内容为十六进制字符串
REQDELIVERYREPORT
N
0
Int
4
是否需要状态报告
0：
不需要
1：
需要
MSGFMT
N
0
Int
4
消息类型
0：
ASCII
4：
Binary
8：
usc2
15：
gb2312
16：
gb18030
SENDMETHOD
N
0
Int
4
0：
普通短信
1：
普通短信立即显示
2：
长短信组包
3：
带结构短信
REQUESTTIME
INDEX
N
NOW
DateTime
入库时间（短信发送请求时间）
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件仅有插入的权限，无读取权限，插入短信也无法取消。
数据库方式适配插件读取相关数据后，自行删除该记录，并转存储到SMS_SENT内。
短信已处理表（SMS_SENT）
字段名
约束
可否为空
Default
类型
长度
备注
MASSMSID
PK
N
VARCHAR
50
MAS产生的ID
GWSMSID
Y
VARCHAR
50
行业网关产生的MsgID
SISMSID
INDEX
N
VARCHAR
50
UUID/GUID（从SMS_OUTBOX表带来）
EXTCODE
N
VARCHAR
21
扩展代码
DESTADDR
N
VARCHAR
21
单个手机号码
REQUESTTIME
N
DateTime
入库时间（从SMS_OUTBOX表带来）
SENTTIME
N
NOW
DateTime
提交到行业网关的时间
SENTRESULT
N
Int
4
对应CMPP_SUBMIT的返回值
SMSSTATUS
Y
VARCHAR
20
如果用户需要状态报告，发送成功后状态报告保存在此字段
STATUSTIME
Y
DateTime
收到状态报告的时间
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDATE。
要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
上行短信表（SMS_INBOX）
字段名
约束
可否为空
Default
类型
长度
备注
MASSMSID
PK
N
VARCHAR
50
MAS产生的ID
EXTCODE
Y
VARCHAR
21
扩展号码（可以为空）
SOURCEADDR
INDEX
N
VARCHAR
21
单个手机号码
RECEIVETIME
N
NOW
DATETIME
短信接收时间
MESSAGECONTENT
Y
VARCHAR
400
当MSGFMT为4时,消息内容为十六进制字符串
MSGFMT
N
0
Int
4
消息类型
0：
ASCII
4：
Binary
8：
usc2
15：
gb2312
16：
gb18030
REQUESTTIME
N
NOW
DateTime
短信发送入库时间（同SMS_OUTBOX）
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDATE。
要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
1.1.4定位数据库表结构
定位请求表（LBS_REQUEST）
字段名
约束
可否为空
Default
类型
长度
备注
SILBSID
PK
N
VARCHAR
50
SI产生的ID（UUID/GUID）
MSISDN
INDEX
N
VARCHAR
20
单手机号
REQUESTTIME
INDEX
N
NOW
DateTime
请求时间
LOCTYPE
N
1
Int
4
定位类型
1：
CURRENT
2：
LAST
3：
CURRENT_OR_LAST
PERIODIC
N
1
Int
4
1：
单次定位
2：
周期定位
FREQUENCY
N
Int
4
通知的最大频率（单位为秒）
DURATION
N
Int
4
周期定位的时长（单位为秒）
REQUESTEDACCURACY
N
Int
4
请求的位置信息的精确度，用米表示
ACCEPTABLEACCURACY
N
Int
4
响应可接受的精确度，用米表示
MAXIMUMAGE
N
Int
4
返回的位置信息的最大可接受时限,用秒表示.
RESPONSETIME
N
Int
4
指示应用能接受的等待响应的最大时间，用秒表示
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件提请数据申请,插入记录。
MAS服务器向LBS平台发起请求，取得经纬度数据，删除记录，返回结果记录在定位结果表LBS_RESULT中。
EC应用/SI应用插件可INSERT，不可DELETE，不可SELECT，不可UPDATE。
定位结果表（LBS_RESULT）
字段名
约束
可否为空
Default
类型
长度
备注
MASLBSID
PK
N
VARCHAR
50
MAS产生的ID
SILBSID
N
VARCHAR
50
SI产生的ID（UUID/GUID同LBS_REQUEST）
MSISDN
INDEX
N
VARCHAR
20
单手机号
REQUESTTIME
N
DateTime
请求时间
UPDATETIME
N
DateTime
MAS更新响应时间
ERRORCODE
Y
VARCHAR
10
错误代码
ERRORMESSAGE
Y
VARCHAR
500
错误信息
LONGTITUDE
Y
VARCHAR
40
可为NULL,经度
LATITUDE
Y
VARCHAR
40
可为NULL,纬度
ALTITUDE
Y
VARCHAR
40
可为NULL,海拔
ACCURACY
Y
VARCHAR
40
可为NULL,精度（米）
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDATE。
要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
周期定位取消表（LBS_CANCEL）
字段名
约束
可否为空
Default
类型
长度
备注
SILBSID
PK
N
VARCHAR
50
周期性定位SI产生的ID（与LBS_REQUEST表中对应）
REQUESTTIME
N
NOW
DateTime
请求取消定位时间
APPLICATIONID
INDEX
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可INSERT，不可SELECT，DELETE和UPDATE。
数据库方式适配插件处理完成自动删除该记录。
1.1.5彩信数据库表结构
彩信发送表（MMS_OUTBOX）
字段名
约束
可否为空
Default
类型
长度
备注
SIMMSID
PK
N
VARCHAR
50
UUID/GUID（由AP产生）
EXTCODE
Y
VARCHAR
21
扩展号码
DESTADDR
N
VARCHAR
2000
接受手机MSISDN,多人用“;”分割,最大不超过50人
REQDELIVERYREPORT
N
0
Int（0/1）
4
是否需要状态报告
0：
不需要
1：
需要
SUBJECT
N
VARCHAR
500
彩信标题
MESSAGECONTENT
Y
TEXT/CLOB/BLOB
500KB
MIME组包或SMIL格式文件
REQUESTTIME
INDEX
N
NOW
DateTime
入库时间
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件仅有插入的权限，无读取权限，插入彩信也无法取消。
数据库方式适配插件读取相关数据后，自行删除该记录，并转存储到MMS_SENT内。
彩信已处理表（MMS_SENT）
字段名
约束
可否为空
Default
类型
长度
备注
MASMMSID
PK
N
VARCHAR
50
MAS产生的ID
GWMMSID
Y
VARCHAR
50
行业网关产生的MsgID
SIMMSID
N
VARCHAR
50
UUID/GUID（从MMS_OUTBOX表带来）
DESTADDR
N
VARCHAR
21
单个手机号码
SENTTIME
N
DateTime
提交到行业网关的时间
SENTRESULT
N
int
4
对应SUBMITREQ的返回值
MMSSTATUS
Y
VARCHAR
40
如果用户需要状态报告，发送成功后状态报告保存在此字段
STATUSTIME
Y
DateTime
收到状态报告的时间
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDATE。
要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
彩信接收表（MMS_INBOX）
字段名
约束
可否为空
Default
类型
长度
备注
MASMMSID
PK
N
VARCHAR
50
MAS产生的ID
EXTCODE
Y
VARCHAR
21
扩展号码（可以为空）
SOURCEADDR
N
VARCHAR
21
单个手机号码
RECEIVETIME
N
DATETIME
彩信接收时间
SUBJECT
N
VARCHAR
500
彩信标题
MESSAGECONTENT
Y
TEXT/CLOB/BLOB
500KB
MIME组包或SMIL格式文件
REQUESTTIME
N
DateTime
入库时间
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDATE。
要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
1.1.6WAPPUSH数据库表结构
WAPPUSH待发送表（WAPPUSH_OUTBOX）
字段名
约束
可否为空
Default
类型
长度
备注
SIWAPPUSHID
PK
N
VARCHAR
50
UUID/GUID（由AP产生）
EXTCODE
Y
VARCHAR
21
扩展号码
DESTADDR
N
VARCHAR
2000
接受手机MSISDN,多人用“;”分割,最大不超过50人
SUBJECT
N
VARCHAR
500
主题
REQDELIVERYREPORT
N
0
int
4
是否需要状态报告
0：
不需要
1：
需要
TARGETURL
N
VARCHAR
500
推送URL地址
REQUESTTIME
INDEX
N
NOW
DateTime
入库时间（短信发送请求时间）
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件仅有插入的权限，无读取权限，插入记录也无法取消。
数据库方式适配插件读取相关数据后,自行删除该记录，并转存储到WAPPUSH_SENT内。
WAPPUSH已处理表（WAPPUSH_SENT）
字段名
约束
可否为空
Default
类型
长度
备注
MASWAPPUSHID
PK
N
VARCHAR
50
MAS产生的ID
GWWAPPUSHID
Y
VARCHAR
50
行业网关产生的MsgID
SIWAPPUSHID
N
VARCHAR
50
UUID/GUID（从WAPPUSH_OUTBOX表带来）
EXTCODE
N
VARCHAR
21
扩展代码
DESTADDR
N
VARCHAR
21
单个手机号码
REQUESTTIME（INDEX）
N
DateTime
入库时间（从WAPPUSH_OUTBOX表带来）
SENTTIME
INDEX
N
NOW
DateTime
提交到行业网关的时间
SENTRESULT
N
int
4
对应CMPP_SUBMIT的返回值
WAPPUSHSTATUS
Y
VARCHAR
20
如果用户需要状态报告，发送成功后状态报告保存在此字段
STATUSTIME
Y
DateTime
收到状态报告的时间
APPLICATIONID
N
VARCHAR
16
EC/SI应用的ID
EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDATE。
要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
升级会员 