
# 获取数据解密后的明文
#### 功能介绍
获取数据解密后的明文。水印功能只支持"华北-北京四"区域
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BCS&api=GetDataPlaintext)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 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 | 失败响应  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/devg-bcs/ErrorCode.html)。
