API接口概述

  1. API接口仅支持财贸双全系列、工贸系列、C系列、M系列产品V22.0（含）以上版本。
  2. 在对接前需要向厂家申请和购买Appkey和AppSercret的授权。
  3. 我们产品为独立部署产品，对接API之前需要对服务器进行配置，配置好固定的外网IP和端口作为API接口地址，配置在软件中进行通过【应用中心】-【移动管理】-【（物联宝）服务器默认设置】中进行设置。
  4. 接口中所需的UserID参数为上述【服务器默认设置】中的公司账号，如果是财贸云服务器则UserID为注册云服务器时的手机号。
  5. 接口中所需的DBName参数为客户对应账套的数据库名称，如果是自建服务器数据库名称通常和账套名称是一致的，如果是云服务器的话需要联系代理商或者云服务器管理员查询。

对接流程

  1. 请先完成通用接口的对接后再进行业务接口的对接，通用接口所返回的参数涉及到业务接口的API地址获取，签名计算和数据库连接，通用接口返回参数有效期为24小时。
  2. 通用接口对接完成后，可以开始业务接口的对接，由于通用接口和业务接口是不同的服务器，所以接口传参方式有所不同，请根据具体文档内容进行调整。

通用接口

获取接口所需的SignKey

地址说明

  • 请求地址：http://api.cmgrasp.com/CMGraspApi/GateWay请求参数与返回内容均为json

调用方法

  • POST
  • ContentType: application/json;Charset=UTF-8

参数：

参数名必选类型说明
MethodName是string固定值为：graspcm.cmapi.getsignstr
AppKey是string通过管家婆财贸事业部获取，每个合作公司一个
InvalidTime是datetime传入当前时间
RandamStr是string自己生成的随机字符串
SignStr是string签名字符串

SignStr签名规则

  1. 将AppKey、InvalidTime（按格式yyyyMMddHHmmss格式化为字符串）、RandamStr这些参数，以这些参数的Key按字母顺序进行排序。
  2. 按排好的顺序，将对应的Key+Value连接成一个字符串。
  3. 在字符串尾部加上与对应的SercretKey。
  4. 将这个字符串转成32位小写的MD5。
  5. MD5前的字符串示例：AppKey48B15C891B5247A591B4914A37E5ABCDInvalidTime20200306171800RandamStr12345642B9429E8273412DB5768F20C582BBCD

传入参数示例

{
"MethodName": "graspcm.cmapi.getsignstr",
"AppKey": "48B15C891B5247A591B4914A37E5ABCD",
"InvalidTime": "2020-03-06 17:18:00",
"RandamStr": "123456",
"SignStr": "bb6a7693f6affa889f673ff7d103da30"
}

返回参数 返回的RetMsg为字符串，需要手动转为json格式。

参数名必选类型说明
InvalidTime是datetime传入当前时间
RandamStr是string自己生成的随机字符串
SignKey是string返回客户Api地址所需的SignKey
SignStr是string签名字符串

返回示例

{"RetCode":0,
"RetMsg":"
{
"InvalidTime":"2020-03-09 10:08:41",
"RandamStr":"1XvUZ432CJz31",
"SignKey":"cmgmsignkeyappkey@#986",
"SignStr":"9832D8D2F75E43327DE6AF9917E2D8F9"
}"
}

PostMan传参示例image.png