得舍开放平台基于得舍多商户商城,对外提供 REST 风格的 HTTPS 接口。你不必换掉现有系统,只要按需接入需要的能力。
已有 ERP、进销存、财务或客服系统的商家,把商品与订单数据和商城打通,避免两头手工录入。
为商户做小程序、APP、私域运营或数据服务的软件公司,用一套接口服务多个商户。
自己团队能写服务端代码,希望把商城的交易能力嵌入自有业务流的商家。
能力按模块授权,未开通的模块不会获得调用权限。具体接口清单与字段说明在接入时随文档提供。
商品基础资料、多规格、价格、上下架状态与库存查询,支持与外部商品库同步。
订单查询、支付状态、发货与物流信息、售后进度,支持按时间与状态增量拉取。
会员资料、会员等级、积分余额与积分流水,便于外部系统识别同一客户。
分销关系、团队结构、佣金明细与结算记录,用于对账和业绩统计。
优惠券、活动与可用性校验,方便外部渠道发券或在自有页面展示活动。
支付结果查询与交易对账数据,按日或按单核对,发现差异及时处理。
订单创建、支付成功、发货、售后等关键事件可回调到开发者服务器。回调要求验签,并按幂等方式处理重复通知。
审核、联调、上线三个阶段都有对接人跟进,不需要自己摸索。
说明接入方、使用场景与需要的能力模块,签署接入约定。
审核通过后分配 app_id 与密钥,并提供独立测试商户用于联调,避免脏数据进入生产。
按接口文档完成鉴权、查询与写入联调,覆盖正常流程与异常分支后再申请上线。
配置回调地址与 IP 白名单,切换到生产 app_id,进入日常调用与对账。
下面是平台级的通用约定,具体接口路径、字段与示例以接入时提供的接口文档为准。
| 传输协议 | 全站 HTTPS,不接受明文 HTTP 调用。 |
|---|---|
| 数据格式 | 请求与响应均为 JSON(UTF-8)。 |
| 统一响应 | code 表示业务结果,msg 为提示信息,data 为业务数据;以 code 判断成功与否,不要只看 HTTP 状态码。 |
| 商户标识 | 每个请求都携带 app_id,平台按 app_id 做商户数据隔离,跨商户数据不可见。 |
| 鉴权 | 密钥只保存在服务端,用于生成签名或换取访问令牌;密钥不得出现在前端代码、小程序包或公开仓库。 |
| 分页 | 列表接口统一使用 page 与 page_size,响应返回总数,避免一次拉全量。 |
| 幂等 | 写入类接口需携带业务幂等键,重复请求不应产生重复数据。 |
| 错误码 | 错误码按业务域分段,接入文档中逐条说明含义与处理建议。 |
示例响应(字段以接入文档为准):
{
"code": 1,
"msg": "ok",
"data": {
"list": [ ... ],
"total": 128,
"page": 1,
"page_size": 20
}
}
接口开放的范围与权限按申请逐项开通,平台侧持续做调用审计。
全链路 HTTPS,密钥与签名信息不出现在 URL 与日志中。
按能力模块授权,只开通业务真正需要的读写范围。
所有请求按 app_id 归属校验,一个商户的数据不会出现在另一个商户的响应里。
关键接口的调用留有记录,出现异常时可以回溯到调用方与时间点。
从申请到上线由对接人跟进:接入咨询、联调答疑、上线检查与故障响应,都走同一条通道。
开发资源、接入范围、密钥与费用,常见疑问一次说清。