概览
- 更新时间: 2019-12-03
- 更新内容: 初始化文档
- 联系方式: quanqudaochanpin@wangdian.cn
接口列表
门店接口
| API | 描述 | | —- | —- | | wdt.crm.store.store.syncStoreInfo | 同步门店接口 |
账号接口
| API | 描述 |
|---|---|
| wdt.crm.admin.user.addUser | 同步账号接口 |
| wdt.crm.admin.user.updateLoginStatus | 更新账号登录权限接口 |
| wdt.crm.admin.user.updateOrganize | 更新账号所属组织接口 |
积分接口
| API | 描述 |
|---|---|
| wdt.crm.integral.Integral.syncIntegral | 积分同步接口 |
会员
| API | 描述 |
|---|---|
| wdt.crm.member.Member.init | 会员数据初始化接口 |
优惠券
| API | 描述 |
|---|---|
| wdt.crm.card.coupon.unlock | 解锁券接口 |
| wdt.crm.card.coupon.verifyThenLock | 验券并冻结券接口 |
| wdt.crm.card.coupon.consume | 优惠券核销接口 |
| wdt.crm.card.coupon.status | 优惠券状态同步接口 |
系统级参数
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称 |
| appkey | String | 是 | 提供给卖家授权的key |
| sign | String | 是 | 签名 |
| timestamp | Int | 是 | 时间戳, 格式: 1428983222 API服务端允许客户端请求时间误差为10分钟 |
| data | String | 否 | 请求参数json |
| version | String | 是 | API协议版本,可选值:1.0 |
| source | Int | 是 | 数据来源 1. 10 oms 1. 20 POS 1. 30小程序 1. 100 第三方 包括:三夫,道讯 |
签名算法
:::tips 调用接口时对所有POST数据(除sign字段)进行签名认证
- 将所有字段(除SIGN字段外)键名按ASCII升序排列。
- 将所有字段(除SIGN字段外)以键值的方式拼接 如 appkey123456timestamp15982737
- 将密钥附在上一步字符串尾后MD5加密
将上一步最终得到的字符串作为sign字段的值
注意: 慧策提供的secret是未加密版本, 需要在签名算法中sha1加密 :::
/*** @purpose 添加签名* @copyright 版权所有掌上先机科技有限公司,并保留所有权利* @description* @property* @last_edit_time 2020-02-25* @author** @param array $params_request** @return array*/private function appendSign(array $params_request): array{ksort($params_request);$str_sign = [];foreach ($params_request as $field => $item) {$item = is_string($item) ? trim($item) : $item;$field = is_string($field) ? trim($field) : $field;if (in_array($field, ['secret'])) {continue;}$str_sign[] = $field . $item;}$str_sign = join('', $str_sign);// env('SERVICE_SECRET') 获取secret$params_request['sign'] = md5($str_sign . sha1(env('SERVICE_SECRET')));return $params_request;}
请求方式
| 名称 | 值 |
|---|---|
| 请求方式 | POST (目前只允许POST请求) |
| 传参方式 | application/x-www-form-urlencoded; charset=utf-8 |
请求地址
| 环境 | 地址 |
| 测试 | http://118.89.236.195/crm/openapi/index.php |
| 正式 | 请联系对接人员获取 |
