接口测试 销帮帮API

销帮帮SaaS版
本页面是销帮帮SaaS版接口,2019年10月推出了销帮帮Pro版,请在对接前核对贵公司使用的版本,两个版本是独立数据库,数据不同步,接口传参格式不同。
如何区分版本,在电脑端钉钉工作台打开销帮帮CRM,如下图
全局参数说明
参数名称说明
data访问接口传输参数的最外层包装参数,json格式,内部包含访问某个接口的所有参数集合
token生成签名用到的固定secret部分,管理员账号登录销帮帮WEB版后台后,访问https://dingtalk.xbongbong.com/apiSetting/detail.html查看
corpid包含在data中,访问每个接口都需要传该参数,必填,与钉钉中公司ID对应
sign每次访问销帮帮CRM接口需要生成签名,用于身份验证和信息完整性认证
签名规则
签名规则,将访问接口所需的参数集data + token字符串拼接后进行SHA256运算得到最后的签名,然后将签名参数sign(参数名为sign)放入http header中; 将访问接口所需的参数集data(参数名为data)放入http body.
在开始调试前,先初始化corpid 和 token,这两个值见https://dingtalk.xbongbong.com/apiSetting/detail.html查看,其中corpid为公司标识,token为密钥请勿泄露。

以下用java 作为demo,解释签名和接口调用过程:
//创建请求参数data,请求客户列表[简要]接口
JSONObject data = new JSONObject();
data.put("corpid", ConfigConstant.corpid);
data.put("page", page);
data.put("pageSize", pageSize);

//计算签名sign ,算法为 sha-256(data+token) ,data里如果有中文要用utf-8编码,
String sign = DigestUtil.Encrypt(data.toJSONString() + ConfigConstant.token, "SHA-256");

//调用http post方法,将data传输给对应url
String response = HttpRequestUtils.post(absoluteUrl, data.toJSONString(), sign);


java demo 下载
php demo 下载
python demo 下载
其他说明
目前接口只能VIP用户及试用期用户调用,同一个公司,读接口所有接口合计一分钟1000次,如果是写接口单个接口3秒钟1次。
Alert Modal