开放平台接入指南

接入指南

商家在入驻时系统会自动分配应用(App key App Sercret)信息，用户可以在Shippergrid商家端进行查看，开发需要保存到自己的系统服务中。

Shippergrid OpenAPI 提供了Java Sdk，开发者可直接使用Sdk对接，提高对接效率。调用接口步骤可参考下方代码示例：

 public static void main(String[] args) {
        String appKey = "28cd819d0305402bb02e7d01091160c8";
        String secret = "xj1CnrTho1Bc1YSxaZa8ghdqRxwn079prFHqkjGXzdO64TQuy4aIzs06qv5htyXk";
        String url = "https://31tj635zu781channel.millgrid.com/terminus/channelhub/api";
        ChannelClient client = new DefaultChannelClient( url, appKey, secret);
        WmsSkuCreateRequest request = new WmsSkuCreateRequest();
        //必填字段
        request.setChannelCode(OpenChannel.SHIPPER_GRID);
        WmsSkuCreateRequest.WmsSkuCreate wmsSkuCreateRequest = new WmsSkuCreateRequest.WmsSkuCreate();
        //必填字段
        wmsSkuCreateRequest.setOptEnum(WmsSkuCreateRequest.OptEnum.CREATE);
        wmsSkuCreateRequest.setSkuCode("2504UN0017TEST001");
        wmsSkuCreateRequest.setSkuNameCN("电脑");
        wmsSkuCreateRequest.setSkuNameEn("computer");
        wmsSkuCreateRequest.setSkuWeight(new BigDecimal(1.0));
        wmsSkuCreateRequest.setSkuLength(new BigDecimal(70));
        wmsSkuCreateRequest.setSkuWidth(new BigDecimal(70));
        wmsSkuCreateRequest.setSkuHeight(new BigDecimal(70));
        wmsSkuCreateRequest.setGoodsProperty(WmsSkuCreateRequest.GoodsAttributeEnum.GENERAL_GOODS);
        wmsSkuCreateRequest.setImageLink(Collections.singletonList("https://mg-static.erda.cloud/trantor2/portal/millgrid/24afff29-7f58-4ffe-84dd-cc83fab38201/2c4783516d25aa7da5b3f3e8b7195e45.jpeg"));
        wmsSkuCreateRequest.setSaleAttr("XXL,M");
        //非必填字段
        wmsSkuCreateRequest.setSkuAmt(new BigDecimal("1.1"));
        wmsSkuCreateRequest.setSkuUnit("PCS");
        wmsSkuCreateRequest.setImageLink(Collections.singletonList("https://test.millgrid.cn/millgrid/product_main/1e06aead-d467-4f50-bfe8-e4c330ce18b7/2febbe9b-d6e7-442a-8592-d71c044488ba (1).jpg".replace(" ", "%20")));
        wmsSkuCreateRequest.setRemark("备注");
        wmsSkuCreateRequest.setIsAutoSubmitAudit(true);
        List<WmsSkuCreateRequest.WmsSkuCreate> skuCreateList = new LinkedList<>();
        skuCreateList.add(wmsSkuCreateRequest);
        request.setSkuCreateList(skuCreateList);
        WmsSkuCreateResponse channelResult = client.execute(request);
        System.out.println(JSON.toJSONString(channelResult));
    }
}

注：所有接口限流15/qps,如有特殊情况可联系平台进行调整

环境说明：

UAT	https://31tj635zu781channel.millgrid.com/terminus/channelhub/api
生产	/

公共参数说明，sdk已内置签名加签，以下字段供开发者了解，其中channelCode字段

使用参考具体接口说明

参数名称	参数类型	是否必填	参数描述
methodName	String	是	API接口名称
channelCode	String	是	平台集成了多种渠道，channelCode代表了服务的提供方，具体传入请参考接口说明
traceId	String	是	链路ID，用于追查问题，客户端每次请求都会自动生成一个，建议客户端进行日志输出或持久化
timestamp	Number	是	当前时间戳，单位ms
appKey	String	是	平台分配给租户段应用key，与租户绑定，用于验签
appSecret	String	是	appSecret会参与客户端sign的生产逻辑 不会传入服务端
version	String	是	版本号，目前固定为1.0.0
sign	String	是	签名，sdk自动生成

更新日志

更新日期	更新版本	更新内容
2025-02-13	1.0	添加商品接口

SDK下载

目前仅提供java sdk，开发者自行下载 上传到自己的maven仓库

open-api-2.6.0-uat-SNAPSHOT.jar