如何连接
1. 申请访问权限
联系我们的商业团队以获取商户账号和密钥。
2. CRM站点
- 测试服务站点:
https://test-crm.mcconnects.com/
- 生产服务站点:
https://crm.mcconnects.com/
3. API地址
- 测试服务:
https://test-gateway.mcconnects.com/mc-crm/
- 生产服务:
https://gateway.mcconnects.com/mc-crm/
4. 协议与规范
-
请求方法: POST
-
请求参数: JSON
-
编码格式: UTF-8
-
请求消息结构: API将处理请求中的两种内容:Header(公共参数,存储在HTTP标头属性中), Body(私有参数,存储在HTTP标头属性中)
-
元素出现要求:
符号 描述 R 此元素必须出现在消息中(必需) O 此元素在消息中是可选的(可选) C 此元素在消息中在特定条件下出现(条件性) -
公共参数:
公共参数(Header)是用于识别产品和接口身份验证的参数。这些参数需要在每个请求的标头属性中携带:
参数名称 | 类型 | 出现要求 | 描述 |
---|---|---|---|
token | string | R | 在平台上创建商户后生成的访问令牌 |
- 响应消息结构:
所有接口响应均以JSON格式返回。除非另有说明,每个请求的返回值包含以下字段:
参数名称 | 类型 | 出现要求 | 描述 |
---|---|---|---|
code | int | R | 响应代码,请参阅“附录A 响应代码说明”以获取代码定义 |
msg | string | R | 响应描述 |
data | object | R | 每个接口独有的参数,请参阅每个接口定义以获取详细信息 |
示例
{
"code": 200,
"msg": "调用成功",
"data": {
"Channel": "A10086",
"Type": 7004
}
}
附录A 响应代码说明
响应代码 | 描述 |
---|---|
200 | 调用成功 |
303 | 参数错误 |
500 | 错误 |