接口维护文档.docx

接口维护文档.docx

《接口维护文档.docx》由会员分享，可在线阅读，更多相关《接口维护文档.docx（89页珍藏版）》请在冰豆网上搜索。

接口维护文档

青海接口维护文档

客服接口

1、接口功能描述：

客服与营帐系统的接口采用应用服务方式，通讯协议采用TCP/IP标准协议,营帐系统作为服务端，实时监听客服系统的业务请求并作出响应，提供客服系统所需的数据。

⏹接口数据有两种形式:

✓请求包：

由Client端发出业务请求,以请求包的形式传送至服务端,其中包括该项业务所需要的参数信息.

✓应答包：

服务端处理相应的业务请求并以应答包的形式返回数据.

✓数据包由包头和包体构成：

包头内容主要包括各种数据包的共同的基本信息,包体内容主要包括各种数据包的特有信息.

2、接口程序：

主机IP：

130.70.1.213

源程序路径：

/home/bss/yygl/h2

执行程序路径：

/home/bss/yygl/bin

执行命令行：

qhh2h.ini

程序检测端口：

9921

程序日志路径：

/prog/h2/log

3、接口维护：

当前存在的主要问题：

客服查询速度较慢，请检查/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）大小是否合理。

检查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_SUBSCRBRES_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_SUBSCRBTAB_PAYTYPETAB_ACCT

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB取得用户ACCTID，关联TAB_ACCT取得PAY_MODE，再关联TAB_PAYTYPE取得用户的信用级别。

将信用级信息组包，返回给接口响应包。

GSM话费查询

月结话费帐单查询

关联的表：

TAB_SUBSCRBTAB_BILLDETAIL

数据流程：

接口程序从请求包中取得用户业务号码和帐期。

用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期，取得用户的详细话费帐目信息。

将详细话费帐目信息组包，返回给接口响应包。

月结话费详单查询

关联的表：

TICKET_GSMCDMA_******TICKET_SMS_******

数据流程：

接口程序从请求包中取得用户业务号码和帐期。

用业务号码和帐期查询TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户该月份话费详细帐单信息。

将该月份话费详细帐单信息组包，返回给接口响应包。

实时总帐查询

关联的表：

RATING2_REAL_FEEBILL_RENT_ACCT_DETAIL

数据流程：

接口程序从请求包中取得用户业务号码。

用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。

将实时话费的详细帐目信息组包，返回给接口响应包。

实时清单查询

关联的表：

TICKET_GSMCDMA_******TICKET_SMS_******

数据流程：

接口程序从请求包中取得用户业务号码。

用业务号码查询当月TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户当月实时话费详细帐单信息。

将用户当月实时话费详细帐单信息组包，返回给接口响应包。

帐户余额查询

关联的表：

TAB_SUBSCRBACCT_BALANCE

数据流程：

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB取得ACCTID，关联ACCT_BALANCE查询得到用户当前的账户结余信息。

将用户当前的账户结余信息组包，返回给接口响应包。

GSM业务受理

资料更改（除户名、号码外）

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程：

接口程序从请求包中取得用户业务号码,和需要修改的所有修改信息。

用业务号码关联TAB_SUBSCRB表，做更新操作，修改传过来要修改的所有字段。

并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。

将对用户资料修改的成功标志组包，返回给接口响应包。

紧急停机

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程：

接口程序从请求包中取得用户业务号码。

将停机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行停机操作，并且修改TAB_SUBSCRB的用户状态为停机状态。

将对用户紧急停机成功标志组包，返回给接口响应包。

服务密码的修改

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码和需要修改的密码

用业务号码关联TAB_SUBSCRB表，做更新操作，修改用户服务密码字段。

并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。

将对用户资料修改的成功标志组包，返回给接口响应包。

有条件开机

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

将此次开机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SUBSCRB的用户状态为开机状态。

将对用户有条件开机的成功标志组包，返回给接口响应包。

特服档案修改

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORDTAB_SRVGUSR_BUSI_SRVG

数据流程

接口程序从请求包中取得用户业务号码和异动特服类型和操作类型。

将此次特服变更操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SRVG的用户特服状态操作类型状态，插入USR_BUSI_SRVG表记录此次特服变更的操作。

将对用户特服变更的成功标志组包，返回给接口响应包。

销户预约

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

将此次预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为禁用功能，并且修改TAB_SUBSCRB的用户状态为预约销户状态。

将对用户有条件开机的成功标志组包，返回给接口响应包。

取消销户预约

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

将此次取消预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为可用状态，并且修改TAB_SUBSCRB的用户状态为开机状态。

将对用户有条件开机的成功标志组包，返回给接口响应包。

CDMA服务类型数据流程

CDMA基本资料查询

连接校验

关联的表

无

数据流程

接口程序从请求包中取得返回连接状态的业务类型。

