引言
本接口规范文档定义了福建高速电商系统会员的接口,各应用与该接口服务交互需遵循此规范。本接口规范主要供架构设计师、开发人员和测试人员阅读使用,也可供产品验收时参考使用。
HTTP接口规范
- 报文格式:JSON
- 请求方式:POST
- 字符编码:UTF-8
接入准备
- 接入时向我方获取应用的appId、appSecret、URL地址 。appSecret用于接口签名和验签。
接口约定
公共请求参数:
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 示例值 |
|---|---|---|---|---|---|
| appId | 应用ID | header | true | string | test |
| nonce | 随机字符串 | header | true | string | 75ba4a58-8db0-4ce0-b403-2ccc8dbaea72 |
| timestamp | 时间戳 | header | true | string | 1772763315016 |
| sign | 签名串 | header | true | string | 89f4ad32ea7151cc33477215c24e8020bfb801a9… |
业务请求参数:详见各接口说明
响应参数:
| 参数名称 | 参数说明 | 类型 | 示例值 |
|---|---|---|---|
| code | 返回码 | integer | 0 |
| msg | 返回信息 | string | 成功 |
| data | 业务数据 | JSONObject | 详见各接口说明 |
返回码
| 返回码 | 描述 |
|---|---|
| 0 | 成功 |
| 500 | 服务内部异常 |
| 102 | 验签失败 |
| 106 | appid错误 |


