文档系统
简介
  • 财贸
  • 尽消存
  • 部署指南
  • 商城
  • 建站

    • 企业/个人网站
    • 官网小程序
foo&bar
简介
  • 财贸
  • 尽消存
  • 部署指南
  • 商城
  • 建站

    • 企业/个人网站
    • 官网小程序
foo&bar
  • API接口概述
  • 22.0以上版本接口
    • 成本计算接口
    • 订单中止和恢复
  • 通用接口
    • 获取接口所需的SignKey
    • 获取程序Api地址
  • 业务接口
    • 基础资料新增接口

获取程序Api地址

地址说明

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

调用方法

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

参数:

参数名必选类型说明
MethodName是string固定值为:graspcm.cmapi.getcustomerapiurl
AppKey是string通过管家婆财贸事业部获取,每个合作公司一个
UserId是string传入每个客户自己的账号,可在软件移动管理->服务器连接查看
InvalidTime是datetime传入当前时间
RandamStr是string自己生成的随机字符串
SignStr是string签名字符串
DbName是string数据库名称
  • `参数名的大小写需要保持和上述内容大小是一致

SignStr签名规则

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

传入参数的Json示例

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

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

参数名必选类型说明
invalidtime是datetime传入当前时间
randamstr是string自己生成的随机字符串
apiserveraddress是string客户Api地址
signstr是string签名字符串
apiparam是string调用客户Api地址时传入的参数
graspcloud是string是否是云平台服务器标志
graspcloudmobile是string云平台手机号
graspcloudserverid是string云平台ServiceID

返回示例

{
    "RetCode": 0,
    "RetMsg": "{\"InvalidTime\":\"2021-09-24 17:27:08\",\"RandamStr\":\"zTpBe5wwXu76j\",\"ApiServerAddress\":\"http://qupin888.tpddns.cn:8099/cmc8/api/GraspServer/Process\",\"GraspCloud\":\"False\",\"GraspCloudMobile\":\"\",\"GraspCloudServerId\":\"\",\"SignStr\":\"96d0d6f0ba4bb6d2112d39f071fb41a4\",\"ApiParam\":\"7/eAVT1NN2MtBY+MkAylEAgMEaAfwA/1+Xzv4/imTHOYP+kKc7RHOfq74Ouds+kxTP4afafd+XBQMA49bthO6sc0Y2ajTO6/2bAeSHOLtu4=\"}",
    "OtherMsg": ""
}

API工具传参示例image.png

Prev
获取接口所需的SignKey