# 开发指南
# 开发前必读
- 请求协议:生产环境的接口需使用HTTPS协议。
- 请求格式:JSON数据格式,UTF8编码。
- 返回结果/参数说明:开发者需根据code是否为0判断是否调用成功(code意义请见Api规约)。而msg仅作参考,后续可能会有变动,因此不可作为是否调用成功的判据。
# 接入指南
# 心跳推送
# 接口URL
运维总控(公有云时):
开发环境: http://192.169.0.220:5001/sevApi/healthy/healthyItem?token=
测试环境: http://hhhmis.f3322.net:30010/sevApi/healthy/healthyItem?token=
生产环境: https://m.jianxiecloud.com/sevApi/healthy/healthyItem?token=
token为应用凭证
运维分控(私有云时):
- 生产环境: http://{运维分控地址}:{运维分控端口}/healthyItem
注意:运维分控端口只能内网访问
# 入参说明
请求方式:POST/JSON
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| appId | 应用id | String | 必填 |
| appName | 应用名称 | String | 首次登记有效 |
| systemCode | 应用编码 | String | |
| servicesId | 服务id | String | 必填 |
| servicesName | 服务名称 | String | 首次登记有效 |
| ip | 实例IP | String | 必填 |
| port | 实例port | String | 必填 |
| serviceProtected | 实例保护的 | String | 必填。1:不保护,2:保护 |
# 入参格式示例
{
"appId":"zhujiangzulin111",
"appName":"珠江租赁",
"systemCode":"PEARL",
"servicesId":"mainServer",
"servicesName":"主服务",
"ip":"192.169.0.49",
"port":"8097",
"serviceProtected":2
}
# 出参说明
| 返回参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| code | 状态码 | int | |
| status | int | ||
| data | 业务数据 | Object | |
| msg | 返回说明 | String |
# 出参格式示例
{
"code": 0,
"status": 0,
"data": true,
"msg": "操作成功"
}
# 预警推送
# 接口Url
开发环境: http://192.169.0.220:5001/sevApi/wraning/pushwraning?token=
测试环境: http://hhhmis.f3322.net:30010/sevApi/wraning/pushwraning?token=
生产环境: https://m.jianxiecloud.com/sevApi/wraning/pushwraning?token=
token为应用凭证
# 入参说明
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| appId | 应用ID | String | 必填 |
| serviceId | 服务Id | String | |
| sources | 推送消息数据源 | Object | 由用户自定义 |
| properties | 推送配置 | Object | 附表格 |
# properties - 附表格
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| strategyId | 推送配置策略主键 | int | 必填 |
| templateId | 推送配置模板主键 | int | 必填 |
# 入参格式示例
{
"sources": {
},
"properties": {
"strategyId":"2",
"templateId":"2"
}
}
# 出参说明
| 返回参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| code | 状态码 | int | |
| status | int | ||
| data | 业务数据 | Object | |
| msg | 返回说明 | String |
# 出参格式示例
{
"code": 0,
"status": 0,
"data": true,
"msg": "操作成功"
}
# 登录日志采集
# 接口Url
- 开发环境: http://192.169.0.220:5001/sevApi/appLogs/sendLoginLogs?token=
- 测试环境: http://hhhmis.f3322.net:30010/sevApi/appLogs/sendLoginLogs?token=
- 生产环境: https://m.jianxiecloud.com/sevApi/appLogs/sendLoginLogs?token=
# 入参说明
请求方式:POST/JSON
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| data | 信息对象 | Object[] | json数组 |
data数组内容
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| appId | 应用id | String | |
| id | 日志主键 | String | |
| loginTime | 登录时间 | String | |
| loginName | 操作人账号 | String | |
| username | 操作人名称 | String | |
| ip | 操作人ip | String | |
| department | 所属部门 | String | |
| departmentId | 所属部门主键 | String | |
| token | 登录凭证 | String | |
| loginRresult | 登录出参 | String | |
| successOrFail | 登录结果 | String |
# 入参格式示例
{
"data":[{
"appId":"1",
"id":"1",
"ip":"127.0.0.1",
"loginTime":"2021-08-19 14:34:47",
"loginName":"testysb1",
"username":"ysb",
"department":"搬砖部1",
"departmentId":"dep11",
"token":"testtoken",
"loginRresult":"null",
"successOrFail":"ok"
},{
"appId":"2",
"id":"2",
"ip":"127.0.0.1",
"loginTime":"2021-08-19 14:34:47",
"loginName":"testys2",
"username":"ysb改",
"department":"搬砖部2",
"departmentId":"dep22",
"token":"testtoken",
"loginRresult":"null",
"successOrFail":"ok"
}]
}
# 出参说明
| 返回参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| code | 状态码 | int | |
| status | int | ||
| data | 业务数据 | Object | |
| msg | 返回说明 | String |
# 出参格式示例
{
"code": 0,
"status": 0,
"data": null,
"msg": "操作成功"
}
# 执行日志采集
# 接口Url
- 开发环境: http://192.169.0.220:5001/sevApi/appLogs/sendRunLogs?token=
- 测试环境: http://hhhmis.f3322.net:30010/sevApi/appLogs/sendRunLogs?token=
- 生产环境: https://m.jianxiecloud.com/sevApi/appLogs/sendRunLogs?token=
# 入参说明
请求方式:POST/JSON
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| data | 信息对象 | Object[] | json数组 |
data数组内容
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| appId | 应用id | String | |
| id | 日志主键 | String | |
| logType | 日志类型 | Byte | 0:异常日志,1:正常日志,2:运行日志,3:登录日志,4接口日志 |
| operateTime | 操作时间 | String | |
| operateInfo | 操作内容 | String | |
| logSrc | 业务方法 | String | |
| timeSpend | 耗时ms | Long | |
| serviceName | 服务名称 | String | |
| loginName | 操作人账号 | String | |
| username | 操作人名称 | String | |
| ip | 操作人ip | String | |
| operateName | 受理名称 | String | |
| msg | 结果信息 | String |
# 入参格式示例
{
"data":[{
"appId":"31",
"id":"31",
"logType":0,
"operateTime":"2021-08-19 14:34:47",
"operateInfo":"operateContext1",
"logSrc":"sendRunLogs1",
"timeSpend":1000,
"serviceName":"testservice1",
"loginName":"testysb1",
"username":"ysb改",
"ip":"127.0.0.1",
"operateName":"operateName1",
"msg":"正常运行"
},{
"appId":"32",
"id":"32",
"logType":"1",
"operateTime":"2021-08-19 14:34:47",
"operateInfo":"operateContext2",
"logSrc":"sendRunLogs2",
"timeSpend":1000,
"serviceName":"testservice2",
"loginName":"testysb2",
"username":"ysb",
"ip":"127.0.0.1",
"operateName":"operateName2",
"msg":"正常运行"
}]
}
# 出参说明
| 返回参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| code | 状态码 | int | |
| status | int | ||
| data | 业务数据 | Object | |
| msg | 返回说明 | String |
# 出参格式示例
{
"code": 0,
"status": 0,
"data": null,
"msg": "操作成功"
}
# 错误日志采集
# 接口Url
- 开发环境: http://192.169.0.220:5001/sevApi/appLogs/sendErrorLogs?token=
- 测试环境: http://hhhmis.f3322.net:30010/sevApi/appLogs/sendErrorLogs?token=
- 生产环境: https://m.jianxiecloud.com/sevApi/appLogs/sendErrorLogs?token=
# 入参说明
请求方式:POST/JSON
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| data | 信息对象 | Object[] | json数组 |
data数组内容
| 请求参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| appId | 应用id | String | |
| id | 日志主键 | String | |
| method | 业务方法 | String | |
| errorLog | 异常内容 | String | |
| errorData | 异常入参 | String | |
| createTime | 创建时间 | String | |
| loginName | 操作人账号 | String | |
| username | 操作人名称 | String | |
| serviceName | 服务名称 | String | |
| errorLine | 错误行 | Long |
# 入参格式示例
{
"data":[{
"appId":"21",
"id":"21",
"method":"sendErrorLogs1",
"errorLog":"ExceptionContext1",
"errorData":"ExceptionParam:para",
"createTime":"2021-08-19 14:34:47",
"loginName":"testysb1",
"username":"ysb",
"serviceName":"testservice1",
"errorLine":1
},{
"appId":"22",
"id":"22",
"method":"sendErrorLogs2",
"errorLog":"ExceptionContext2",
"errorData":"ExceptionParam:para",
"createTime":"2021-08-19 14:34:47",
"loginName":"testysb12",
"username":"ysb",
"serviceName":"testservice2",
"errorLine":2
}]
}
# 出参说明
| 返回参数 | 参数名 | 参数类型 | 说明 |
|---|---|---|---|
| code | 状态码 | int | |
| status | int | ||
| data | 业务数据 | Object | |
| msg | 返回说明 | String |
# 出参格式示例
{
"code": 0,
"status": 0,
"data": null,
"msg": "操作成功"
}