测试阶段的t和secret可以先用demo账号来测试:
AppID(应用ID):demo AppSecret(应用密钥):找开发对接人员要
正式上线的时候需要换成您自己后台获取的企业id和企业应用秘钥
(一)请求地址:
建档顾客: http://api.qique.cn/index.php?r=open_back/api/addcustomer (post方式)
获取顾客的钱包变动记录: http://api.qique.cn/index.php?r=open_back/api/getwalletchangelist (post方式)
调整余额/佣金/积分数量: http://api.qique.cn/index.php?r=open_back/api/changewallet (post方式)
用顾客ID获取顾客信息: http://api.qique.cn/index.php?r=open_back/api/getcusinfobycusid (get方式)
用顾客手机号获取顾客信息: http://api.qique.cn/index.php?r=open_back/api/getcusinfobycusid (get方式)
获得某个时间点之后的所有聊天记录: http://api.qique.cn/index.php?r=open_back/api/getallchathistorybytime (get方式)
获得某个顾客某个时间点之后的聊天记录: http://api.qique.cn/index.php?r=open_back/api/getchathistorybyopenid (get方式)
给某个手机号发送短信: http://api.qique.cn/index.php?r=open_back/api/sendmsgtotel (get方式)
通过openId获取顾客在企雀的id: http://api.qique.cn/index.php?r=open_back/api/getcustomerinfo (get方式)
给某个顾客发送一张卡或优惠券: http://api.qique.cn/index.php?r=open_back/api/sendcardorcoupons (get方式)
获取线上支付订单和退款订单: http://api.qique.cn/index.php?r=open_back/api/getonlineorders (get方式)
对特定线上订单进行发货或核销处理: http://api.qique.cn/index.php?r=open_back/api/delivery (get方式)
获取线上商品/拼团列表: http://api.qique.cn/index.php?r=open_back/api/getgoodslist (get方式)
获取某个在线订单的订单和商品的信息: http://api.qique.cn/index.php?r=open_back/api/getorderdetail (get方式)
获取预约列表: http://api.qique.cn/index.php?r=open_back/api/getappointmentlist (get方式)
创建一条预约记录: http://api.qique.cn/index.php?r=open_back/api/addoneappointment (get方式)
修改一条预约记录: http://api.qique.cn/index.php?r=open_back/api/changeappointment (get方式)
取消一条预约记录: http://api.qique.cn/index.php?r=open_back/api/cancelappointment (get方式)
获取线下订单购买记录: http://api.qique.cn/index.php?r=open_back/api/getofflineproducts (get方式)
获取线下订单划扣记录: http://api.qique.cn/index.php?r=open_back/api/getofflineexcute (get方式)
(二)签名:
对所有的请求参数(不含sign参数)进行ksort排序
排序后的请求参数按key1value1key2value2key3value3进行字符拼接
拼接后的内容再在前后拼接企雀后台提供的私钥(secret)
对字符穿进行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时会带上这个错误信息 }
打开微信“扫一扫”转发给朋友
打开微信“扫一扫”在小程序中打开