7x9小时
9:00am - 6:00pm
免费售前热线
13338363507
其它接入
客服接入
API指南
SDK用法
非SDK对接需知

测试阶段的t和secret可以先用demo账号来测试:

AppID(应用ID):demo
AppSecret(应用密钥):找开发对接人员要

正式上线的时候需要换成您自己后台获取的企业id和企业应用秘钥


(一)请求地址:

  1. 建档顾客: http://api.qique.cn/index.php?r=open_back/api/addcustomer    (post方式)

  2. 获取顾客的钱包变动记录: http://api.qique.cn/index.php?r=open_back/api/getwalletchangelist    (post方式)

  3. 调整余额/佣金/积分数量: http://api.qique.cn/index.php?r=open_back/api/changewallet    (post方式)

  4. 用顾客ID获取顾客信息: http://api.qique.cn/index.php?r=open_back/api/getcusinfobycusid    (get方式)

  5. 用顾客手机号获取顾客信息: http://api.qique.cn/index.php?r=open_back/api/getcusinfobycusid    (get方式)

  6. 获得某个时间点之后的所有聊天记录: http://api.qique.cn/index.php?r=open_back/api/getallchathistorybytime    (get方式)

  7. 获得某个顾客某个时间点之后的聊天记录: http://api.qique.cn/index.php?r=open_back/api/getchathistorybyopenid    (get方式)

  8. 给某个手机号发送短信: http://api.qique.cn/index.php?r=open_back/api/sendmsgtotel    (get方式)

  9. 通过openId获取顾客在企雀的id: http://api.qique.cn/index.php?r=open_back/api/getcustomerinfo    (get方式)

  10. 给某个顾客发送一张卡或优惠券: http://api.qique.cn/index.php?r=open_back/api/sendcardorcoupons    (get方式)

  11. 获取线上支付订单和退款订单: http://api.qique.cn/index.php?r=open_back/api/getonlineorders    (get方式)

  12. 对特定线上订单进行发货或核销处理: http://api.qique.cn/index.php?r=open_back/api/delivery    (get方式)

  13. 获取线上商品/拼团列表: http://api.qique.cn/index.php?r=open_back/api/getgoodslist    (get方式)

  14. 获取某个在线订单的订单和商品的信息: http://api.qique.cn/index.php?r=open_back/api/getorderdetail    (get方式)

  15. 获取预约列表: http://api.qique.cn/index.php?r=open_back/api/getappointmentlist    (get方式)

  16. 创建一条预约记录: http://api.qique.cn/index.php?r=open_back/api/addoneappointment    (get方式)

  17. 修改一条预约记录: http://api.qique.cn/index.php?r=open_back/api/changeappointment    (get方式)

  18. 取消一条预约记录: http://api.qique.cn/index.php?r=open_back/api/cancelappointment    (get方式)

  19. 获取线下订单购买记录: http://api.qique.cn/index.php?r=open_back/api/getofflineproducts    (get方式)

  20. 获取线下订单划扣记录: http://api.qique.cn/index.php?r=open_back/api/getofflineexcute    (get方式)


(二)签名:

  1. 对所有的请求参数(不含sign参数)进行ksort排序

  2. 排序后的请求参数按key1value1key2value2key3value3进行字符拼接

  3. 拼接后的内容再在前后拼接企雀后台提供的私钥(secret)

  4. 对字符穿进行md5加密处理

    经过以上4个步骤即可获得对应的sign参数


生成签名举例:

    public static function sign($appSecret, $params, $method = 'md5')
    {
        if (!is_array($params)) {
            $params = array();
        }
        ksort($params);
        $text = '';
        foreach ($params as $k => $v) {
            $text .= $k . $v;
        }        
        return md5($appSecret . $text . $appSecret);
    }


(三)请求参数&返回字段:

post表单提交方式:form-data

每个接口都需要有以下通用参数:

t 必填 企业id
timeStamp 必填 请求时间 Y-m-d H:i:s格式
format 必填 请求格式 'json'
v 必填 版本号 '2.0'
sign 必填 对当前请求参数(除了sign本身)加密后的签名
signMethod 必填 加密方式 'md5'

    

各接口额外需传入的参数和返回字段说明:


新建顾客信息为例:


  /** 
     * 在系统里新建一个顾客
     * @param  [type]  $name            必填:顾客名称
     * @param  [type]  $telnum          必填:顾客手机号
     * 
     * @param  [type]  $erpId           选填:指定会员id (数字,不超过11位,唯一)
     * @param  integer $sex             选填:顾客性别:(1:男,2:女)
     * @param  [type]  $birthday        选填:生日 Y-m-d
     * @param  [type]  $channelName     选填:渠道名称(和系统内保持一致,系统内没有的时候会新建)
     * @param  string  $channelUserName 选填:渠道人员名称(和系统内保持一致,系统内没有的时候会新建)
     * @param  string  $preConsultName  选填:网电人员名字(和系统内保持一致,系统内没有的时候会新建)
     * @param  string  $ownerName       选填:建档人员名字(和系统内保持一致,系统内没有的时候会新建)
     * @param  string  $description     选填:网电备注(和系统内保持一致,系统内没有的时候会新建)
     * @return [type]             
        {
            errNum: xx(0说明接口返回成功,非0说明是产生了错误),
            errMsg: errNum为非0时会带上这个错误信息
        }
     */
    public function addCustomer($name, $telnum, $erpId = null, $sex = 0, $birthday = null, $channelName = null, 
    $channelUserName = '', $preConsultName = '', $ownerName = '', $description = '')


以上函数说明传入参数为:

name            必填:顾客名称
telnum          必填:顾客手机号
erpId           选填:指定会员id (数字,不超过11位,唯一)
sex             选填:顾客性别:(1:男,2:女)
birthday        选填:生日 Y-m-d
channelName     选填:渠道名称(和系统内保持一致,系统内没有的时候会新建)
channelUserName 选填:渠道人员名称(和系统内保持一致,系统内没有的时候会新建)
preConsultName  选填:网电人员名字(和系统内保持一致,系统内没有的时候会新建)
ownerName       选填:建档人员名字(和系统内保持一致,系统内没有的时候会新建)
description     选填:网电备注(和系统内保持一致,系统内没有的时候会新建)


返回字段为:

{
     errNum: xx(0说明接口返回成功,非0说明是产生了错误),
     errMsg: errNum为非0时会带上这个错误信息
}


有用 没用 分享到微信

打开微信“扫一扫”转发给朋友

小程序内打开

打开微信“扫一扫”在小程序中打开