如何连接
1. 申请访问权限
联系我们的商业团队以获取商家帐号和密钥。
2. 接口地址
- 测试服务:
https://test-gateway.mcconnects.com/mc-trading/ - 生产服务:
https://gateway.mcconnects.com/mc-trading/
3. 约定&规范
- 请求方式: POST
- 请求参数: JSON
- 编码格式: UTF-8
- 请求报文结构: 接口会处理请求了两种内容:Header（公有参数,存在在HTTP headers属性中）、Body（私有参数,存放在HTTP Body属性中）
- 元素出现要求:
| 符号 | 说明 |
|---|---|
| R | 报文中该元素必须出现（Required） |
| O | 报文中该元素可选出现（Optional） |
| C | 报文中该元素在一定条件下出现（Conditional） |
- 公共参数:
公共参数（Header）是用于标识产品及接口鉴权的参数，每次请求的headers属性中均需要携带这些参数：
| 参数名称 | 类型 | 出现要求 | 描述 |
|---|---|---|---|
| login | Integer | R | 分配的登录名 |
| businessSystem | String | R | 分配的业务系统名称 |
| password | String | R | 分配的密码，已加密 |
- 响应报文结构:
所有接口响应均采用JSON格式，如无特殊说明，每次请求的返回值中，都包含下列字段：
| Parameter name | Type | Occurrence requirements | Description |
|---|---|---|---|
| code | String | R | 响应码，代码定义请见“附录A 响应码说明” |
| msg | String | R | 响应描述 |
| data | Object | R | 每个接口特有的参数，详见每个接口定义 |
示例
{
"code": "200",
"desc": "Success",
"data": "227552952"
}
4. 连接安全验证
本次服务接口验证采用的是Ip+Token机制，具体流程如下：
- 访问前需要提供访问方的服务IP，后续只有通过此IP发起的请求才可以访问，其他IP将会被拒绝。
- 获取请求的HTTP headers属性中login、businessSystem、password的值。
- 如果这三个参数不传递，则验证不会通过。
- 三个参数验证成功后，IP和登录名会合并加密缓存30秒，30秒内再次访问则不会再验证，30秒后再次访问则需要重新验证。
附录A 响应码说明
| 响应码 | 描述 |
|---|---|
| 200 | 成功 |
| 500 | 错误 |