万企开放平台
    万企开放平台
    • 项目简介
    • 错误码
    • 接口说明
    • 接口列表
      • 档期
        • 类目列表
        • 档期列表
        • 品牌列表
      • 商品
        • 商品列表
        • 批量查询商品
        • 商品库存
        • 商品运费
      • 优惠券
        • 查询商品券列表
        • 批量领优惠券
        • 查询已领优惠券
      • 订单
        • 订单接口说明
        • 拆单
        • 创建订单
        • 支付前取消订单
        • 订单发起支付
        • 获取订单详情
        • 物流轨迹查询
        • 订单确认收货
      • 售后
        • 售后接口说明
        • 是否支持换货
        • 创建售后单
        • 取消售后单
        • 查询售后退货地址
        • 保存物流信息
        • 修改物流信息
        • 用户确认操作
        • 售后单详情
      • 帐户
        • 账户余额查询
      • 基础数据
        • 查询所有省市区
      • 订阅通知
        • 查询可订阅服务
        • 查询已订阅服务
        • 批量订阅服务通知
        • 批量取消订阅服务通知
    • 回调通知
      • 商品变更消息通知
        POST
      • 订单状态变更通知
        POST
      • 订单状态异常通知
        POST
      • 发货状态变更通知
        POST
      • 售后状态变更通知
        POST
      • 售后创建补款单通知
        POST
      • 账户余额不足提醒
        POST
    • 数据模型
      • Activity
      • Goods
      • SkuInfo
      • SkuPriceInfo
      • SkuPurchaseLimitInfo
      • SkuAttributeInfo
      • GoodsAttributeInfo
      • GoodsAggAttributeInfo
      • PromotionDetailInfo
      • Coupon
      • Category
      • SkuStock
      • LogisticsCompany
      • OrderGroup
      • Order
      • OrderSku
      • OrderApprove
      • LogisticsTrace
      • LogisticsTraceItem
      • FreightInsuranceInfo
      • AccountBalance
      • AccountPayment
      • AccountBill
      • AccountBillItem
      • OpenapiAddressAreaResponse
      • CallbackService
      • PromoTag
      • PageResult
      • UserCoupon
      • OrderGoods
      • Receiver
      • OrderPromotion
      • SplitOrder
      • SplitOrderSku
      • AddressArea
      • ExchangeSkuTree
      • AftersaleReturnAddress
      • AftersaleApplyExtend
      • AftersaleApply
      • AftersaleExpressInfo
      • AftersaleConfirm
      • AftersaleDetail
      • OrderSkuLogistics
      • OrderLogistics
      • OrderDetail
      • OrderDetailSku
      • FreightInsurance
      • GoodsChange
      • OrderSkuChange
      • OrderChange
      • DeliverySkuChange
      • DeliveryChange
      • AftersaleChange
      • AftersaleSubsidyChange
      • AmountNotify
      • GoodsFreight
      • OrderErrorChange

    接口说明

    接入流程#

    1.
    申请测试环境appid/appsecret
    2.
    开发连调
    3.
    申请生产环境appid/appsecret
    4.
    生产验证

    环境说明#

    接口环境接口链接
    测试环境https://open-test.wanqidian.com
    生产环境https://open.wanqidian.com

    公共参数#

    调用API时必须传入的参数,且需要放在请求的query参数中,目前支持的公共参数如下:
    参数名必选类型说明
    appid是String分配给渠道的AppId
    timestamp是Long时间戳(秒),有效期10分钟
    noncestr是String随机字符串
    sign是String签名

    请求说明#

    传输协议:目前仅支持HTTPS
    传输方式:POST
    传输类型:application/json
    字符编码:UTF-8
    POST请求时,采用QueryString和Body结合的方式传值,公共参数通过QueryString传入,业务请求参数通过Body传入,并且设置请求的内容类型(Content-Type)为application/json,Body参数在签名时也是需要一起参与加签,具体方式请看下文

    签名算法#

    为了防止API调用过程中被恶意篡改,调用任何一个API都需要携带签名(sign),商品中台服务端会根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝。目前支持的签名算法为:SHA-1(sign_str),签名大体过程如下:
    对所有API请求参数(包括分配的appid、appsecret、timestamp、noncestr和body参数),根据参数名称的ASCII码表的顺序排序,Body请求体的参数key名称为body
    将排序好的参数以&符号连接, 比如:appid={appid}&appsecret={appsecret}&body={body}&noncestr={noncestr}&timestamp={timestamp}
    将拼接好的参数以UTF-8格式编码,并进行SHA1签名得到的签名结果再转化为小写,即得到签名字符串
    将签名字符串以sign为key附加到URL的QueryString后面,如:appid=ca5ff8s76e211d12016e21a627530031&noncestr=xxxxxx&timestamp=1584430120&sign=c6b8ce9e9d4a3a30d7db6e48f4a903efb099d15c
    以下提供JAVA代码示例和PHP代码示例,请参考

    JAVA代码示例#

    PHP代码示例#

    修改于 2025-08-19 15:20:06
    上一页
    错误码
    下一页
    类目列表
    Built with