概览
- 更新时间: 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 |
正式 | 请联系对接人员获取 |