接口维护文档
青海接口维护文档
客服接口
1、接口功能描述：
客服与营帐系统的接口采用应用服务方式，通讯协议采用TCP/IP标准协议,营帐系统作为服务端，实时监听客服系统的业务请求并作出响应，提供客服系统所需的数据。
⏹接口数据有两种形式:
✓请求包：由Client端发出业务请求,以请求包的形式传送至服务端,其中包括该项业务所需要的参数信息.
✓应答包：服务端处理相应的业务请求并以应答包的形式返回数据.
✓数据包由包头和包体构成：包头内容主要包括各种数据包的共同的基本信息,包体内容主要包括各种数据包的特有信息.
2、接口程序：
主机IP：130.70.1.213
源程序路径：/home/bss/yygl/h2
执行程序路径：/home/bss/yygl/bin
执行命令行：qhh2 h.ini
程序检测端口：9921
程序日志路径：/prog/h2/log
3、接口维护：
当前存在的主要问题：客服查询速度较慢，请检查/prog/h2/log下的告警和错误日志，如果拒绝请求的连接较多，则回复连接数过多。
进程监控
每天9：00，17：30登陆130.70.1.213主机检查客服接口程序qhh2（可执行代码在/home/bs
s/yygl/bin目录下）是否在运行。
日志监控
每天17：30登陆130.70.1.213主机，到/prog/h2/log目录下检查前一天和当天日志文件（ans.MMDD，err.MMDD，query.MMDD）大小是否合理。检查h2.log和warn.log文件里面是否有异常错误。检查出异常情况后进行分析并联系技术经理（项目经理）和局方负责人说明情况。
空间处理
每天进行完日志监控之后，如没有异常，则将前一天的日志文件压缩（compress），并将文件转移到/prog/h2/log/bak目录下。
数据来源：
4、客服接口数据流程
GSM基本资料查询
连接校验关联的表：无
数据流程：
接口程序从请求包中取得返回连接状态的业务类型。
查询：连接数据库状态，是否是连接状态！
将连接状态组包，返回给接口响应包。
用户身份验证
关联的表：TAB_SUBSCRB 
数据流程：
接口程序从请求包中取得用户业务号码和用户密码。
用业务号码查询TAB_SUBSCRB表中，用户密码！
用从表中取得的密码和接口传过来的密码进行校验。
将校验结果组包，返回给接口响应包。
用户档案查询
关联的表：TAB_SUBSCRB
数据流程
接口程序从请求包中取得用户业务号码。
用业务号码查询TAB_SUBSCRB表，取得用户的一些档案信息！
将档案资料组包，返回给接口响应包。
用户特服查询
关联的表：TAB_SRVG , TAB_SUBSCRB
数据流程
接口程序从请求包中取得用户业务号码。
用业务号码查询TAB_SUBSCRB 表取得SUBSCRBID，关联TAB_ SRVG表，取得用户特服异动详细资料信息！
将特服异动详细资料组包，返回给接口响应包。
异动查询
关联的表：USR_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
数据流程：
接口程序从请求包中取得用户业务号码。
用的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取得用户的信用级别。
将信用级信息组包，返回给接口响应包。
GSM话费查询
月结话费帐单查询
关联的表：TAB_SUBSCRB  TAB_BILLDETAIL
数据流程：
接口程序从请求包中取得用户业务号码和帐期。
用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期，取得用户的详细话费帐目信息。
将详细话费帐目信息组包，返回给接口响应包。
月结话费详单查询
关联的表：TICKET_GSMCDMA_******      TICKET_SMS_******
数据流程：
接口程序从请求包中取得用户业务号码和帐期。
用业务号码和帐期查询TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户该月份话费详细帐单信息。
将该月份话费详细帐单信息组包，返回给接口响应包。
实时总帐查询
关联的表：RATING2_REAL_FEE    BILL_RENT_ACCT_DETAIL
数据流程：
接口程序从请求包中取得用户业务号码。
用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。
将实时话费的详细帐目信息组包，返回给接口响应包。
实时清单查询
关联的表：TICKET_GSMCDMA_******    TICKET_SMS_******
数据流程：
接口程序从请求包中取得用户业务号码。
用业务号码查询当月TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户当月实时话费详细帐单信息。
将用户当月实时话费详细帐单信息组包，返回给接口响应包。
帐户余额查询
关联的表：TAB_SUBSCRB  ACCT_BALANCE
数据流程：
接口程序从请求包中取得用户业务号码。
用业务号码查询TAB_SUBSCRB取得ACCTID，关联ACCT_BALANCE查询得到用户当前的账户结余信息。
将用户当前的账户结余信息组包，返回给接口响应包。
GSM业务受理
资料更改（除户名、 号码外）
关联的表：TAB_SUBSCRB  USR_BUSI_RECORD
数据流程：
接口程序从请求包中取得用户业务号码,和需要修改的所有修改信息。
用业务号码关联TAB_SUBSCRB表，做更新操作，修改传过来要修改的所有字段。并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。
将对用户资料修改的成功标志组包，返回给接口响应包。
紧急停机
关联的表：TAB_SUBSCRB    USR_BUSI_RECORD 
数据流程：
接口程序从请求包中取得用户业务号码。将停机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行停机操作，并且修改TAB_SUBSCRB的用户状态为停机状态。
将对用户紧急停机成功标志组包，返回给接口响应包。
服务密码的修改
关联的表：TAB_SUBSCRB   USR_BUSI_RECORD
数据流程
接口程序从请求包中取得用户业务号码和需要修改的密码
用业务号码关联TAB_SUBSCRB表，做更新操作，修改用户服务密码字段。并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。
将对用户资料修改的成功标志组包，返回给接口响应包。
有条件开机
关联的表：TAB_SUBSCRB   USR_BUSI_RECORD

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。