文档首页/ 区块链服务 BCS/ 开发指南/ 区块链中间件接口/ 可信数据交换（公测）/ 数据集管理/ 获取数据解密后的明文
更新时间：2023-03-06 GMT+08:00
查看PDF
分享

获取数据解密后的明文

功能介绍

获取数据解密后的明文。不支持水印功能

URI

POST /v1/datashare/dataset/query-plaintext

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

orgID

是

String

组织id

channelID

是

String

通道id

cryptoMethod

是

String

加密方法，目前固定为SW

cert

是

String

证书

sk

是

String

私钥

timestamp

是

String

时间戳

consumer

是

String

订单申请者身份标识

orderSeq

是

String

订单序列号

encryptData

否

String

数据密文，当onChainStore设置为“true”时，可不输入

watermarkType

否

String

水印类型，visible明水印，blind暗水印，嵌入水印时，必须填写本字段。如果发布或主动分享数据集的时候嵌入的是暗水印，则无法再次嵌入暗水印。嵌入的水印内容为：使用人did_orderID。

onChainStore

否

String

数据密文是否在链上存储，可设置为“true”或“false”，默认为“false”。如果设置为“true”，则不需要输入encryptData，可自动在链上获取数据密文

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

provider

String

订单提供者身份标识

productID

String

数据集产品id

plaintext

String

base64编码的数据明文

状态码： 500

表3 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

errorMsg

String

错误描述

请求示例

{
  "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b",
  "channelID" : "mychannel",
  "cryptoMethod" : "SW",
  "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----",
  "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----",
  "timestamp" : "2020-10-27T17:28:16+08:00",
  "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG",
  "orderSeq" : "1",
  "encryptData" : "base64 encoding string",
  "watermarkType" : "string",
  "onChainStore" : "string"
}

响应示例

状态码： 200

订单信息。

{
  "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG",
  "productID" : "product1",
  "plaintext" : "base64 encoding string"
}

状态码： 500

失败响应

{
  "errorCode" : "BCS.5002046",
  "errorMsg" : "Incorrect number of arguments"
}

状态码

状态码

描述

200

订单信息。

500

失败响应

错误码

请参见错误码。

父主题： 数据集管理