3.30富媒体查询接口showMedia

请求地址:

请求方式:

参数说明

参数名称 类型 说明 备注
content String 请求的加密数据 必填
merchantId String 请求用户所属商户 必填

备注
content经过RSA解密后的json格式

  1. {
  2. "userName":"testuser",
  3. "antiFake":"4bbab6ff0d8042548cc6f2df9f3655fa",
  4. "timestamp":"20160518165030",
  5. "serverIP":"127.0.0.1",
  6. "data":{
  7. "vehicleId":123456,
  8. "mediaType":"st",
  9. "sTime":"2017-07-21 00:00:00",
  10. "eTime":"2017-07-21 12:00:00",
  11. "resType":"html"
  12. }
  13. }

content参数说明

名称 类型 说明 备注
userName String 用户名 必须
antiFake String 防伪随机串 必须
timestamp String 请求时间戳,精确到秒 必须
serverIP String 服务器IP 必须
data json 查询车辆信息 必须
data.vehicleId Int 查询车辆Id 必须
data.mediaType String 媒体类型,只有两种值:1:st 2:latest 当值是:st,表示为选择时间模式,则后面的sTime和eTime参数是必须的;当值是:latest,表示为最新30秒模式,则无需填写sTime和eTime参数 必须
data.sTime String 查询结束时间, 当mediaType是st时此参数是必须的 可选 格式(yyyy-MM-dd HH:mm:ss)
data.eTime String 查询结束时间, 当mediaType是st时此参数是必须的 可选 格式(yyyy-MM-dd HH:mm:ss)
data.resType String 富媒体结果返回类型, 只有两种值:1:json 2:html 当选择json时,是把视频url返回,选择html,则可直接在 必须

使用示例:

  1. 后台

    1. //读取privateKeyStr
    2. String privateKey=...........
    3. //获取数据签名
    4. SimpleDateFormat formatter = new SimpleDateFormat ("yyyyMMddHHmmss");
    5. String timestamp=formatter.format(new Date());
    6. String signStr=RSAUtils.sign(timestamp.getBytes(), privateKey);
    7. String ip=request.getRemoteAddr();
    8. //用私钥加密
    9. String ext=",\"data\":{.............}";//组装请求参数
    10. String dataStr="{\"userName\":\"testuser\",\"antiFake\":\""+signStr+"\",\"timestamp\":\""+timestamp+"\",\"serverIP\":\""+ip+"\" "+ext+" }";
    11. String content=RSAUtils.encryptByPrivateKey(dataStr, privateKey);
  2. 前端
    后台返回给前端加密后的content,然后发送请求调用
    http://xxxxx/ivci/api/vehicle/showMedia?merchantId=100000&content=content

返回数据
返回数据统一都是json格式

  1. {"code":0,"msg":"操作失败","data":""}
参数名称 类型 说明 备注
code String 操作结果码(成功=0,失败=1),见附录1 返回
msg String 操作返回信息(一般操作成功,返回null,失败的操作,才返回提示信息)  
data json 富媒体信息,当resType=html时,为字符换,当resType=json,为json对象 返回

Data数据格式,如下:

  1. "data":"<html><body></body></html>"