概览

  1. 更新时间: 2019-12-03
  2. 更新内容: 初始化文档
  3. 联系方式: 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字段)进行签名认证

  1. 将所有字段(除SIGN字段外)键名按ASCII升序排列。
  2. 将所有字段(除SIGN字段外)以键值的方式拼接 如 appkey123456timestamp15982737
  3. 将密钥附在上一步字符串尾后MD5加密
  4. 将上一步最终得到的字符串作为sign字段的值


    注意: 慧策提供的secret是未加密版本, 需要在签名算法中sha1加密 :::

  1. /**
  2. * @purpose 添加签名
  3. * @copyright 版权所有掌上先机科技有限公司,并保留所有权利
  4. * @description
  5. * @property
  6. * @last_edit_time 2020-02-25
  7. * @author
  8. *
  9. * @param array $params_request
  10. *
  11. * @return array
  12. */
  13. private function appendSign(array $params_request): array
  14. {
  15. ksort($params_request);
  16. $str_sign = [];
  17. foreach ($params_request as $field => $item) {
  18. $item = is_string($item) ? trim($item) : $item;
  19. $field = is_string($field) ? trim($field) : $field;
  20. if (in_array($field, ['secret'])) {
  21. continue;
  22. }
  23. $str_sign[] = $field . $item;
  24. }
  25. $str_sign = join('', $str_sign);
  26. // env('SERVICE_SECRET') 获取secret
  27. $params_request['sign'] = md5($str_sign . sha1(env('SERVICE_SECRET')));
  28. return $params_request;
  29. }

请求方式

名称
请求方式 POST (目前只允许POST请求)
传参方式 application/x-www-form-urlencoded; charset=utf-8

请求地址

环境 地址
测试 http://118.89.236.195/crm/openapi/index.php
正式 请联系对接人员获取