上报事件API

  • 请求方法为 POST。
  • 数据提交方式 application/json。
  • 支持https调用。
  • 支持微信/支付宝小程序、App、Web端等调用。
请求参数
名称 类型 是否必须 描述
app_key String TOP分配给应用的AppKey。
session String 用户登录授权成功后,TOP颁发给当前用户的授权信息,API提示需要授权信息时,必传。
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。API服务端允许客户端请求最大时间误差为前后各3分钟。
sign String API输入参数签名结果(仅支持md5加密)
  • 对所有API请求参数(包括公共参数和业务参数,但除去sign参数、非必填项值为空的参数、byte[]类型的参数,byte[]使用base64编码后,也无需加入签名),根据参数名称的ASCII码表的顺序排序。如:foo:1, bar:2, foo_bar:3, foobar:4排序后的顺序是bar:2, foo:1, foo_bar:3, foobar:4。
  • 将排序好的参数名和参数值拼装在一起,根据上面的示例得到的结果为:bar2foo1foo_bar3foobar4
  • 把拼装好的字符串采用utf-8编码,使用签名算法对编码后的字节流进行摘要。如果使用MD5算法,则需要在拼装的字符串前加上app的secret后,再进行摘要,如:md5(secret+bar2foo1foo_bar3foobar4)。
响应参数
名称 类型 描述
is_error Boolen 是否出错
error_code String 错误码
error_msg String 错误信息
msg String 业务信息

接口地址:http://api-for.reelmall.cn/v1/prtivoli/get

接口说明:

请求参数:
名称 类型 必须 示例值 描述
prtivoli_id Number true 事件id

响应参数:
名称 类型 示例值 描述
prtivoli PrTivoli 事件详情

接口地址:http://api-for.reelmall.cn/v1/prtivoli/getlist

接口说明:

请求参数:
名称 类型 必须 示例值 描述
prtivolitype_id Number false 类别id
user_id Number true 用户id
prtaskitem_id Number false 巡护子数据id
start_created DateTime false 任务创建时间,默认60天前,格式:1970-01-01 00:00:00
end_created DateTime false 任务创建截至,默认当天,格式:1970-01-01 00:00:00
page_size Number false 每页行数,默认20
page_no Number false 第几页,默认1

响应参数:
名称 类型 示例值 描述
prtivolis PrTivoli[] 事件集合
total_results Number 总行数
total_pages Number 总页数

接口地址:http://api-for.reelmall.cn/v1/prtivoli/add需要授权信息

接口说明:

请求参数:
名称 类型 必须 示例值 描述
prtivolitype_id Number true 类型id
desc String true 描述
address String true 地址
coords String true 坐标,经纬度
equi_no String false 部分涉及巡检设备上报类型,需传设备编号
prtaskitem_id Number false 巡护子数据id
remark String false 备注信息,如:野猪2只,预估面积9亩 等
image_id Number true 上传图片文件id
image_url String true 上传图片文件url
audio_id Number false 音频文件id,无则不传
audio_url String false 音频文件url,无则不传
add_time DateTime true 2000-01-01 00:00:00 上报时间,格式:yyyy-MM-dd HH:mm:ss

响应参数:
名称 类型 示例值 描述
prtivoli_id Number 上报完成后,返回当前事件id

接口地址:http://api-for.reelmall.cn/v1/prtivoli/addasset

接口说明:

请求参数:
名称 类型 必须 示例值 描述
prtivoli_id Number true 事件id
prtivoliitem_type Number true 上报文件类型,1:实景图,2:语音,3:视频,4:其他
asset_id Number true 文件id
asset_url String true 文件url
asset_desc String false 文件描述

响应参数:
名称 类型 示例值 描述
prtivoli_asset_id Number 事件资源id

接口地址:http://api-for.reelmall.cn/v1/prtivoli/gettypelist

接口说明:

请求参数:
名称 类型 必须 示例值 描述
pid Number false 父id,不传或传入0时,则返回一级所有类型
has_child Boolean false 是否查询子类型,默认false

响应参数:
名称 类型 示例值 描述
prtivolitypes PrTivoliType 上报种类集合