# centec6-standard-api

**Repository Path**: 86992773/centec6-standard-api

## Basic Information

- **Project Name**: centec6-standard-api
- **Description**: 盛世云商标准接口示例
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-11-11
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 盛世云商6.0 - 标准API接口

## 1 项目配置

1、依赖 centec6-standard-api-service

2、根据 main/java/cn.centec.core.config.Centec6Properties 增加配置

    # 系统ID
    centec6.sid=
    # 云商地址
    centec6.url=
    # 对接密钥
    centec6.secret=

## 2 交互说明

### 2.1 推送数据到盛世云商

1、保存本地数据

2、调用 Centec6BidRequestApiUtil/Centec6MallRequestApiUtil 的方法

#### 2.1.1、扩展请求参数

1、重写扩展参数的类

    参考 test/java/cn.centec.entity.StandardContractCreateParamImpl
    
2、将重写的类作为方法调用参数

    参考 test/java/cn.centec.service.RequestTestService.createContract()
    
3、通过盛世云商渲染扩展的参数    

### 2.2 接收盛世云商的数据

1、编写 Controller 接收请求

    参考 test/java/cn.centec.web.Centec6Controller

2、实现 Centec6BidReceiveHandler/Centec6MallReceiveHandler 并声明为Bean，在接收请求时处理本地业务

#### 2.2.1、扩展接收参数

1、通知盛世云商录入扩展参数

2、重写扩展参数的类（可以不继承标准参数类，而只声明需要的参数）

    参考 test/java/cn.centec.entity.StandardSupplyCreateParamImpl
    
3、获取完整参数（使用原始参数，反序列化为自定义的扩展类）

    参考 test/java/cn.centec.service.Centec6ReceiveApiUtilImpl.createSupply(StandardSupplyCreateParam)

### 2.3 接口安全

1、系统对接时，由盛世云商分配"系统ID"和"密钥"，双方妥善保存

2、请求方对参数进行签名

    DigestUtils.md5Hex(系统ID + 请求模块 + 请求方法 + 请求参数 + 密钥);
    
3、接收方使用相同的签名算法进行验签，匹配时执行处理

### 2.4 数据关联

1、文件地址：双方根据系统部署场景进行约定，来保证都能读取到文件。通常使用可以被网络访问的HTTP文件地址互传。
    
    例："http://img.ys360.net/a.jpg#图片A名称.jpg,http://img.ys360.net/b.jpg#图片B名称.jpg"
    
2、采购编号：采购系统内部保证自己的编码唯一，双方交互使用采购系统提供的编码。

3、投标编号：根据采购编号和供应商ID，确定数据唯一。

4、合同编号：采购系统内部保证自己的编码唯一，双方交互使用采购系统提供的编码。

5、订单编号：采购系统内部保证自己的编码唯一，双方交互使用采购系统提供的编码。