接口维护文档.docx

1、接口维护文档青海接口维护文档客服接口1、接口功能描述：客服与营帐系统的接口采用应用服务方式，通讯协议采用TCP/IP标准协议,营帐系统作为服务端，实时监听客服系统的业务请求并作出响应，提供客服系统所需的数据。接口数据有两种形式:请求包：由Client端发出业务请求,以请求包的形式传送至服务端,其中包括该项业务所需要的参数信息.应答包：服务端处理相应的业务请求并以应答包的形式返回数据.数据包由包头和包体构成：包头内容主要包括各种数据包的共同的基本信息,包体内容主要包括各种数据包的特有信息.2、接口程序：主机IP：130.70.1.213源程序路径：/home/bss/yygl/h2执行程序路径：

2、/home/bss/yygl/bin执行命令行：qhh2 h.ini程序检测端口：9921程序日志路径：/prog/h2/log3、接口维护：当前存在的主要问题：客服查询速度较慢，请检查/prog/h2/log下的告警和错误日志，如果拒绝请求的连接较多，则回复连接数过多。进程监控每天9：00，17：30登陆130.70.1.213主机检查客服接口程序qhh2（可执行代码在/home/bss/yygl/bin目录下）是否在运行。日志监控每天17：30登陆130.70.1.213主机，到/prog/h2/log目录下检查前一天和当天日志文件（ans.MMDD，err.MMDD，query.MMDD

3、）大小是否合理。检查h2.log和warn.log文件里面是否有异常错误。检查出异常情况后进行分析并联系技术经理（项目经理）和局方负责人说明情况。空间处理每天进行完日志监控之后，如没有异常，则将前一天的日志文件压缩（compress），并将文件转移到/prog/h2/log/bak目录下。数据来源：4、客服接口数据流程GSM基本资料查询连接校验关联的表：无数据流程：接口程序从请求包中取得返回连接状态的业务类型。查询：连接数据库状态，是否是连接状态！将连接状态组包，返回给接口响应包。用户身份验证关联的表：TAB_SUBSCRB 数据流程：接口程序从请求包中取得用户业务号码和用户密码。用业务号码查

4、询TAB_SUBSCRB表中，用户密码！用从表中取得的密码和接口传过来的密码进行校验。将校验结果组包，返回给接口响应包。用户档案查询关联的表：TAB_SUBSCRB 数据流程接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB表，取得用户的一些档案信息！将档案资料组包，返回给接口响应包。用户特服查询关联的表：TAB_SRVG , TAB_SUBSCRB数据流程接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB 表取得SUBSCRBID，关联TAB_ SRVG表，取得用户特服异动详细资料信息！将特服异动详细资料组包，返回给接口响应包。异动查询关联的表：U

5、SR_BUSI_RECORD数据流程：接口程序从请求包中取得用户业务号码。用业务号码查询USR_BUSI_RECORD表，取得用户所有的异动详细资料信息！将所有的异动详细资料信息组包，返回给接口响应包。PUK码查询(按电话号码查询)关联的表：TAB_SUBSCRB RES_MOB_CARD数据流程：接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB表，取得用户的SIMCARDID，再关联到RES_MOB_CARD取得用户SIM卡的PUK码将用户SIM卡的PUK码信息组包，返回给接口响应包PUK码查询(按SIM卡查询)关联的表：RES_MOB_CARD数据流程：接口程序从请

6、求包中取得用户业务号码。用的SIMC卡号查询RES_MOB_CARD，取得用户SIM卡的PUK码。将用户SIM卡的PUK码信息组包，返回给接口响应包。状态查询关联的表：TAB_SUBSCRB数据流程：接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB，取得用户当前的在网状态。将用户的在网状态组包，返回给接口响应包。信用级别查询关联的表：TAB_SUBSCRB TAB_PAYTYPE TAB_ACCT数据流程接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB取得用户ACCTID，关联TAB_ACCT取得PAY_MODE，再关联TAB_PAYTYPE取得

7、用户的信用级别。将信用级信息组包，返回给接口响应包。GSM话费查询月结话费帐单查询关联的表：TAB_SUBSCRB TAB_BILLDETAIL数据流程：接口程序从请求包中取得用户业务号码和帐期。用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期，取得用户的详细话费帐目信息。将详细话费帐目信息组包，返回给接口响应包。月结话费详单查询关联的表：TICKET_GSMCDMA_* TICKET_SMS_*数据流程：接口程序从请求包中取得用户业务号码和帐期。用业务号码和帐期查询TICKET_GSMCDMA_*与TICKET_SMS_*，取得两个

