
# 授权ABE用户密钥
#### 功能介绍
授权ABE用户密钥
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BCS&api=AuthorizeABEUserKey)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
PUT /v1/datashare/abekey-order
#### 请求参数
表1请求Body参数 
| 参数           | 是否必选 | 参数类型                                                                    | 描述           |
|:---|:---|:---|:---|
| orgID        | 是    | String                                                                  | 组织id         |
| channelID    | 是    | String                                                                  | 通道id         |
| cryptoMethod | 是    | String                                                                  | 加密方法,目前固定为SW |
| cert         | 是    | String                                                                  | 证书           |
| sk           | 是    | String                                                                  | 私钥           |
| timestamp    | 是    | String                                                                  | 时间戳          |
| applyer      | 是    | String                                                                  | 申请者的身份标识     |
| provider     | 是    | String                                                                  | 授权者的身份标识     |
| attrJson     | 否    | Array of [attribute] objects | 属性列表         |
   
 表2attribute 
| 参数       | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| name     | 是    | String | 属性名                                                       |
| type     | 是    | String | 属性类型（plain，comparable）                                    |
| value    | 是    | String | 属性值（当type为plain时，value为属性值。当type为comparable时，value必须是整数。） |
| maxValue | 否    | String | 属性值上限，value可能取到的最大值。只在type为comparable时可选使用                |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数              | 参数类型    | 描述                             |
|:---|:---|:---|
| applyer         | String  | 申请者的身份标识                       |
| applyerName     | String  | 申请者的名称                         |
| provider        | String  | 授权者的身份标识                       |
| providerName    | String  | 授权者的名称                         |
| service         | String  | 授权者的服务名                        |
| price           | Integer | 价格                             |
| applyTime       | String  | 申请时间                           |
| encryptedABEKey | String  | 被加密的ABE密钥                      |
| status          | String  | 申请状态，request表示未授权；ready表示申请已处理 |
| reason          | String  | 原因                             |
| lockProof       | String  | 证明                             |
| attributesJson  | String  | 属性                             |
   
**状态码： 500**
表4响应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",
  "applyer" : "did:example:Mb4SshJeN5ukWXkbMJK8xC",
  "provider" : "did:example:Mb4SshJeN5ukWXkbMJK8xC",
  "attrJson" : "[{\"name\":\"att1\",\"type\":\"plain\",\"value\":\"att1name\"},{\"name\":\"att2\",\"type\":\"plain\",\"value\":\"att2name\"},{\"name\":\"att3\",\"type\":\"plain\",\"value\":\"5\"}]"
}
```
#### 响应示例
**状态码： 200**
ABE用户密钥订单信息
```
{
  "applyer" : "did:hwid:mfqqdiW8V64JbPFgQsoiv",
  "applyerName" : "",
  "provider" : "did:hwid:FahQr32NgQZWjGRiCZc37C",
  "providerName" : "",
  "service" : "",
  "price" : 0,
  "applyTime" : "",
  "encryptedABEKey" : "",
  "status" : "ready",
  "reason" : "",
  "lockProof" : "",
  "attributesJson" : "[{\"name\":\"att3\",\"type\":\"comparable\",\"value\":\"3\",\"maxValue\":\"1000\"}]"
}
```
**状态码： 500**
失败响应
```
{
  "errorCode" : "BCS.5002046",
  "errorMsg" : "Incorrect number of arguments"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | ABE用户密钥订单信息 |
| 500 | 失败响应        |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/devg-bcs/ErrorCode.html)。
