在线客服,智能在线客服,在线客服系统,客服机器人,智能客服,智能机器人客服,电商客服系统,智慧客服,免费电话,微信在线客服,网站在线客服软件,网络营销电话,手机在线客服,微客服,快商通

咨询热线:0592-5373098 

    一、目的
 

      本文档详细说明了快商通在线客服代理商允许调用的一些接口数据格式,代理商可以通过向快商申请apikey,来使用以下接口进行获取数据等操作,以实现集成到现有公司系统等功能。

    二、接口技术说明
 

       接口基于http协议,需要accessId和accessKey进行md5验证参数。(accessId 和 accessKey 由管理员提供)
 
        参数签名算法:
   应用在调用快商RESTFUL API之前,需要为其所有请求参数计算一个MD5签名,并追加到请求参数中,参数名为"sign"。
  快商REST服务器在接收到请求时会重新计算签名,并判断其值是否与应用传递过来的sign参数值一致,以此判定当前API调用请求是否是被第三者伪造或篡改
  accessId:基于http调用API时所需要的访问授权码
  accessKey:基于http调用API时计算参数签名用的签名密钥。 
  假设参与参数签名计算的请求参数分别是“k1”、“k2”、“k3”,它们的值分别是“v1”、“v2”、“v3”,则参数签名计算方法如下:
  
  将请求的非binary类型的参数格式化为“key=value”格式,即“k1=v1”、“k2=v2”、“k3=v3”; 
  将格式化好的参数键值对以字典序升序排列后,拼接在一起,即“k1=v1k2=v2k3=v3”; 
  在拼接好的字符串末尾追加上accessKey; 
  上述字符串的MD5值即为签名的值。
 
  注意:
  只需将请求的非binary类型的参数拼接,binary类型的参数直接忽略
    计算签名时的请求参数中不要包含sign(签名)参数,因为sign参数的值此时还不知道,有待计算。
 

    三、接口列表
 

                 注意:编码请使用utf-8

     1、注册免费用户接口说明:
 

名称 内容
URL http://agent.kuaishang.cn/agent/api/register.htm
输入参数 compName : 公司名称   必填
webUrl : 公司网址    必填
compAddr : 公司地址    
password : 密码   必填
email : 邮箱
linkman : 联系人   必填
mobile : 手机号码   必填
industryCategory : 所属行业   必填
accessId : 验证ID   必填
sign : 动态生成的验证加密串   必填

输出结果

{
“errcode”:”0”,   //返回码,请参照全局返回码说明
“msg”:{
“compid”:666666,     //生成的公司ID,
“defaultcode”:”<script…></script>”   //默认生成代码
}
}

说明

该代理商接口注册用户后是直接激活且自动开通在线客服免费版


    2、参数示例
 

$accessId = '000000000000000000000000000';
$accessKey = '11111111111111111111';
 
$params = array(
            'accessId' => $accessId,
            'compName' => '测试 ',
            'webUrl' => 'http://www.kuaishang.cn',
            'compAddr' => '厦门嘉禾路',
            'password' => '147258',
            'email' => '1111@qq.com',
            'linkman' => '小菜',
            'mobile' => '18000000000' ,
            'industryCategory' => '教育行业'
);
 
ksort($params);
$sign = md5(str_replace('&', '', http_build_query($params)) . $accessKey);
       
$params['sign'] = $sign;
       
submit_url = 'http://agent.kuaishang.cn/agent/api/register.htm';
       
$snoopy1 = new Snoopy;
$snoopy1->submit($submit_url, $params);
var_dump($snoopy1->results);
       
// $phpjson = 'result:{"errcode":"0","msg":{"msg":"\u6ce8\u518c\u6210\u529f","compid":123456,"defaultcode":"<script type=\"text\/javascript\" src=\"http:\/\/kefu6.kuaishang.cn\/bs\/ks.j?cI=123456&fI=6716\" charset=\"utf-8\"><\/script>"}}';
// $obj = json_decode($phpjson);
// var_dump(htmlspecialchars($obj->msg->defaultcode));

 

    四、全局返回码说明


返回码 说明
-1 系统繁忙
0 请求成功
10001 错误的accessKey
10002 错误的accessId
10003 公司ID已存在
10004 在线客服已开通
10005 代理商不存在
10006 开通业务失败
10007 公司名称不能为空
10008 公司名称长度不能大于50个字符
10009 联系人不能为空
10010 联系人长度不能大于20个字符
10011 手机号码不能为空
10012 手机号码长度不能大于11个字符
10013 公司地址不能为空
10014 公司地址长度不能大于100个字符
10015 邮箱地址不能为空
10016 邮箱格式不正确
10017 邮箱长度不能大于50个字符
10018 邮箱已经存在
10019 网址不能为空
10020 网址长度不能大于100个字符
10021 密码不能为空
10022 密码长度为大于3或者小于15
10023 所属行业不能为空

    五、行业列表
 

咨询业
食品业
建筑、材料业
钟表眼镜、工艺品、礼品
家具
计算机硬件
贸易、批发、市场
外贸行业
生活用品
医疗行业
美容、美体
通信、邮政
电子电器、仪器仪表
金属及非金属制品
旅游、餐饮、娱乐、休闲、购物
航空、旅游
医药行业
机械行业
互联网
律师服务
房地产业
农、林、牧、渔业
党政机关、社会团体
建筑、装潢业
广告、会展
交通运输业
教育行业
造纸、纸品、印刷、包装
日用品业
证券、投资业、保险业
科研业
新闻、出版
纺织、皮革
服装、鞋帽
境保护
冶金冶炼
石油化工,橡胶塑料
婚纱摄影
其他
汽车销售
 

    六、联系我们
 

感谢您的阅读,如果有问题请email我们。
邮箱:kefu@kuaishang.cn
电话:400-027-0592
                    QQ:  800054885

客服一对一服务
30万成功案例
CCTV央视特别报道
国家高新技术企业
全国统一咨询热线:0592-5373098