目录

• 请求公共参数（接口鉴权v3）
• 返回参数格式
• 返回公共参数

公共参数是用于标识用户和接口鉴权目的的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。推荐使用接口鉴权v3。

请求公共参数（接口鉴权v3）

该鉴权方式需要在请求头部设置以下3个属性。在3个属性都设置的情况下，鉴权时会使用该鉴权方式鉴权。优先级：接口鉴权v3>接口鉴权v2>接口鉴权v1。使用接口鉴权v3，其他两种鉴权方式的公共参数无须设值。

该鉴权方式参数的获取与鉴权方式详细说明见 接口鉴权v3

返回参数格式

返回json格式的返回结果。

返回公共参数

Response header中返回服务端生成唯一请求标识

例如：
Response Headers
X-WS-RequestId: 3728d44912a711e4348190e221012d52

对于所有的API接口，返回的body数据如下格式的内容（以json数据格式为例）：

l 成功时返回：

例如：

{
​     "code": 200,
​     "message": "操作成功",
​     "data": {
​         "taskId": "b123456789012345678912",
​         "transNo": "a123456789012345678912"
​     }
}

l 失败时返回：

例如：

{
  "code": 1000,
  "message": "参数错误"
}