8、表联合查询的用户该月份话费详细帐单信息。将该月份话费详细帐单信息组包，返回给接口响应包。实时总帐查询关联的表：RATING2_REAL_FEE BILL_RENT_ACCT_DETAIL数据流程：接口程序从请求包中取得用户业务号码。用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。将实时话费的详细帐目信息组包，返回给接口响应包。实时清单查询关联的表：TICKET_GSMCDMA_* TICKET_SMS_*数据流程：接口程序从请求包中取得用户业务号码。用业务号码查询当月TICKET_GSMCDMA_

9、*与TICKET_SMS_*，取得两个表联合查询的用户当月实时话费详细帐单信息。将用户当月实时话费详细帐单信息组包，返回给接口响应包。帐户余额查询关联的表：TAB_SUBSCRB ACCT_BALANCE 数据流程：接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB取得ACCTID，关联ACCT_BALANCE查询得到用户当前的账户结余信息。将用户当前的账户结余信息组包，返回给接口响应包。GSM业务受理资料更改（除户名、 号码外）关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程：接口程序从请求包中取得用户业务号码,和需要修改的所有修改信息。用业务号

10、码关联TAB_SUBSCRB表，做更新操作，修改传过来要修改的所有字段。并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。将对用户资料修改的成功标志组包，返回给接口响应包。紧急停机关联的表：TAB_SUBSCRB USR_BUSI_RECORD 数据流程：接口程序从请求包中取得用户业务号码。将停机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行停机操作，并且修改TAB_SUBSCRB的用户状态为停机状态。将对用户紧急停机成功标志组包，返回给接口响应包。服务密码的修改关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程接口程序从

11、请求包中取得用户业务号码和需要修改的密码用业务号码关联TAB_SUBSCRB表，做更新操作，修改用户服务密码字段。并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。将对用户资料修改的成功标志组包，返回给接口响应包。有条件开机关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程接口程序从请求包中取得用户业务号码。将此次开机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SUBSCRB的用户状态为开机状态。将对用户有条件开机的成功标志组包，返回给接口响应包。特服档案修改关联的表：TAB_SUBSCRB U

12、SR_BUSI_RECORD TAB_SRVG USR_BUSI_SRVG数据流程接口程序从请求包中取得用户业务号码和异动特服类型和操作类型。将此次特服变更操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SRVG的用户特服状态操作类型状态，插入USR_BUSI_SRVG表记录此次特服变更的操作。将对用户特服变更的成功标志组包，返回给接口响应包。销户预约关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程接口程序从请求包中取得用户业务号码。将此次预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开

13、机操作,使本地交换机IMSI-MDN为禁用功能，并且修改TAB_SUBSCRB的用户状态为预约销户状态。将对用户有条件开机的成功标志组包，返回给接口响应包。取消销户预约关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程接口程序从请求包中取得用户业务号码。将此次取消预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为可用状态，并且修改TAB_SUBSCRB的用户状态为开机状态。将对用户有条件开机的成功标志组包，返回给接口响应包。CDMA服务类型数据流程CDMA基本资料查询连接校验关联的表无数据流程接口程序从请

14、求包中取得返回连接状态的业务类型。查询：连接数据库状态，是否是连接状态！将连接状态组包，返回给接口响应包。用户身份验证关联的表：TAB_SUBSCRB数据流程接口程序从请求包中取得用户业务号码和用户密码。用业务号码查询TAB_SUBSCRB表中，用户密码！用从表中取得的密码和接口传过来的密码进行校验。将校验结果组包，返回给接口响应包。用户档案查询关联的表：TAB_SUBSCRB数据流程接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB表，取得用户的一些档案信息！将档案资料组包，返回给接口响应包。用户特服查询关联的表：TAB_SRVG , TAB_SUBSCRB数据流程接口

15、程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB 表取得SUBSCRBID，关联TAB_ SRVG表，取得用户特服异动详细资料信息！将特服异动详细资料组包，返回给接口响应包。异动查询关联的表：USR_BUSI_RECORD数据流程接口程序从请求包中取得用户业务号码。用业务号码查询USR_BUSI_RECORD表，取得用户所有的异动详细资料信息！将所有的异动详细资料信息组包，返回给接口响应包。黑名单查询关联的表：TAB_SPECIALCUSTLST数据流程接口程序从请求包中取得用户证件号码。用证件号码查询TAB_SPECIALCUSTLST表，取得该证件是黑名单的详细信息！将

