数据托管接口
浪潮云码获取数据推送票据接口
获取数据推送票据请求。
调用地址
https://iccs-cn-beijing.qualink.com/iccs/getPushId
接口参数说明
类别 |
参数 |
是否必填 |
数据类型 |
说明 |
入参 | appid |
是 |
字符串 |
第三方平台接入码 |
codeType |
是 | 字符串 | 云码类型 | |
codeData |
是 | 字符串 | 数据载荷 动态编码时该值为身份载荷 链接活码时为目标链接 静态编码时为序列号 | |
colName |
是 | 字符串数组 | 要推送数据到的集合名称 | |
prooFlag |
否 | 字符串 | 数据存证标识:0:不存证;1:存证客户推送数据的哈希值;2:存证客户推送数据的加密结果;3: 存证客户推送的数据(明文) | |
出参 | resultCode |
是 |
字符串 |
结果返回码,详见附录A |
resultDesc |
是 |
字符串 |
结果描述 |
|
ticket |
是 |
字符串 |
推送票据 |
返回示例
返回数据格式统一采用JSON格式如下所示。
{
"resultCode": "0",
"resultDesc": "成功",
"ticket": "AFE5C0D9A7A7E68BD319EFD50E83E90E2431494C8C1B6830CB816B98422B8BB9"
}
浪潮云码数据推送接口
数据推送请求。
调用地址
https://iccs-cn-beijing.qualink.com/iccs/pushCode
接口参数说明
类别 |
参数 |
是否必填 |
数据类型 |
说明 |
入参 | appid |
是 |
字符串 |
第三方平台接入码 |
ticket |
是 | 字符串 | 推送票据ID | |
data |
是 | 字符串 | 要推送的数据,该值为单条Json构造的字符串 | |
version |
否 | 字符串 | 要更新的数据标识 | |
出参 | resultCode |
是 |
字符串 |
结果返回码,详见附录A |
resultDesc |
是 |
字符串 |
结果描述 |
|
bizId |
否 |
字符串 |
数据推送业务ID |
|
txId |
否 |
字符串 |
数据推送交易ID |
|
version |
否 |
字符串 |
数据推送版本号 |
返回示例
返回数据格式统一采用JSON格式如下所示。
{
"resultCode": "0",
"txId": "317d811b94f7f0a9b107606db49f10a303a83e07210fcb26d78b02bf9dfd1116",
"resultDesc": "推送成功!",
"version": "8B2E4C5BB7ABD5907EBBC37A29FA3D029C6B291C90C5F99C4ED466B59416CC4B"
}
浪潮云码数据拉取接口
数据推送请求。
调用地址
https://iccs-cn-beijing.qualink.com/iccs/shareCode
接口参数说明
类别 |
参数 |
是否必填 |
数据类型 |
说明 |
入参 | appid |
是 |
字符串 |
第三方平台接入码 |
beginTime |
是 | 字符串 | 查询数据开始时间(yyyyMMddHHmmss) | |
endTime |
是 | 字符串 | 查询数据结束时间(yyyyMMddHHmmss) | |
shareData |
否 | 数据集合 | 验码接口获取的拉取票据 | |
出参 | resultCode |
是 |
字符串 |
结果返回码,详见附录A |
resultDesc |
是 |
字符串 |
结果描述 |
|
shareData |
是 |
字符串 |
拉取数据结果 |
返回示例
返回数据格式统一采用JSON格式如下所示。
{
"resultCode": "0",
"resultDesc": "调用成功",
"shareData": [
{
"errMsg": "票据错误或已失效",
"share3": ""
},
{
"errMsg": "集合名称错误",
"code_cloud": ""
},
{
"errMsg": "",
"code_check": [
"{ \"key301\" : \"value33131\", \"key3132\" : \"value33111\", \"txId\" : \"null\", \"_version\" : \"61A377344900B7BE795FD29D57DF3E99133CD6A879E925EDD918DB929A8E7B25\", \"key31\" : \"value33121\" }",
"{ \"key301\" : \"value33131\", \"key3132\" : \"value33111\", \"txId\" : \"null\", \"_version\" : \"2B28A28AA33DEDB417496AAACD241BE3E741E711BBC44D642E812EAE21F905E6\", \"key31\" : \"value33121\" }",
"{ \"key301\" : \"value33131\", \"key3132\" : \"value33111\", \"_version\" : \"A81F9B90E03222B5EB18F0D0EB2905A04BCB9B2DFE1C2D9A3C27E04AC9B13C00\", \"key31\" : \"value33121\" }",
"{ \"key301\" : \"value33131\", \"key3132\" : \"value33111\", \"_version\" : \"B3F06970297853319902BA2B93E056387A842B9F95136844D9E98DA0E500083C\", \"key31\" : \"value33121\" }"
]
}
]
附录
附录A
表A.1 接口返回值列表
返回值编码 |
编码描述 |
0 | 接口调用成功 |
11 | 身份验证不通过 |
99 | 其他异常 |
附录B
表B.1 控制台状态
状态值 |
说明 |
00 | 等待初始化 |
01 | 启动中 |
02 | 运行中 |
03 | 即将过期 |
04 | 停止中 |
05 | 已停止 |
06 | 已过期 |
07 | 过期回收中 |
08 | 欠费回收中 |
09 | 已锁定 |
表B.2 服务状态(serviceStatus)
状态值 |
说明 |
00 | Pending等待初始化 |
01 | Starting正在启动中 |
02 | Running正在运行中 |
03 | Stopping正在停止中 |
04 | Stopping服务已停止 |
附录C
表C.1 时间戳格式
时间戳参数(接口调用参数) |
示例(前端页面展示) |
不使用时间戳 |
|
YYYYMMDDhhmmssSSS | 20200525175201022 |
YYYYMMDDhhmmss | 20200525175203 |
YYYYMMDDhhmm | 202005251753 |
YYYYMMDDhh | 2020052517 |
YYYYMMDD | 20200525 |
YYMMDD | 200525 |
YYYYMM | 202005 |
YYMM | 2005 |