晓柚开放平台

开放 · 交流 · 共进 · 创造

开放能力

标准接口 + 实时消息，让三方系统与晓柚零售业务快速打通

</>

开放接口

围绕会员、积分、优惠券、商品、订单、门店、储值卡、标签、员工等零售核心场景，提供 100+ 标准接口；统一签名鉴权、统一错误码，第三方系统拿来就能接，对接范围和交付周期都更好把控。

✉

消息推送

下单、支付、退款、入会、积分变动等关键节点一发生，平台主动把事件推送到您的系统，不用反复轮询；数据实时同步，业务状态和账目始终对得上。

接入场景

会员、积分、优惠券、商品、订单、店铺六大核心场景，每个场景都写清了能做什么、调哪个接口，照着就能落地

会员

会员建档与资料同步、等级积分调整

积分

积分查询、流水上报、兑换记录核对

优惠券

券模板同步、定向发券、到店核销

商品

商品规格建档、分类维护、库存价格同步

商城订单

订单明细查询、发货回传、退款跟踪

店铺

门店建档维护、门店列表与营业状态查询

对接指引

前期准备、账号开通、接口联调到上线验收，每一步该做什么、找谁配合，都写得清清楚楚。

6–10 位，仅支持 0-9、a-z、A-Z、-、_、!、@

请选择日期

永久有效

查看应用密钥或修改 IP 白名单前，请验证当前登录密码。

平台所有开放接口统一使用签名校验，规则如下：

所有请求需携带公共参数：api_key、timestamp、nonce（按接口要求填写）、sign。
把除 sign 以外的全部请求参数按参数名 ASCII 升序排序，以 key=value&key=value 形式拼接（空值参数不参与签名）。
在拼接串末尾直接拼接 secret_key（无 &secret_key= 前缀）。
对最终字符串做 MD5 运算，结果转大写，即为 sign。
timestamp 的格式和有效时间窗口以具体接口文档为准。
接口要求 nonce 时，每次调用使用新的随机值。
IP 白名单在「账户中心 · 应用信息」配置；实际拦截由接入的开放接口网关执行。

签名示例

参数：api_key=xxx&method=member/getInfo&timestamp=1760000000&nonce=a1b2c3d4&memberId=1002381
① 按 ASCII 升序拼接：api_key=xxx&memberId=1002381&method=member/getInfo&nonce=a1b2c3d4&timestamp=1760000000
② 追加 secret_key：…&timestamp=1760000000yourSecretKey
③ MD5 并转大写：sign = 3F1A9C2D4E5B6A7C8D9E0F1A2B3C4D5E

示例代码 ↓PHP 版 ↓JAVA 版