chainwaytsp

**Requested address：** 
- `/ivci/api/role/getRoleById`
  
**Requested mode：**
- POST,GET

**Parameter description**

|Parameter name|Type|Description|Remark|
|:----    |:---|:----- |-----   |
|content |String  |Requested encrypted data |Mandatory   |
|merchantId |String  |Request customer ID of the users | Mandatory    |

**Remark** 
Content is decrypted into json format via RSA
```
{
"userName":"testuser",
"antiFake":"4bbab6ff0d8042548cc6f2df9f3655fa",
"timestamp":"20160518165030",
"serverIP":"127.0.0.1",
"queryRole":{
"roleId":123
}
}
```

**Content parameter description**

|Parameter name|Type|Description|Remark|
|:----    |:---|:----- |-----   |
|userName  |  String | User name| Mandatory|
|antiFake  |  String | Anti-fake random string |  Mandatory|
|timestamp |  String | Request timestamp,accurate to second | Mandatory|
|serverIP   | String | Server IP |  Mandatory|
|queryRole |  json   | Query role information|  Mandatory|
|queryRole.roleId  |  int| Query Role ID | Mandatory|

**Use exampless ：**
1. Backend
```java
//Reading privateKeyStr
String privateKey=...........
// Get digital signature
SimpleDateFormat  formatter = new SimpleDateFormat ("yyyyMMddHHmmss");
String timestamp=formatter.format(new Date());
String signStr=RSAUtils.sign(timestamp.getBytes(), privateKey);
String ip=request.getRemoteAddr();
//Encrypted with private key
String ext=",\"queryRole\":{.............}";// Assemble the role information
String dataStr="{\"userName\":\"testuser\",\"antiFake\":\""+signStr+"\",\"timestamp\":\""+timestamp+"\",\"serverIP\":\""+ip+"\" "+ext+" }";
String content=RSAUtils.encryptByPrivateKey(dataStr, privateKey);
```

2. Front end
The backend return the encrypted content to the front end, and then send the request calling.
http://xxxxx/ivci/api/role/getRoleById?merchantId=100000&content=content

**Return data**
All return data should be in json format
```json
{"code":0,"msg":"Operate failed","data":{}}
```

**Return parameter**
 
|Parameter |Type|Description|Remark|
|:----    |:---|:----- |-----   |
|code  |  String  |Operate result code（success=0，failure=1），refer to appendix 1  | Return|
|msg |String | Operate return information（Operate succeed，return null；operate failed，return prompt information）  |&nbsp;|
|data   | json  |  Operate the return data (If it succeed, the result will be returned. For querying the data that has been returned successfully, if query it in batch, data will be returned. If query is single, json object will be received. For deleting, updating or other operation, return null which means no data is returned. |&nbsp;|

Return data need to be decoded, the decryption process is as follows:
```java
String key="......";
String mi="56D56B912C68308AA6D863DE087DBFD82D65C37836FC15E0B92";
String ming=RSAUtils.decryptByPrivateKey(mi, key);
```

3.11Query the role interface (getRoleById)