请求

1.接口地址=>HTTP

http://ip:port/应用上下文路径/

DEMO如下:

POST https://prewppc-3.cmfbl.com/api/login/{bizType} #登录
POST https://prewppc-3.cmfbl.com/api/register/{bizType} #注册
POST https://prewppc-3.cmfbl.com/api/logout #登出
POST https://prewppc-3.cmfbl.com/api/{bizType} #其他所有请求接口地址信息
...

请求方式: POST

1.2 请求

请求头信息
请求体信息,以content-type=application/json形式传输

1.2.1 Header 请求参数

参数
类型
是否必填项
描述

companyId

long

必填

系统唯一公司标识

trace

String

必填

全局链路唯一标志

timestamp

long

必填

时间戳,毫秒

version

String

非必填

接口版本号

group

String

非必填

接口分组

lang

String

非必填

语言信息,默认zh-CN

token

String

非必填

token信息,登录之后,后续所需

1.2.2 请求体参数

参数
类型
是否必填项
描述

bizBody

JSON

必填

请求信息体,JSON

1.2 接口地址=>websocket

ws://ip:port/应用上下文路径/ws

DEMO如下:

ws://prewppc-3.cmfbl.com/ws

传入参数:

参数
类型
是否必填项
描述

header

JSON

必填

与http保持一致

body

JSON

必填

与http保持一致

DEMO如下:

{
  "header": {
    "trace": "trace",
	"token": "token",
    "bizType": "customer.CustomerWebApiService.login",
    "version": "0.0.1",
	"group": "",
    "companyId": 11,
	"timestamp": 11111131331,
	"lang":"zh-CN"
  },
  "body": {
    "type": 3,
    "loginName": "139"
  }
}

心跳格式如下:bizType固定为ping

{
  "header": {
    "trace": "trace",
	"token": "token",
    "bizType": "ping",
	"sendTime":1617246557505,
	"lang":"zh-CN",
	"timestamp": 11111131331
  }
}

心跳返参消息体格式如下:bizType固定为pong

{
  "trace": "原参数返回",
  "token": "原参数返回",
  "bizType": "pong",
  "sendTime": 1617678792458,
  "lang": "zh-CN"
}

返回参数:

参数
类型
描述

code

String

系统通用返回码。0-成功,其他异常

msg

String

返回信息

bizCode

String

模块标识码

tm

Long

处理时长(毫秒)

trace

String

全局链路标志信息

msgParams

String

返回描述中占位符参数串,多个参数间以,分割

data

Object

数据体,统一返回各个业务响应信息,异常时返回bizType

Last updated