查询：

连接数据库状态，是否是连接状态！

将连接状态组包，返回给接口响应包。

用户身份验证

关联的表：

TAB_SUBSCRB

数据流程

接口程序从请求包中取得用户业务号码和用户密码。

用业务号码查询TAB_SUBSCRB表中，用户密码！

用从表中取得的密码和接口传过来的密码进行校验。

将校验结果组包，返回给接口响应包。

用户档案查询

关联的表：

TAB_SUBSCRB

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB表，取得用户的一些档案信息！

将档案资料组包，返回给接口响应包。

用户特服查询

关联的表：

TAB_SRVG,TAB_SUBSCRB

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB表取得SUBSCRBID，关联TAB_SRVG表，取得用户特服异动详细资料信息！

将特服异动详细资料组包，返回给接口响应包。

异动查询

关联的表：

USR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询USR_BUSI_RECORD表，取得用户所有的异动详细资料信息！

将所有的异动详细资料信息组包，返回给接口响应包。

黑名单查询

关联的表：

TAB_SPECIALCUSTLST

数据流程

接口程序从请求包中取得用户证件号码。

用证件号码查询TAB_SPECIALCUSTLST表，取得该证件是黑名单的详细信息！

将名单的详细信息组包，返回给接口响应包。

黑名单验证

关联的表：

TAB_SPECIALCUSTLST

数据流程：

接口程序从请求包中取得用户证件号码。

用证件号码查询TAB_SPECIALCUSTLST表，取得是否在黑名单列表中！

将是否是黑名单用户状态组包，返回给接口响应包。

预交流水查询（按电话号码查询）

关联的表：

TAB_PAY

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_PAY表，取得用户在开户以来所有的交费记录的详细信息！

将用户在开户以来所有的交费记录的详细信息组包，返回给接口响应包

PUK码查询（按电话号码查询）

关联的表：

TAB_SUBSCRBRES_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_SUBSCRBTAB_PAYTYPETAB_ACCT

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB取得用户ACCTID，关联TAB_ACCT取得PAY_MODE，再关联TAB_PAYTYPE取得用户的信用级别。

将信用级信息组包，返回给接口响应包。

CDMA话费查询

月结话费帐单查询

关联的表：

TAB_SUBSCRBTAB_BILLDETAIL

数据流程

接口程序从请求包中取得用户业务号码和帐期。

用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期，取得用户的详细话费帐目信息。

将详细话费帐目信息组包，返回给接口响应包。

月结话费详单查询

关联的表：

TICKET_GSMCDMA_******TICKET_SMS_******

数据流程：

接口程序从请求包中取得用户业务号码和帐期。

用业务号码和帐期查询TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户该月份话费详细帐单信息。

将该月份话费详细帐单信息组包，返回给接口响应包。

实时总帐查询

关联的表：

RATING2_REAL_FEEBILL_RENT_ACCT_DETAIL

数据流程：

接口程序从请求包中取得用户业务号码。

用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。

将实时话费的详细帐目信息组包，返回给接口响应包。

实时清单查询

关联的表：

TICKET_GSMCDMA_******TICKET_SMS_******

数据流程

接口程序从请求包中取得用户业务号码。

用业务号码查询当月TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户当月实时话费详细帐单信息。

将用户当月实时话费详细帐单信息组包，返回给接口响应包。

帐户余额查询

关联的表：

TAB_SUBSCRBACCT_BALANCE

数据流程：

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB取得ACCTID，关联ACCT_BALANCE查询得到用户当前的账户结余信息。

将用户当前的账户结余信息组包，返回给接口响应包。

CDMA业务受理

资料更改（除户名、号码外）

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码,和需要修改的所有修改信息。

用业务号码关联TAB_SUBSCRB表，做更新操作，修改传过来要修改的所有字段。

并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。

将对用户资料修改的成功标志组包，返回给接口响应包。

紧急停机

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

将停机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行停机操作，并且修改TAB_SUBSCRB的用户状态为停机状态。

将对用户紧急停机成功标志组包，返回给接口响应包。

服务密码的修改

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程：

接口程序从请求包中取得用户业务号码和需要修改的密码

用业务号码关联TAB_SUBSCRB表，做更新操作，修改用户服务密码字段。

并且将这次修改操作记录进USR_BUSI_RECORD，以方便日后查询。

将对用户资料修改的成功标志组包，返回给接口响应包。

有条件开机

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

将此次开机操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SUBSCRB的用户状态为开机状态。

将对用户有条件开机的成功标志组包，返回给接口响应包。

特服档案修改

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORDTAB_SRVGUSR_BUSI_SRVG

数据流程

接口程序从请求包中取得用户业务号码和异动特服类型和操作类型。