16、名单的详细信息组包，返回给接口响应包。黑名单验证关联的表：TAB_SPECIALCUSTLST数据流程：接口程序从请求包中取得用户证件号码。用证件号码查询TAB_SPECIALCUSTLST表，取得是否在黑名单列表中！将是否是黑名单用户状态组包，返回给接口响应包。预交流水查询(按电话号码查询)关联的表：TAB_PAY数据流程接口程序从请求包中取得用户业务号码。用业务号码查询TAB_PAY表，取得用户在开户以来所有的交费记录的详细信息！将用户在开户以来所有的交费记录的详细信息组包，返回给接口响应包PUK码查询(按电话号码查询)关联的表：TAB_SUBSCRB RES_MOB_CARD数据流程：接

17、口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB表，取得用户的SIMCARDID，再关联到RES_MOB_CARD取得用户SIM卡的PUK码将用户SIM卡的PUK码信息组包，返回给接口响应包PUK码查询(按SIM卡查询)关联的表：RES_MOB_CARD数据流程接口程序从请求包中取得用户业务号码。用的SIMC卡号查询RES_MOB_CARD，取得用户SIM卡的PUK码。将用户SIM卡的PUK码信息组包，返回给接口响应包。状态查询关联的表：TAB_SUBSCRB数据流程：接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB，取得用户当前的在网状态。将用户

18、的在网状态组包，返回给接口响应包。信用级别查询关联的表：TAB_SUBSCRB TAB_PAYTYPE TAB_ACCT数据流程接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB取得用户ACCTID，关联TAB_ACCT取得PAY_MODE，再关联TAB_PAYTYPE取得用户的信用级别。将信用级信息组包，返回给接口响应包。CDMA话费查询月结话费帐单查询关联的表：TAB_SUBSCRB TAB_BILLDETAIL数据流程接口程序从请求包中取得用户业务号码和帐期。用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期

19、，取得用户的详细话费帐目信息。将详细话费帐目信息组包，返回给接口响应包。月结话费详单查询关联的表：TICKET_GSMCDMA_* TICKET_SMS_*数据流程：接口程序从请求包中取得用户业务号码和帐期。用业务号码和帐期查询TICKET_GSMCDMA_*与TICKET_SMS_*，取得两个表联合查询的用户该月份话费详细帐单信息。将该月份话费详细帐单信息组包，返回给接口响应包。实时总帐查询关联的表：RATING2_REAL_FEE BILL_RENT_ACCT_DETAIL数据流程：接口程序从请求包中取得用户业务号码。用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT

20、_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。将实时话费的详细帐目信息组包，返回给接口响应包。实时清单查询关联的表：TICKET_GSMCDMA_* TICKET_SMS_*数据流程接口程序从请求包中取得用户业务号码。用业务号码查询当月TICKET_GSMCDMA_*与TICKET_SMS_*，取得两个表联合查询的用户当月实时话费详细帐单信息。将用户当月实时话费详细帐单信息组包，返回给接口响应包。帐户余额查询关联的表：TAB_SUBSCRB ACCT_BALANCE数据流程： 接口程序从请求包中取得用户业务号码。用业务号码查询TAB_SUBSCRB取得ACCTID，

21、关联ACCT_BALANCE查询得到用户当前的账户结余信息。将用户当前的账户结余信息组包，返回给接口响应包。CDMA业务受理资料更改（除户名、 号码外）关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程接口程序从请求包中取得用户业务号码,和需要修改的所有修改信息。用业务号码关联TAB_SUBSCRB表，做更新操作，修改传过来要修改的所有字段。并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。将对用户资料修改的成功标志组包，返回给接口响应包。紧急停机关联的表：TAB_SUBSCRB USR_BUSI_RECORD 数据流程接口程序从请求包中取得用户业务

22、号码。将停机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行停机操作，并且修改TAB_SUBSCRB的用户状态为停机状态。将对用户紧急停机成功标志组包，返回给接口响应包。服务密码的修改关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程：接口程序从请求包中取得用户业务号码和需要修改的密码用业务号码关联TAB_SUBSCRB表，做更新操作，修改用户服务密码字段。并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。将对用户资料修改的成功标志组包，返回给接口响应包。有条件开机关联的表：TAB_SUBSCRB USR_BUSI_RECO

23、RD数据流程接口程序从请求包中取得用户业务号码。将此次开机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SUBSCRB的用户状态为开机状态。将对用户有条件开机的成功标志组包，返回给接口响应包。特服档案修改关联的表：TAB_SUBSCRB USR_BUSI_RECORD TAB_SRVG USR_BUSI_SRVG数据流程接口程序从请求包中取得用户业务号码和异动特服类型和操作类型。将此次特服变更操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SRVG的用户特服状态操作类型状态，插入USR_B

