【赛盈-供应商端】开发者文档
    【赛盈-供应商端】开发者文档
    • 开发指南
    • 基础数据
      • 国家查询
        POST
      • 查询销售平台站点
        POST
      • 供应商查询计量单位
        POST
    • 商品中心
      • 查询兼容属性模板
        POST
      • 查询默认模板属性
        POST
      • 查询扩展模板属性
        POST
      • 查询图片标签
        POST
      • 查询段落
        POST
      • 查询描述标签
        POST
      • 查询侵权类型
        POST
      • 查询商品标签类型
        POST
      • 查询商品标签
        POST
      • 查询品牌
        POST
      • 查询零售限价
        POST
      • 查询供货分销价格
        POST
      • 查询分类
        POST
      • 查询品牌备案
        POST
      • 查询商品
        POST
      • 查询商品变更申请
        POST
      • 查询分销变更申请
        POST
      • 查询品牌授权
        POST
      • 查询刊登变更申请单
        POST
      • 查询刊登属性列表
        POST
      • 查询刊登单
        POST
      • 创建刊登单
        POST
      • 编辑刊登单
        POST
      • 重新刊登
        POST
      • 分类权限查询
        POST
    • 库存中心
      • 供应商圈货单查询
      • 供应商审核圈货申请单
      • 圈货释放申请单查询
      • 供应商仓库库存查询
      • 供应商专有库存查询
      • 供应商平台库存量更新
      • 商品仓库同步设置
      • 发货区域查询
      • 供应商设置第三方仓库
      • 供应商查询第三方仓库审核结果
      • 供应商第三方仓库查询
    • 订单中心
      • 获取标签信息
      • 订单发货异常标记
      • 订单拦截结果标记
      • 更新订单运输信息
      • 订单查询
      • 平台仓订单查询
      • 供应商退货单查询
      • 供应商退款单查询
      • 供应商圈货滞销单查询
      • 供应商圈货滞销审核
      • 供应商圈货缺货审核
      • 供应商圈货缺货单查询
      • 供应商审核圈货释放单
      • 供应商圈货单查询
      • 供应商审核圈货申请单
      • 供应商报价订单查询
      • 供应商报价订单更新
    • 渠道中心
      • 供应商设置第三方物流
      • 供应商查询第三方物流审核结果
      • 增值服务查询
    • 财务中心
      • 供应商待对账账单查询
      • 供应商已对账账单查询
      • 供应商对账确认
      • 供应商发票查询
    • 分销系统
      • 供应商查询货运属性

    开发指南

    一、文档说明#

    赛盈平台为第三方(供应商)提供的数据交互接口。

    二、技术说明#

    采用基于Web API的接口服务,URL表示操作的资源。交互的数据采用 JSON 格式。通过Token识别用户身份,通过DES加密方式验证请求。

    三、请求地址#

    URL:/api/Service/CommonService
    沙盒 ExternalUserKey:07889704111357825092854728216302
    沙盒 ExternalUserToken:98913967281527302970839321022796
    系统模块生产域名沙盒域名
    基础数据https://gsp-common-bscapi.saleyee.cnhttps://gsp-common-bsc-api-uat.saleyee.cn
    商品中心https://gsp-goods-bscapi.saleyee.cnhttps://gsp-goods-bsc-api-sbx.saleyee.cn
    库存中心https://bsc-stock-api.saleyee.cnhttps://gsp-stockcenter-api-uat.saleyee.cn
    订单中心https://bsc-order-api.saleyee.cnhttps://gsp-ordercenter-api-uat.saleyee.cn
    渠道中心https://bsc-channel-api.saleyee.cnhttps://bsc-channelcenter-api-uat.saleyee.cn
    财务中心https://bsc-finance-api.saleyee.cnhttps://bsc-financecenter-api-sbx.saleyee.cn

    四、公共参数#

    请求参数#

    名称类型说明
    VersionString版本号(当前版本为:1.0.0.1)
    ExternalUserKeyString授权用户的访问凭证key
    ExternalUserTokenString授权用户的访问凭证token
    SignStringDES加密后的签名字符串
    RequestIdString请求唯一标识(可使用GUID)
    RequestTimeString请求发起时间
    MessageString业务数据(JSON字符串)
    MessageTypeString调用的接口名称
    报文示例
    {"Version":"1.0.0.1","ExternalUserKey":"+dMLIr3N7DjG4CDjAAdwK2ikXOBMixoI","ExternalUserToken":"AJxDQ5Ecv8btHBK3nNGgmaxBV7ZemkzwaXj6EeyQpFE=","Sign":null,"RequestTime":"2025-06-10T17:49:19","RequestId":"fa84ddc2-7162-4489-bb78-ab94f4de1289","Message":"{\"TrDateTimeBegin\":\"2023-06-10T17:01:30\",\"TrDateTimeEnd\":\"2025-06-10T17:01:30\",\"ReturnOrderNoList\":null,\"InitialOrderNoList\":null,\"rows\":0,\"NextToken\":null}","MessageType":"QuerySupplierReturnOrder"}

    响应参数#

    名称类型说明
    VersionString版本号
    RequestIdString请求唯一标识
    RequestTimeString请求发起时间
    ResponseIdString响应唯一标识
    ResponseTimeString响应时间
    RequestMessageString请求发送的数据
    ResultInt响应结果(0失败,1成功)
    ErrorObject错误信息
    - CodeString错误编码
    - ShortMessageString简略错误消息
    - LongMessageString详细错误消息
    MessageString响应数据(JSON字符串)

    五、业务参数#

    API 调用除了必须包含公共参数外,如果本身有业务级的参数也必须将其赋值给公共请求参数的 Message 字段,各 API 的业务级参数请参考各接口详细信息。
    响应数据处理,则建议将公共响应参数中的 Message 字段反序列化处理,得业务数据对象。

    六、签名算法#

    为了防止 API 调用过程中被恶意篡改,调用任何一个 API 都需要携带请求签名,服务端会根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝。目前使用的签名算法为:DES(模式CBC、填充pkcs7padding),签名过程如下:
    1
    将公共参数封装为对象(含Sign字段,默认值为null)
    2
    将业务参数转换为json类型,赋值给公共参数的Message字段
    3
    将公共参数对象序列化为json字符串,使用DES(CBC、pkcs7padding)进行加密,得到签名字符串
    4
    将签名字符串赋值给公共参数对象Sign字段后,即可发起http请求
    签名密钥:sy%3dz$p

    七、签名示例(.net)#

    public static string SignDemo(string data)
    {
        byte[] byKey = "sy%3dz$p";
        byte[] byIV = "sy%3dz$p";
        using (DESCryptoServiceProvider cryptoProvider = new DESCryptoServiceProvider())
        using (MemoryStream ms = new MemoryStream())
        using (CryptoStream cst = new CryptoStream(ms, cryptoProvider.CreateEncryptor(byKey, byIV), CryptoStreamMode.Write))
        using (StreamWriter sw = new StreamWriter(cst))
        {
            sw.Write(data);
            sw.Flush();
            cst.FlushFinalBlock();
            sw.Flush();
            byKey = byIV = null;
            return Convert.ToBase64String(ms.GetBuffer(),0,(int)ms.Length);
        }
    }

    八、请求示例(.net)#

    public static string RequestDemo(string data)
    {
        // 公共参数
        string url = "http://localhost:8906/zh-CN/api/Service/CommonService";
        ExtServiceRequest request = new ExtServiceRequest();
        request.RequestId = Guid.NewGuid().ToString();
        request.RequestTime = DateTimeHelper.GetNowDateTime();
        request.Version = "1.0.0.1";
        request.AppToken = "o5Nf65FiKgoQu1df1jI1syOmVZQJyCPn";
        // 业务参数
        SupplierQueryCompatibleTemplateRequest inRequest = new SupplierQueryCompatibleTemplateRequest();
        inRequest.StartTrDateTime = DateTimeHelper.GetNowDateTime().AddYears(-1);
        inRequest.EndTrDateTime = DateTimeHelper.GetNowDateTime();
        string inRequestJson = SerializableConvert.SerializeObject(inRequest);
        request.Message = inRequestJson;
        // 接口名称
        request.MessageType = "SupplierQueryCompatibleTemplate";
        // 签名
        string json = SerializableConvert.SerializeObject(request);
        string data = EncryHelper.GetEncodeString(json);
        request.Sign = data;
        // 发起请求
        HttpClient client = new HttpClient();
        HttpResponseMessage responseMessage = client.PostAsJsonAsync(url, request).Result;
        string responseContent = responseMessage.Content.ReadAsStringAsync().Result;
        // 解析响应数据
        ExtServiceResponse response = SerializableConvert.DeserializeObject<ExtServiceResponse>(responseContent);
        ExtCategoryResponse extResponse = SerializableConvert.DeserializeObject<ExtCategoryResponse>(response.Message);
    }
    修改于 2025-09-17 10:03:56
    下一页
    国家查询
    Built with