将此次特服变更操作记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作，并且修改TAB_SRVG的用户特服状态操作类型状态，插入USR_BUSI_SRVG表记录此次特

服变更的操作。

将对用户特服变更的成功标志组包，返回给接口响应包。

销户预约

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程

接口程序从请求包中取得用户业务号码。

将此次预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为禁用功能，并且修改TAB_SUBSCRB的用户状态为预约销户状态。

将对用户有条件开机的成功标志组包，返回给接口响应包。

取消销户预约

关联的表：

TAB_SUBSCRBUSR_BUSI_RECORD

数据流程：

接口程序从请求包中取得用户业务号码。

将此次取消预约销户记录进USR_BUSI_RECORD，等待联机指令程序扫描改记录，进行开机操作,使本地交换机IMSI-MDN为可用状态，并且修改TAB_SUBSCRB的用户状态为开机状态。

将对用户有条件开机的成功标志组包，返回给接口响应包。

VOIP服务类型数据流程

VOIP基本资料查询

IPPhone身份验证

关联的表：

TAB_SUBSCRB

数据流程

接口程序从请求包中取得用户业务号码和用户密码。

用业务号码查询TAB_SUBSCRB表中，用户密码！

用从表中取得的密码和接口传过来的密码进行校验。

将校验结果组包，返回给接口响应包。

IPPhone用户档案查询

关联的表:

TAB_SUBSCRB

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB表，取得用户的一些档案信息！

将档案资料组包，返回给接口响应包。

IPPhone用户通过卡号或电话号码月结话费查询

关联的表:

TAB_SUBSCRBTAB_BILLDETAIL

数据流程:

接口程序从请求包中取得用户业务号码和帐期。

用业务号码和帐期查询TICKET_GSMCDMA_******与TICKET_SMS_******，取得两个表联合查询的用户该月份话费详细帐单信息。

将该月份话费详细帐单信息组包，返回给接口响应包。

IPPhone用户通过卡号或电话号码实时话费查询

关联的表:

RATING2_REAL_FEEBILL_RENT_ACCT_DETAIL

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。

将实时话费的详细帐目信息组包，返回给接口响应包。

IPPhone通过卡号查询所有电话号码

关联的表:

TAB_SUBSCRB

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码和帐期查询RATING2_REAL_FEE与BILL_RENT_ACCT_DETAIL，取得两个表联合查询的用户实时话费的详细帐目信息。

将实时话费的详细帐目信息组包，返回给接口响应包。

IPPhone通过电话号码查卡号、用户名

关联的表:

TAB_VOIPSUBSCRB

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_VOIPSUBSCRB，取用户业务号码对应绑定的电话号码信息。

将用户业务号码对应绑定的电话号码信息组包，返回给接口响应包。

IPPhone通过卡号或手机号码查询相同CUSID用户

关联的表:

TAB_SUBSCRB

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_VOIPSUBSCRB，取用户业务号码对应绑定的CUSTID,再通过CUSTID查询在用户表中相同客户号码的用户业务号码信息！

将相同客户号码的用户业务号码信息组包，返回给接口响应包。

IPPhone通过卡号或绑定号码查询详单

关联的表:

TICKET_163_******

数据流程:

接口程序从请求包中取得用户业务号码和帐期。

用业务号码和帐期查询TICKET_193_******联合查询的用户该月份话费详细帐单信息。

将该月份话费详细帐单信息组包，返回给接口响应包。

IPPhone通过卡号查询预交款缴费记录

关联的表:

TAB_PAY

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_PAY表，取得用户在开户以来所有的交费记录的详细信息！

将用户在开户以来所有的交费记录的详细信息组包，返回给接口响应包

IPPhone通过卡号查询服务异动记录

关联的表:

TAB_SRVG,TAB_SUBSCRB

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码查询TAB_SUBSCRB表取得SUBSCRBID，关联TAB_SRVG表，取得用户特服异动详细资料信息！

将特服异动详细资料组包，返回给接口响应包。

IPPhone通过卡号查询指令执行记录

关联的表:

USR_BUSI_RECORD

数据流程:

接口程序从请求包中取得用户业务号码。

用业务号码查询USR_BUSI_RECORD表，取得用户所有的异动详细资料信息！

将所有的异动详细资料信息组包，返回给接口响应包。

CDMA1X服务类型数据流程

CDMA1X基本资料查询

CDMA1X用户月结话费查询

关联的表:

TAB_SUBSCRBTAB_BILLDETAIL

数据流程:

接口程序从请求包中取得用户业务号码和帐期。

用业务号码查询TAB_SUBSCRB取得用户SUBSCRBID，关联TAB_BILLDETAIL并且限定帐期，取得用户的详细话费帐目信息。

将详细话费帐目信息组包，返回给接口响应包。

CDMA1X用户实时话费查询

关联的表

接口接收到身份验证的请求包