24、USI_SRVG表记录此次特服变更的操作。将对用户特服变更的成功标志组包，返回给接口响应包。销户预约关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程接口程序从请求包中取得用户业务号码。将此次预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为禁用功能，并且修改TAB_SUBSCRB的用户状态为预约销户状态。将对用户有条件开机的成功标志组包，返回给接口响应包。取消销户预约关联的表：TAB_SUBSCRB USR_BUSI_RECORD数据流程：接口程序从请求包中取得用户业务号码。将此次取消预约销户记录进US

25、R_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为可用状态，并且修改TAB_SUBSCRB的用户状态为开机状态。将对用户有条件开机的成功标志组包，返回给接口响应包。VOIP服务类型数据流程VOIP基本资料查询IP Phone 身份验证关联的表：TAB_SUBSCRB数据流程接口程序从请求包中取得用户业务号码和用户密码。用业务号码查询TAB_SUBSCRB表中，用户密码！用从表中取得的密码和接口传过来的密码进行校验。将校验结果组包，返回给接口响应包。IP Phone用户档案查询关联的表: TAB_SUBSCRB数据流程: 接口程序从请求包中取得用

26、户业务号码。用业务号码查询TAB_SUBSCRB表，取得用户的一些档案信息！将档案资料组包，返回给接口响应包。IP Phone用户通过卡号或电话号码月结话费查询关联的表: TAB_SUBSCRB TAB_BILLDETAIL数据流程: 接口程序从请求包中取得用户业务号码和帐期。用业务号码和帐期查询TICKET_GSMCDMA_*与TICKET_SMS_*，取得两个表联合查询的用户该月份话费详细帐单信息。将该月份话费详细帐单信息组包，返回给接口响应包。IP Phone用户通过卡号或电话号码实时话费查询关联的表: RATING2_REAL_FEE BILL_RENT_ACCT_DETAIL数据流程

27、:接口程序从请求包中取得用户业务号码。用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。将实时话费的详细帐目信息组包，返回给接口响应包。IP Phone通过卡号查询所有电话号码关联的表:TAB_SUBSCRB数据流程:接口程序从请求包中取得用户业务号码。用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。将实时话费的详细帐目信息组包，返回给接口响应包。IP Phone通过电话号码查卡号、用户名关联的表:TA

28、B_VOIPSUBSCRB数据流程:接口程序从请求包中取得用户业务号码。用业务号码查询TAB_VOIPSUBSCRB，取用户业务号码对应绑定的电话号码信息。将用户业务号码对应绑定的电话号码信息组包，返回给接口响应包。IP Phone通过卡号或手机号码查询相同CUSID用户关联的表:TAB_SUBSCRB 数据流程:接口程序从请求包中取得用户业务号码。用业务号码查询TAB_VOIPSUBSCRB，取用户业务号码对应绑定的CUSTID,再通过CUSTID查询在用户表中相同客户号码的用户业务号码信息！将相同客户号码的用户业务号码信息组包，返回给接口响应包。IP Phone通过卡号或绑定号码查询详单关

29、联的表:TICKET_163_*数据流程:接口程序从请求包中取得用户业务号码和帐期。用业务号码和帐期查询TICKET_193_*联合查询的用户该月份话费详细帐单信息。将该月份话费详细帐单信息组包，返回给接口响应包。IP Phone通过卡号查询预交款缴费记录关联的表:TAB_PAY数据流程:接口程序从请求包中取得用户业务号码。用业务号码查询TAB_PAY表，取得用户在开户以来所有的交费记录的详细信息！将用户在开户以来所有的交费记录的详细信息组包，返回给接口响应包IP Phone通过卡号查询服务异动记录关联的表:TAB_SRVG , TAB_SUBSCRB数据流程:接口程序从请求包中取得用户业务号

30、码。用业务号码查询TAB_SUBSCRB 表取得SUBSCRBID，关联TAB_ SRVG表，取得用户特服异动详细资料信息！将特服异动详细资料组包，返回给接口响应包。IP Phone 通过卡号查询指令执行记录关联的表:USR_BUSI_RECORD数据流程:接口程序从请求包中取得用户业务号码。用业务号码查询USR_BUSI_RECORD表，取得用户所有的异动详细资料信息！将所有的异动详细资料信息组包，返回给接口响应包。CDMA1X服务类型数据流程CDMA1X基本资料查询CDMA1X用户月结话费查询关联的表:TAB_SUBSCRB TAB_BILLDETAIL数据流程:接口程序从请求包中取得用户业务号码和帐期。用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期，取得用户的详细话费帐目信息。将详细话费帐目信息组包，返回给接口响应包。CDMA1X用户实时话费查询关联的表接口接收到身份验证的请求包