MyService
支持下列操作。有关正式定义,请查看服务说明。
-
AddDangerBasics
隐患录入
参数:
string Token: Token, 未加密
参数:
string dangerDeptName 隐患部门
string dangerLevelName (固定1级,2级,3级)如1级
string dangerReason 隐患描述(格式:描述1,描述2)多个描述之间,隔开
string fxUserName 发现人(登陆名称)
string address 发现地点
string time 发现时间(格式:2019-01-05 14:02)
string imgPathList 图片地址集合,(格式:1.jpg,2.jpg)多张图片之间以,隔开
string handlerUser 处理人名称
返回值:Result 描述 Result=1 执行成功,Message插入数据的ID Result=-1 程序错误,Message为错误信息 Result=-5 数据重复 Result=-2 公司不存在 Result=-13 隐患部门不存在 Result=-14 部门隐患等级不存在 Result=-10 当前登录帐号已经在其他机器上登录
-
AdminFingerApply
删除管理员指纹:提出申请
参数:
string Token: Token 数据
string DeviceNo: 设备编码(加密)
返回结构:
ReturnValue<List<UserFingerModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;
public string Message;
public T Values;
}
返回值:结果 描述 Result=0 返回结果,服务器已经收到 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-4 服务器接受消息失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
AdminFingerQuery
查询删除指令
参数:
string Token: Token 数据
string DeviceNo: 设备编码(加密)
返回结构:
ReturnValue<List<UserFingerModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;
public string Message;
public T Values;
}
返回值:结果 描述 Result=0 此设备存在“删除管理员指令”,可以在机器上删除指纹 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-4 后台没有发出“删除管理员指纹”的指令 Result=-5 指令已经执行。无须重复执行 Result=-6 发生未知错误 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
AppendAddressCardToRoute
将地址卡绑定到线路
参数:
string Token:Token,
string RouteID: 线路 ID,加密
string ListCardID: 地址卡 ID 集合【SpotInfo 类中 SpotID 字段,先将多个SpotID用英文逗号,隔开,拼接为一个字符串,然后加密】加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-11 输入的线路ID,不存在 Result=-12 输入线路不为“子线路”【只有子选路才能添加地址卡】 Result=-13 输入的地址卡集合不能为空 Result=-14 不能在根线路下,添加地址卡 Result=-31 Token失效
-
AppendCrashRecord
Z-9000 跌摔记录
参数:
string Token: Token 数据
string DeviceNo: 设备编码,加密
返回值:结果 描述 Result=0 新增成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
AppendFeedback
保存“意见反馈”
参数:
string Token: Token 数据
string TypeID:意见分类(目前传入固定值 0),加密
string Content:内容
返回值:结果 描述 Result=0 新增成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 Token失效 提示:Result=-4 新增失败
- AppendRoute
新增一条线路
参数:
string Token:Token,
string ParentID: 父线路 ID 【必须为大于零的正整数】,加密
string RouteName: 线路名称加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message 为“新增的线路的 ID” Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-11 此先来已经绑定地址卡,不能添加子线路 Result=-12 此线路名称已经存在 Result=-13 根线路已经存在 Result=-14 该公司路线名额已满,不能再创建新线路 Result=-31 Token失效
- AppendRoute
-
AuditRisk
隐患审核
参数:
string Token: Token, 未加密
参数:
int 隐患id
string auditoruserName 审核人 如admin
string auditorJieg 审核结果 如:处理成功或驳回
string auditorTime 审核时间(格式:2018-09-05 8:14)
string auditstat 隐患状态(1,2,3,4,5 对应 处理中,处理驳回,审核中,审核驳回,审核完成)
string auditImgPath 审核多图片地址列表(格式:1.jpg,2.jpg)多张图片之间以,隔开
返回值:Result 描述 Result=1 执行成功,Message为成功信息 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-10 当前登录帐号已经在其他机器上登录
-
ChackDeviceName
检查登录手机名称是否为空
参数:
string Token:Token
string DeviceNo:设备编号,加密
返回值:Result 描述 Result=0 设备不存在或者名称不为空,不需要做任何处理 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 设备(手机)名称为空,需要输入手机名称 Result=-31 Token 失效
-
CheckCardExist
判断卡号信息是否存在【需要同时判断卡号以及名称是否都不存在】
参数:
string Token: Token,
string CardNo: 卡号(八位长度的,十六进制字符串), 不为空,加密
string CardName: 卡号名称、描述, 不为空,加密
返回值:Result 描述 Result = 0 判断结果:卡号以及名称都不存在 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-3 卡号已经存在 Result=-4 卡名称重复 Result=-31 Token 失效 -
CheckRegType
扫描二维码,由服务器判断,是“注册公司”还是“注册用户”
APP有两种注册:
第一种:注册公司
第二种:注册用户
参数:
string DeviceTypeNo:机器型号(通过解码激活码所得,00010803),加密
string DeviceID:机号(通过解码激活码所得,2025032500001),加密
string TypeID:占位,加密
string ERCodeString:APP扫描二维码获取的二维码中包含的字符串信息,加密
string ActivaCode:激活码
返回结构:
public class ReturnValue
{
public string Result; // 错误代码
public string Message; // 错误信息
}
public class RegCompanyModel
{
public int CompanyID; // 公司ID 或者 经销商 ID
public string CompanyCode; // 公司编码 或者 经销商编码
public string CompanyName; // 公司名称 或者 经销商名称
}
返回值:Result 描述 Result=0 后台解析二维码内容成功【 Message = 1、注册公司;2、注册用户;】 Result=-1 程序错误,Message 为错误信息 Result=-10 扫描的二维码不能为空 Result=-11 公司二维码错误(长度不对) Result=-12 经销商不存在 Result=-13 公司不存在 Result=-14 经销商二维码错误(长度不对) Result=-15 经销商与公司的关系不匹配 Result=-16 无效二维码 Result=-17 此二维码已经注册过公司,不能重复注册,请更换注册二维码 Result=-18 解密经销商信息,出现错误
-
CompareToken
判断当前用户是否在其他设备上登录 -
CountDangerStat
根据隐患状态获取隐患数量
参数:
string Token: Token, 未加密
参数:
string userId(登陆账号ID)
string auditstat 隐患状态(1,2,3,4,5 对应处理中,处理驳回,审核中,审核驳回,审核完成)空值为所有,默认空值,可传多个状态值如:1,2,3
返回值:Result 描述 Result=1 执行成功,Message为数量 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-10 当前登录帐号已经在其他机器上登录
-
DeleteAddressCardFromRoute
将地址卡从线路中删除
参数:
string Token:Token,
string RouteID: 线路 ID,加密
string ListCardID: 地址卡 ID 集合【SpotInfo 类中 SpotID 字段,先将多个SpotID用英文逗号,隔开,拼接为一个字符串,然后加密】加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-20 需要删除地址卡ID,不能为空 Result=-31 Token失效
-
DeleteOperators
注销(删除)用户
参数:
string Token:Token
string DeviceTypeNo:机器型号(APP中定义的全局变量),加密
string UserID:用户唯一标识【QueryOperators 接口返回的UserID】,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-11 不能注销当前用户 Result=-12 公司至少需要保留一个“管理员” Result=-31 Token 失效
-
DeleteRoute
删除一条线路
参数:
string Token:Token,
string RouteID: 需要删除的线路的 ID 【必须为大于零的正整数】,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-4 非管理员,无操作权限 Result=-10 当前登录帐号已经在其他机器上登录 Result=-13 此线路下,存在“子线路”,不能删除 Result=-14 此线路下,存在“地址卡”,不能删除 Result=-31 Token失效
-
DeleteUserFinger
从设备中删除指纹
参数:
string Token: Token 数据
string DeviceNo: 设备编码(加密)
string FingerIndex: 指纹序号【序号从0开始,删除所有指纹,传入的值为“-1”】(加密)
返回结构:
ReturnValue<List<UserFingerModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;
public string Message;
public T Values;
}
返回值:结果 描述 Result=0 删除成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 删除失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
提示:
-
ForceLogin
在一台机器上,将指定登录帐号,从另外一台机器上强行挤下
参数:
string Token:Token
string DeviceNo:设备编号,加密
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 Token 非法 Result=-11 没有执行任何操作 Result=-31 Token 失效
-
GetAPPDeviceList
获取APP设备列表
参数:
string Token:Token 不为空;
string DeviceTypeNo:机器型号(占位,直接为空),加密
string DeviceNo:设备号(占位,直接为空),加密
string Keyword:查询关键字(占位,直接为空),加密
返回结构:
public class DeviceMode
{
public string MeterType; // 机器型号 00010801、00010802
public string DeviceRealID; // 机器完整的机号(机器型号 + 机器ID) 举例 0001080113800138000、00010803202503250456
public string MeterID; // 登录用户名称【如果使用人脸登录,则使用这个属性做为参数】
public string DeviceAllowReadCardModel; // 当前设备【能够允许】的读卡模式【1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码; 返回的值为1,2,3】
public string DeviceReadCardModel; // 当前设备【已经设置成功】的读卡模式【返回的值为1,2,3 ,可以为多种打卡模式】
public int RouteID; // 当前设备绑定的线路
public int RouteName; // 当前设备绑定的线路
}
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token非法 Result=-3 Token失效 Result=-10 当前帐号已经在其他设备登录
-
GetCountDanger
隐患统计(按状态)
参数:
string Token: Token, 未加密
参数:
dangerDeptName //隐患部门,如消防(部门),为空则为全部部门,默认空值
string 参数:
DangerLevelName //隐患级别(固定1级,2级,3级)如1级,为空则为全部级别,默认空值
string 参数:
beginDate 开始时间 (格式:2019-08-09 8:00)
string 参数:
endDate 开始时间 (格式:2019-08-09 10:00)
string 参数:
numUrl 数量的链接地址,默认空值
string
返回值:Result 描述 Result=0 执行成功,返回结构ReturnValue Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 数据不存在 Result=-10 当前登录帐号已经在其他机器上登录
返回结构ReturnValue- json 字符串数据
public string AuditNum; //审核中数量
public string AuditFulfillNum; //审核完成数量
public string InHandNum; //处理中数量
-
GetDangAuditList
根据用户ID查询当前ID能审核的记录
参数:
string Token: Token, 未加密
参数:
string userId登陆账号ID 必填
返回值:
返回结构ReturnValueResult 描述 Result=0 获取成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-4 Token 用户ID未填写! Result=-3 查询无数据 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效! - json 字符串数据
public string DangerDeptName; //隐患部门,如消防(部门)
public string DangerLevelName; //隐患级别(固定1级,2级,3级)如1级
public string DangerReason; //隐患描述,(格式:描述1,描述2) 描述之间,隔开
public string FxUserName; //发现人(登陆人名称)
public string Address; //发现地点 如:巡更点1
public string Time; //发现时间 (格式:2019-05-01 8:00)
public string CurrUserId; //当前处理人ID (登陆ID)
public string DisposeResult; //处理结果 (格式:处理人:aaa,处理内容:xx原因被驳回,处理时间:2019-05-25|处理人:bbb,处理内容:处理成功xxx,处理时间:2019-05-26)多条处理间以|隔开,如处理结果1|处理结果2
public string ImgPathList; //隐患处理图片地址集合 。(格式:1.jpg,2.jpg)多张图片之间以,隔开
-
GetDangChuliList
根据用户ID查询当前ID能处理的记录
参数:
string Token: Token, 未加密
参数:
string userId登陆账号ID 必填
返回值:
返回结构ReturnValueResult 描述 Result=0 获取成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-4 Token 用户ID未填写! Result=-3 查询无数据 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效! - json 字符串数据
public string DangerDeptName; //隐患部门,如消防(部门)
public string DangerLevelName; //隐患级别(固定1级,2级,3级)如1级
public string DangerReason; //隐患描述,(格式:描述1,描述2) 描述之间,隔开
public string FxUserName; //发现人(登陆人名称)
public string Address; //发现地点 如:巡更点1
public string Time; //发现时间 (格式:2019-05-01 8:00)
public string CurrUserId; //当前处理人ID (登陆ID)
public string DisposeResult; //处理结果 (格式:处理人:aaa,处理内容:xx原因被驳回,处理时间:2019-05-25|处理人:bbb,处理内容:处理成功xxx,处理时间:2019-05-26)多条处理间以|隔开,如处理结果1|处理结果2
public string ImgPathList; //隐患处理图片地址集合 。(格式:1.jpg,2.jpg)多张图片之间以,隔开
-
GetDangerList
根据登陆账号和隐患ID获取隐患信息userId为空则为全部
参数:
string Token: Token, 未加密
参数:
string userId登陆账号ID
int 隐患ID返回值:
返回结构ReturnValueResult 描述 Result=0 获取成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效! - json 字符串数据
public string DangerDeptName; //隐患部门,如消防(部门)
public string DangerLevelName; //隐患级别(固定1级,2级,3级)如1级
public string DangerReason; //隐患描述,(格式:描述1,描述2) 描述之间,隔开
public string FxUserName; //发现人(登陆人名称)
public string Address; //发现地点 如:巡更点1
public string Time; //发现时间 (格式:2019-05-01 8:00)
public string CurrUserId; //当前处理人ID (登陆ID)
public string DisposeResult; //处理结果 (格式:处理人:aaa,处理内容:xx原因被驳回,处理时间:2019-05-25|处理人:bbb,处理内容:处理成功xxx,处理时间:2019-05-26)多条处理间以|隔开,如处理结果1|处理结果2
public string ImgPathList; //隐患处理图片地址集合 。(格式:1.jpg,2.jpg)多张图片之间以,隔开
public string AuditorImgPathList; //隐患审核图片地址集合。(格式:1.jpg,2.jpg)多张图片之间以,隔开
public string Auditstat; //隐患状态(1,2,3,4,5 对应 处理中,处理驳回,审核中,审核驳回,审核完成)
public string AuditorReult; //审核结果 (格式:审核人:aaa,审核内容:xx原因被驳回,处理时间:2019-05-25|审核人:bbb,审核内容:审核成功xxx,审核时间:2019-05-26)多条审核间以|隔开,如审核结果1|审核结果2
-
GetDangerMenu
获取隐患菜单权限
参数:
string Token: Token, 未加密
参数:
userId //用户登陆ID,admin固定为1
string
返回值:Result 描述 Result=0 执行成功,返回结构ReturnValue Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 查询无数据 Result=-10 当前登录帐号已经在其他机器上登录
返回结构ReturnValue- json 字符串数据
public string MeunName; //app菜单名称(DangerAppID 枚举值)
public string IsShow; //是否有显示权限 0 无,1有
public string IsOperation; //是否有操作权限 0 无,1有
DangerAppID枚举数据 DangerHiddenApp=1; //隐患录入 (DangerAppID 枚举值)
DangedisposeApp=2; //隐患处理 (DangerAppID 枚举值)
DangerAuditApp=3; //隐患审核 (DangerAppID 枚举值)
DangerBrowseApp=4; //隐患浏览 (DangerAppID 枚举值)
DangerRejectApp=5; //隐患驳回 (DangerAppID 枚举值)
DangerCountApp=6; //隐患统计 (DangerAppID 枚举值)
UserDown=7; //用户下载 (DangerAppID 枚举值)
FingerprintManage=8; //指纹管理 (DangerAppID 枚举值)
FingerprintDelete=9; //指纹删除 (DangerAppID 枚举值)
-
GetDangerRejectNum
根据用户获取未阅读的隐患驳回数量
参数:
string Token: Token, 未加密
参数:
string userId 用户ID返回值:Result 描述 Result=1 执行成功,Message为该用户未阅读的隐患驳回数量 Result=-1 程序错误,Message为错误信息 Result=-10 当前登录帐号已经在其他机器上登录
-
GetDangerStatList
根据登陆账号和隐患状态获取隐患信息userId为空则为全部
参数:
string Token: Token, 未加密
参数:
string userId登陆账号ID
string auditstat 隐患状态(1,2,3,4,5 对应 处理中,处理驳回,审核中,审核驳回,审核完成)参数:
string DangerDeptName 隐患部门 如消防,默认为空
参数:
string beginDate 开始时间 (格式:2019-05-01 8:00:00),默认为空
参数:
string DangerDeptName 结束时间 (格式:2019-05-01 18:00:00),默认为空
返回值:
返回结构ReturnValueResult 描述 Result=0 获取成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-31 Token 失效! Result=-3 查询无数据 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效! - json 字符串数据
public string DangerDeptName; //隐患部门,如消防(部门)
public string DangerLevelName; //隐患级别(固定1级,2级,3级)如1级
public string DangerReason; //隐患描述,(格式:描述1,描述2) 描述之间,隔开
public string FxUserName; //发现人(登陆人名称)
public string Address; //发现地点 如:巡更点1
public string Time; //发现时间 (格式:2019-05-01 8:00)
public string CurrUserId; //当前处理人ID (登陆ID)
public string DisposeResult; //处理结果 (格式:处理人:aaa,处理内容:xx原因被驳回,处理时间:2019-05-25|处理人:bbb,处理内容:处理成功xxx,处理时间:2019-05-26)多条处理间以|隔开,如处理结果1|处理结果2
public string ImgPathList; //隐患处理图片地址集合 。(格式:1.jpg,2.jpg)多张图片之间以,隔开
public string AuditorImgPathList; //隐患审核图片地址集合。(格式:1.jpg,2.jpg)多张图片之间以,隔开
public string Auditstat; //隐患状态(1,2,3,4,5 对应 处理中,处理驳回,审核中,审核驳回,审核完成)可多个如:1,2,3 默认空值
public string AuditorReult; //审核结果 (格式:aaa,xx原因被驳回,2019-05-25|bbb,审核成功xxx,2019-05-26)多条审核间以|隔开,如审核结果1|审核结果2
-
GetDangerrantset
获取隐患部门设置信息
参数:
string Token: Token, 未加密
返回值:
返回结构ReturnValueResult 描述 Result=0 获取成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-31 Token 失效! Result=-3 查询无数据 Result=-10 当前登录帐号已经在其他机器上登录 - json 字符串数据
public string DangerDeptName; //隐患部门
public string DangerLevelName; //(固定1级,2级,3级)如1级
public string UserIDList; //处理人ID集合(格式:处理人A ID,处理人B ID)如1,3 人员之间,隔开
public string Time; //处理时长 (分钟为单位)如:270
public string Deserption; //隐患描述,(格式描述1,描述2) 描述之间,隔开
public string AuditUserIDList; //审核人ID集合,(格式:审核人A ID,审核人B ID)如1,3 人员之间,隔开
-
GetDeviceReadCardModel
保存设备读卡模式进数据库
参数:
string Token:Token 不为空;
string MeterID:设备完整机号(GetAPPDeviceList 接口 返回的 MeterID 属性),加密
string DeviceReadCardModel:用户选择的读卡模式(可以多选 1,2,3,4,5 中间以英文逗号分割),不为空 加密
返回结构:
public class DeviceMode
{
public string MeterType; // 机器型号 00010801、00010802
public string DeviceRealID; // 机器完整的机号(机器型号 + 机器ID) 举例 0001080113800138000、00010803202503250456
public string MeterID; // 登录用户名称【如果使用人脸登录,则使用这个属性做为参数】
public string DeviceAllowReadCardModel; // 当前设备【能够允许】的读卡模式【1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码; 返回的值为1,2,3】
public string DeviceReadCardModel; // 当前设备【已经设置成功】的读卡模式【返回的值为1,2,3 ,可以为多种打卡模式】
public int RouteID; // 当前设备绑定的线路
public int RouteName; // 当前设备绑定的线路
}
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token非法 Result=-3 Token失效 Result=-10 当前帐号已经在其他设备登录
- GetDog
-
GetLevelCountDanger
隐患统计(按等级)
参数:
string Token: Token, 未加密
参数:
dangerDeptName //隐患部门,如消防(部门),为空则为全部部门,默认空值
string
string auditstat 隐患状态(2,4,5 对应 处理中,审核中,,审核完成)为空则为所有状态,默认空值 参数:
beginDate 开始时间 (格式:2019-08-09 8:00)
string 参数:
endDate 开始时间 (格式:2019-08-09 10:00)
string 参数:
numUrl 数量的链接地址,默认空值
string
返回值:Result 描述 Result=0 执行成功,返回结构ReturnValue Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 查询无数据 Result=-10 当前登录帐号已经在其他机器上登录
返回结构ReturnValue- json 字符串数据
public string DangerLevelOneNum; //1级数量
public string DangerLevelTwoNum; //2级数量
public string DangerLevelTheerNum; //3级数量
-
GetMessageByUser
获取对应人员应该接收的消息列表
参数:
string Token: Token 数据 加密
string LoginName: 当前登录用户的登录名称,加密
返回结构:
ReturnValue<List<MessageModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //消息的数量
public string Message;
public T Values;
}
public class MessageModel
{
public int ID; // 消息发送目标的主键
public int TypeID; // 消息发送目标的状态【0、未发送;1、(机器端)已接收;2、已阅读;】
public string Title; // 消息标题
public string Content; // 消息内容
public DateTime CreateTime; // 消息创建时间
public string TypeName; // 消息分类名称
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
GetRouteSpots
获取指定线路下的地点卡【下载地址卡、切换线路的时候使用到】
参数:
string Token: Token数据
string RouteID: 线路ID, 加密
string Keyword: 地址卡卡号、地址卡名称,支持模糊查询,可以为空,加密
string PageIndex: 页码,页码从0开始, 加密
返回结构:
ReturnValue<List<SpotInfo>> json字符串数据
public class ReturnValue<T>
{
public long Result;//错误代码
public int MaxCount;//地点卡总数
public int PageSize;//每页显示记录数
public string Message;
public T Values;
}
public class SpotInfo
{
public int RouteClassID;//1、普通线路;2、工单线路(四级项目);3、临时任务模板线路;4、临时任务线路;
public string SpotID;//地点卡ID【数据库自增字段】
public string SpotName;//地点名称
public string CardNo;//地点卡号
public int Orders; //排序号
public string Comments;//备注
public double Longitude;//经度
public double Latitude; //纬度
public int GPSQualiRange; //手持机采集到的坐标点,与“地址卡坐标点(SpotInfo.Longitude, SpotInfo.Latitude)”之间的合格距离(单位:米)。【两点之间的距离,小于或者等于GPSQualiRange,表示打卡成功】
public bool PhotoFromAlbum;// 地址卡刷卡,照片,能否从相册中,选取照片【true、允许从相册选取;fasle、禁止;】
public int PictureCount;// 当前地址卡,允许拍摄的 照片数量 的最大值【当 PictureCount = 0 时,不允许拍照 】
public bool VideoFromAlbum;// 地址卡刷卡,视频,能否从相册中,选取视频【true、允许从相册选取;fasle、禁止;】
public int VideoCount;// 当前地址卡,允许拍摄的 视频数量 的最大值【当 VideoCount = 0 时,不允许拍视频 】
public int VideoTime;// 当前地址卡,允许拍摄的 视频时间长度 的最大值【单位:秒】
public int VideoSize;// 当前地址卡,如果允许从相册选取视屏 视频文件大小 的最大值【单位:M (兆)】
public int TimeInterval;// 打卡(读取地址卡)时间,与数据提交(点击数据提交按钮)到服务器时间,之间的时间间隔【少于这时间,不能点击数据提交按钮】【单位:分钟】
public bool NeedCheck; //是否指纹检测
public string ModelTypeID; //Z-5000X 地址卡信息显示模式【A、简易模式(默认);B、事件模式;C、表单模式;D、流水模式;】
public string FormName; //Z-5000X 表单名称【举例:保洁记录表】
public string PromptText; //Z-5000X 提示信息【举例:xx物业】
public string Address; //详细地址,暂时未用
}
返回值:Result 描述 Result=0 获取数据成功 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效
提示:
如果地点卡数据超过一页(>200 spots), 请循环这个方法进行获取
-
GetRouteSpotsDetail
线路下地点卡数据明细【结合静态数据,Z-9000巡检,详情页面】
参数:
string Token: 非空,Token数据
string RouteID: 线路ID, 非空,加密
string SpotID: 地址卡ID, 非空,加密【GetRouteSpotsStaticdata 接口返回的 SpotID 字段】
string CardNo: 地址卡卡号, 非空,加密【GetRouteSpotsStaticdata 接口返回的 CardNo 字段】
string QueryDate:“今天(当前日期,格式为:yyyy-MM-dd,举例 2020-05-31)”,非空,加密
string BeginTime:“时间段开始时间(格式为:HH:mm:ss,24小时制,举例 00:12:00)”,非空,加密
返回结构:
ReturnValue<List<SpotInfo>> json字符串数据
public class ReturnValue<T>
{
public long Result;//错误代码
public int MaxCount;//地点卡总数
public int PlanTypeID;//计划巡检类型(0、按指定人员;1、按班组;2、不指定人员;)
public string PlanPatrolMan;//计划巡检人员(或者班组名称)【当PlanTypeID = 2时,特殊处理,赋值“任意”或者“Anynoe”】
public int TypeID;//数据类型ID (0、合格;1、误点;2、漏检;3、待检(默认);4、异常(只有事件型、项目型才有异常);5、(误点+异常))
public string CardNo;//地址卡编号
public string CardName;//地址卡名称
public string PatrolCode;//实际巡检人员编号
public string PatrolName;//实际巡检人员名称
public string PatrolTime;//巡更时间点
public string Message;
public T Values;
}
public class Item
{
public int ItemType;//项目类型(0、数字型;1、逻辑型;2、备注;其实2是不存在的,但是Z-9000比较特殊,在录入信息后,可以填写一个“备注信息”,特殊说明)
public string ItemName;//检测项目名称
public string UnitName;//用户填写的值(默认为 -- )
}
返回值:Result 描述 Result=0 获取数据成功 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-30 参数 UnisionID 为空 Result=-31 Token失效
提示:
如果地点卡数据超过一页(>50 spots), 请循环这个方法进行获取
-
GetRouteSpotsStaticdata
线路下地点卡【结合静态数据】
参数:
string Token: 非空,Token数据
string RouteID: 线路ID, 非空,加密
string QueryDate:“今天(当前日期,格式为:yyyy-MM-dd,举例 2020-05-31)”,非空,加密
string BeginTime:“时间段开始时间(格式为:HH:mm:ss,24小时制,举例 00:12:00)”,非空,加密
string PageIndex: 页码,页码从0开始, 非空,加密
string Keyword: 地址卡名称,支持模糊查询,可以为空,加密
返回结构:
ReturnValue<List<SpotInfo>> json字符串数据
public class ReturnValue<T>
{
public long Result;//错误代码
public int MaxCount;//地点卡总数
public int PageSize;//每页显示记录数
public string Message;
public T Values;
}
public class SpotInfo
{
public string SpotID;//地点卡ID【数据库自增字段】
public string SpotName;//地点名称
public string CardNo;//地点卡号
public int Orders; //排序号
public int RouteClassID;// 线路类型(Route表ClassID字段) 【1、普通线路;2、工单线路(四级项目);3、临时工单模板线路;4、临时工单线路;】在新APP中 当 RouteClassID = 4 同时 地址卡号 CardNo 以 8F 开头,表示“虚拟卡号”,用户不需要“刷卡”可以直接进入数据填报页面
public string Comments;//备注
public double Longitude;//经度 当 Longitude == 0.0 同时 Latitude == 0.0 时,表示这个地址卡没有输入GPS坐标
public double Latitude; //纬度 当 Longitude == 0.0 同时 Latitude == 0.0 时,表示这个地址卡没有输入GPS坐标
public int GPSQualiRange; //手持机采集到的坐标点,与“地址卡坐标点(SpotInfo.Longitude, SpotInfo.Latitude)”之间的合格距离(单位:米)。【两点之间的距离,小于或者等于GPSQualiRange,表示打卡成功】
public bool NeedCheck; //是否指纹检测
public int PlanTypeID; //计划巡检类型(0、按指定人员;1、按班组;2、不指定人员;)
public string PatrolTime; //巡检时间
public string PlanPatrolMan; //计划巡检人员(或者班组名称)
public int TypeID; //数据类型ID (0、合格;1、误点;2、漏检;3、待检(默认);4、异常(只有事件型、项目型才有异常);5、(误点+异常));
public string UnisionID; //原始数据唯一值(TypeID 的值为 2、3 的时候,此值为空)
public string Address; //详细地址,暂时未用
}
返回值:Result 描述 Result=0 获取数据成功 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效
提示:
如果地点卡数据超过一页(>50 spots), 请循环这个方法进行获取
-
GetRouteStaticdata
2025 新版APP首页所有数据返回接口:(任务执行情况,结合静态数据)
参数:
string Token: 非空,Token数据
string ListRouteID: 线路ID,多条线路之间,用英文逗号,隔开; 可以为空,加密
string ListAddressCode: 地址卡集合,多个地址卡之间,用英文逗号,隔开; 可以为空,加密
string ListUserCode: 人员卡集合,多个地址卡之间,用英文逗号,隔开; 可以为空,加密
string ListTypeID: 查询状态,多个状态之间,用英文逗号,隔开; 加密 【目前占位,直接传入空值】
string BeginTime:“查询开始时间(格式为:yyyy-MM-dd HH:mm:ss 或者 yyyy-MM-dd,举例 2020-05-31 00:00:00)”,非空,加密 【在新APP首页,直接传入 yyyy-MM-dd】
string EndTime:“查询结束时间(格式为:yyyy-MM-dd HH:mm:ss 或者 yyyy-MM-dd,举例 2020-05-31 23:59:59)”,非空,加密 【在新APP首页,直接传入 yyyy-MM-dd】
返回结构:
ReturnValue<List<SpotInfo>> json字符串数据
public class ReturnValue
{
public long Result;//错误代码
public int MaxCount;//汇总性数据 数量
public string ListPatrolSata;//汇总性数据 明细
public int MaxCount1;//【1、巡检单】 数量
public string ListQueryDetailed1;//【1、巡检单】 明细
public int MaxCount4;//【4、任务工单】 数量
public string ListQueryDetailed4;//【4、任务工单】 明细
public int MaxCount2;//【2、任务进行中】 数量
public string ListQueryDetailed2;//【2、任务进行中】 明细
public int MaxCount3;//【3、已完成;】 数量
public string ListQueryDetailed3;//【3、已完成;】 明细
public int PageSize;//每页显示记录数
public string Message;
public T Values;
}
public class Values
{
public string AutoString;//强行增加的唯一值 RoutID_BeginTime.ToString("yyyyMMddHHmmss") 【如果没有时间段,这默认为 0】
public int TypeID;//线路类型【1、普通线路(棒子、事件、三级项目,首页蓝色显示);2、普通线路(带任务的四级项目,首页蓝色显示);3、模板线路(不可能出现在首页,首页蓝色显示);4、临时任务(工单)(首页橙色显示);】
public int ClassID;//数据类型【1、正常任务(棒子【啥都没有】);2、工单任务(带任务的巡检项目【四级项目】);3、正常任务(事件);4、正常任务(三级项目【和Z-9000、Z-M900 Pro相同】);】
public int RouteID;//线路 ID
public string RouteName;//线路名称
public string StartTime;// 计划时间段开始时间
public string EndTime; //计划时间段结束时间
public int PatrolResult; //执行结果 (1、待巡(未开始);2、任务进行中;3、已完成;)
}
public class ListPatrolSata
{
public int ID; //自增字段
public int RouteID; //线路 ID
public string RouteName; //线路名称
public int CardNoNum; //线路的巡更点个数
public bool HaveTask; //如果线路没有任务,则同样需要显示在新版APP的首页上(true、当天指定线路“有”任务;false、当天指定线路“没有”任务;)
public string SataDate; //统计时间(格式 yyyy-MM-dd)
public int ShouldCheckNum; //应捡数量
public int MissNum; //漏检数量
public int NoCheckNum; //待巡数量
public int CheckNum; //已检数量
public double CheckProportion; //已检比例
}
返回值:Result 描述 Result=0 获取数据成功 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效
提示:
如果地点卡数据超过一页(>50 spots), 请循环这个方法进行获取
-
GetRoutes
获取当前用户可使用的线路
参数:
string Token: Token数据
string PageIndex: 页码,每页十条数据,页码从0开始,加密
返回结构:
ReturnValue<List<RouteInfo>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;//线路总数
public string Message;
public T Values;
}
public class Route
{
public string RouteID;
public string ParentID;
public string RouteName;
public string CardNoNum; // 线路下对应的地址卡(巡更点)的数量
public string Comments;
}
返回值:结果 描述 Result=0 线路获取成功
MaxValue: 线路总数
Values: List<RouteInfo>> 线路信息Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
提示:
如果线路数量大于一页(>10),需要循环此方法进行获取!【【【临时取消分页】】】
- GetSchedule
-
GetSpotItems
获取地点卡的项目信息
【701 Z-9000、702 Z-9000T、旧版 801 Z-M900、旧版 802-M900 Pro 使用】
参数:
string RouteID: 线路ID,加密
string SpotID: 地点卡ID,加密
返回结构:
ReturnValue<List<Item>> json字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount
public string Message;
public T Values;
}
public class Item
{
public int ItemID; //项目ID
public int RouteItemID; //线路项目ID
public string ItemName; //项目名称
public int ItemType; //项目类型:0=数字型, 1=逻辑型
public int UnitID; //单位ID
public int RouteUnitID; //线路下单位ID
public double MaxValue; //数字型项目最大值
public double MinValue; //数字型项目最小值
public double DefaultValue; //数字型项目默认值 或 逻辑型默认项目(线路下项目ID)
public string UnitName; //数字型项目单位名称
public List<Logic> lstLogic; //逻辑型项目的逻辑项
}
public class Logic
{
public int LogicID; //逻辑型ID
public int RouteLogicID; //线路下逻辑项ID
public string LogicName; //逻辑项名称
}
返回值:Result 描述 Result=0 项目数据获取成功
Values: List<Item>>Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 -
GetSpotMachine
地点下面的任务(机器)信息【三级菜单】
参数:
string Token: 非空,Token数据
string RouteID: 线路ID,加密
string SpotID: 地点卡ID,加密
返回结构:
ReturnValue<List<Item>> json字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount
public string Message;
public T Values;
}
public class SpotMachineModel
{
public int RouteMachineID; //线路任务、机器ID
public int RouteID; //线路ID
public int SpotID; //地址卡ID
public int Orders; //排序号
public int MachineID; //任务、设备ID
public string MachineName; //任务、设备 名称
}
public class Logic
{
public int LogicID; //逻辑型ID
public int RouteLogicID; //线路下逻辑项ID
public string LogicName; //逻辑项名称
}
返回值:Result 描述 Result=0 项目数据获取成功
Values: List<Item>>Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 -
GetSpotMachineItems
获取地点卡的项目信息
【新版 801 (棒子)、新版 803 (工单)、新版 804(事件)】同时集成【701 Z-9000、702 Z-9000T、旧版 801 Z-M900、旧版 802-M900 Pro 使用】
参数:
string Token: 非空,Token数据
string RouteID: 线路ID,加密
string SpotID: 地点卡ID,加密
string RouteMachineID: 线路任务(设备)ID,GetSpotMachine 接口返回的 RouteMachineID,加密
返回结构:
ReturnValue<List<Item>> json字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount
public string Message;
public T Values;
}
// 地址卡绑定的设备(任务)
public class AddressMachineModel
{
public int RouteMachineID; 线路设备(任务)ID
public int MachineID; 设备(任务)ID
public string MachineName; 设备(任务) 名称
public List<Item> lstLogic; 设备(任务)绑定的巡检项目集合
}
// 地址卡(三级菜单机型,设备(任务))下面绑定的巡检项目信息
public class Item
{
public int RouteMachineID; 【三级菜单,地址卡绑定的设备(任务)】 线路设备(任务) ID
public int MachineID; 【三级菜单,地址卡绑定的设备(任务)】设备(任务) ID
public int ClassID; 三级菜单,巡检项目分组【A泵、B泵】
public string ClassName; 三级菜单,巡检项目分组【A泵、B泵】
public int RouteItemID; 线路巡检项目 ID
public int ItemID; 项目 ID
public string ItemName; 项目名称
public int ItemType; 项目类型:0、数字型;1、逻辑型;2、备注;其实2是不存在的,但是Z-9000比较特殊,在录入信息后,可以填写一个“备注信息”,特殊说明
public int RouteUnitID; 线路下单位ID
public int UnitID; 单位ID
public string UnitName; 数字型项目单位名称
public double MaxValue; 数字型项目最大值
public double MinValue; 数字型项目最小值
public double DefaultValue; 数字型项目默认值 或 逻辑型默认项目(线路下项目 RouteItemID)
public double LastValue; 用户上一次填写后提交的值 【说明:1、数值型巡检项目,用户填写的数值,不返回计量单位;2、逻辑型巡检项目,返回的选中项,即 RouteLogicID 即本接口 List中的 Logic.RouteLogicID】
public List<Logic> lstLogic; 逻辑型项目的逻辑项
}
// 逻辑型巡检项目绑定的逻辑选项集合
public class Logic
{
public int RouteLogicID; //线路下逻辑项ID
public int LogicID; //逻辑型ID
public string LogicName; //逻辑项名称
}
返回值:Result 描述 Result=0 项目数据获取成功
Values: List<Item>>Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 -
GetUser
获取所有人员【拥有指纹或者人脸照片的人员】列表
参数:
string Token: Token 数据 加密
string DeviceNo: 设备编码【其实不需要此参数】,加密
返回结构:
ReturnValue<List<UserModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //人员总数
public string Message;
public T Values;
}
public class UserFingerModel
{
public string UserID; // 用户 ID
public string UserName; // 用户名称
public string CardID; // 卡号
public string PicturePath; // 当前人员,人脸照片地址
public string FingerNums; // 指纹(人脸照片)数量
public string FingerType; // 指纹类别:【1:管理员指纹;2:操作员指纹】
public string DeviceCount; // 此用户是否已经绑定在指定的机器上 【0:未绑定;> 0:已经绑定在指定的机器上】
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
提示:
如果人员数量大于一页(每页十条数据)(>10),需要循环此方法进行获取!
-
GetUserFinger
下载指定人员的指纹
参数:
string Token: Token 数据
string DeviceNo: 设备编码 加密
string ListUserID: 多个 UserID ,单个加密后,使用英文逗号隔开
返回结构:
ReturnValue<List<UserFingerModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //指纹总数
public string Message;
public T Values;
}
public class UserFingerModel
{
public string UserID; // 用户 ID
public string CardID; // 用户 卡号
public string UserName; // 用户名称
public string DeviceID; // 设备编码
public string FingerIndex; // 当前指纹序号
public string LastFingerIndex; // 当前人员最后绑定的一个指纹的指纹序号
public string UserFingerID; // 指纹总表中,自增字段,唯一标识
public string FingerType; // 指纹类别:【1:管理员指纹;2:操作员指纹】
public string FingerString; // 十六进制指纹字符串
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-4 传入的 ListUserID 非法 Result=-5 指纹总数不能超过 500 枚 Result=-6 管理员指纹不能超出 15 枚【0 - 14】 Result=-7 管理员指纹不能超出 485 枚【15 - 500】 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
GetUserPicture
新版APP查询当前设备能够允许登录的人员信息
参数:
string Token:目前使用两种方式查询:第一种、在登录前,查询当前设备的允许的登录人员,这个时候,Token 值,为空;;;第二种、登录成功后,查询,此时 Token 不为空;
string DeviceTypeNo:机器型号(APP中定义的全局变量),加密
string DeviceNo:设备号(手机号码或者新APP的激活码中的机号),加密
string OperatorID:占位,目前没有切实意义,传入空值,加密
string OperatorName:占位,目前没有切实意义,传入空值,加密
string CardID:占位,目前没有切实意义,传入空值,加密
返回结构:
public class UserModel
{
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardID; // 用户卡号
public string UserName; // 登录用户名称【如果使用人脸登录,则使用这个属性做为参数】
public string PicturePath; // 人脸地址,如果为空的时候,表示没有此人的人脸照片信息
}
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 此手机号码未注册 Result=-3 Token失效
-
GetValidCardTime
获取同一个点有效时间
参数:
string Token:Token
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 获取成功,Message为有效时间(分钟),默认5分钟 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
HandAlarminfo
处理警报数据
参数:
string Token:Token,
string ListAlarmID: 警报 ID(【紧急警报:接口 QueryAlarminfo 返回的 ID 】【项目异常、漏检提醒:接口 QueryHomePageDetailed 返回的 ID 】;多条数据,多个 ID 之间,用英文逗号 , 分割;)拼接成字符串,加密
string HandString: 处理意见,
string TypeID:上面三个分类【1、紧急警报;2、异常数据;4、漏检数据;】【参数传入反过来了】,加密
string Remark: 占位,加密
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 Token非法 Result=-3 Token失效 Result=-4 获取登录用户数据失败
-
HandlerRequestFiles
新APP上传“测温测振”“图片或视屏”文件【压缩后的zip或者rar文件】,接收后,处理
上传 测温测振 数据的 zip 文件名称:S_59933176900600EA5AN5F63FD70E7CEB1A8FB76689FC41.zip 前缀 S_ 表示测温测振数据
上传 照片视屏 数据的 zip 文件名称:P_59933176900600EA5AN5F63FD70E7CEB1A8FB76689FC41.zip 前缀 P_ 表示视屏图片
参数:
数据方式使用 form-data
string Token: Token 数据
string RouteID: 线路ID,加密
string DeviceNo: 设备编码(13800138000),加密
string ReadCradTime: 刷卡时间(非照片拍摄时间、非txt生成时间,与 1970-01-01 00:00:00 之间的毫秒数),加密
string Timezone: 时区(东八区的时区为 480),加密
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 接收到的文件为空 Result=-4 接收到的文件已经存在【这种可能性很小,主要是防止重复上传】 Result=-5 文件名称,命名错误 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
HomePage
首页接口
参数:
string Token:Token
string LoginName:当前登录用户的用户名称加密
string TodayDate:“今天”时间,格式:yyyy-MM-dd,加密
返回结构:
public class HomePage
{
public int Result; // 返回结果,错误代码
public ListPictureCHS; // 首页轮换图片:中文
public ListPictureEN; // 首页轮换图片:英文
public int RouteCount; // 线路数量
public int CardNoNum; // 巡更点数量
public int ShouldCheckNum; // 应捡数量
public int QualifiedNum; // 合格数量
public int LateNum; // 误点数量
public int MissNum; // 漏检数量
public int ReplaceNum; // 代检数量
public int NoCheckNum; // 待巡数量
public int ExceptionNum; // 异常数量
public int AlarmCount; // (首页底部)警报数量
public int AbnormalCount; // (首页底部)异常数量(项目异常)
public int MissCount; // (首页底部)漏检提醒
public int CrashCount; // (首页底部)跌摔记录
public int MaxAlarmID; // 点击首页底部“异常提醒 -- 紧急警报”时,需要使用
public int MaxOriginID; // 点击首页底部“异常提醒 -- 项目异常”时,需要使用
public int MaxMissID; // 点击首页底部“异常提醒 -- 紧急警报”时,需要使用
public int MaxCrashID; // 点击首页底部“异常提醒 -- 跌摔记录”时,需要使用
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token错误 Result=-3 Token失效 Result=-4 查询登录用户类型失败
-
InsertGPSData
写入 GPS 数据
参数:
string Token: Token 数据 加密
string DeviceNo: 设备编码,加密
返回结构:
ReturnValue<List<UserModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //人员总数
public string Message;
public T Values;
}
public class UserFingerModel
{
public string UserID; // 用户 ID
public string UserName; // 用户名称
public string CardID; // 卡号
public string FingerNums; // 指纹数量
public string FingerType; // 指纹类别:【1:管理员指纹;2:操作员指纹】
public string DeviceCount; // 此用户是否已经绑定在指定的机器上 【0:未绑定;> 0:已经绑定在指定的机器上】
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
提示:
如果人员数量大于一页(每页十条数据)(>10),需要循环此方法进行获取!
-
InsertOpinion
用户提交意见
参数:
string Token:Token
string content:意见内容【不能超过 1000 字符,500 汉字】
string imgPath:图片名称列表,多张图片中用,隔开,如:1.jpg,2.gpg
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 提交成功 Result=-1 失败,但是即使没有提交成功,同样要感谢别人
-
IsExistsDealer
判断该经销商是否存在
参数:
string DealerID:经销商ID(加密前,为正整数),加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 经销商存在,可注册企业用户 Result=-15 经销商编码不存在
-
IsNoCompanName
判断公司名称是否已经注册
参数:
string CompanyName:公司名称,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 公司名称可注册 Result=-10 公司名称已经注册(公司名称重复)
-
IsNoCoperators
判断用户名称是否已注册
参数:
string CompanyCode:公司编码(长度为6位),加密
string userMName:用户名称,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}Result 描述 Result=0 用名称可以注册 Result=-20 公司已经被删除,或者公司不存在 Result=-21 用户名称已经注册(用户名称重复) Result=-31 公司还没有启用,不能注册操作用户
-
IsNoMobileNo
判断手机号码是否已经注册
参数:
string CompanyName:手机号码(保证用户输入的中国的手机号码前面不包含+86),加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 手机号码可注册 Result=-10 手机号码已经注册(手机号码重复) Result=-11 手机号码格式不正确
-
IsValidCardTime
判断打卡的记录是否是有效时间内无效打卡
参数:
string Token:Token
string CardName:卡号 加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 有效的打卡 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 Result=-100 有效时间内已有打卡记录,无效打卡
- KeepAlive
-
LawLogin
执法记录仪(专用) -- 用户登录
参数:
string CompanyName:公司名称或者公司code,加密
string UserName:用户名称,加密
string Password:密码【当密码为空的时候,传入的用户名称为用户卡号(刷卡登录)】,加密
string DeviceTypeNo:设备型号(传入一个固定值 00010901),加密
string DeviceNo:设备编号,加密
string DeviceName:设备名称,加密
string LoginTypeID:是否强制登录:0、否;1、是;加密
返回结构:
public class LoginResult
{
public int Result; // 返回结果,错误代码
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardNo; // 当前登录用户卡号
public string UserName; // 当前登录用户名称
public string CompanyName; // 公司名称
public string DeviceName; // 后台服务器中设备名称
public int UserType; // 用户分类【0、管理员;1、普通用户;】
public Route RouteInfo; // 返回线路信息(包含地址卡、检测项目、逻辑选项)
public string Message; // 错误信息
}
public class Route
{
public string RouteID;
public string ParentID;
public string RouteName;
public string CardNoNum; // 线路下对应的地址卡(巡更点)的数量
public ListSpotInfo; // 地址卡信息(项目型:检测项目、逻辑选项)(事件型:检测事件)
public string Comments;
}
public class SpotInfoEx
{
public string SpotID;//地点卡ID【数据库自增字段】
public string SpotName;//地点名称
public string CardNo;//地点卡号
public int Orders; //排序号
public string Comments;//备注
public double Longitude;//经度
public double Latitude; //纬度
public bool NeedCheck; //是否指纹检测
public List CheckItemInfo CheckItems; //地址卡的检测项目(项目型:检测项目、逻辑选项)
public List ExceptionInfo Exceptions; //地址卡的检测事件(事件型)
public string Address; //详细地址,暂时未用
}
public class ExceptionInfo
{
public int ExceptionID; //事件 ID
public string ExceptionName; // 事件名称
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 公司未启用 Result=-4 当前公司使用到期 Result=-5 经销商使用到期 Result=-6 不存在合法的加密狗或证书 Result=-7 设备使用超额 Result=-8 登录用户不存在 Result=-9 密码输入错误 Result=-30 更换了登录手机【当前帐号已经在其他机器上登录】 Result=-32 加入新的“设备名称为空”判断 Result=-33 设备名称已经存在,请更换设备名称 Result=-34 新增设备失败 Result=-35 当前设备已经存在于其他公司,请到其他公司删除后,在重新登录
-
LinkAndDetermineServer
在配置服务器的时候,需要检测用户输入的服务器地址是否正确,同时根据返回情况,判断服务器类型
无输入参数
返回值:Result 描述 Result=1 适合6.0的服务端(但是目前没有使用) Result=2 7.0(单用户,不需要输入公司名称) Result=3 7.0(多用户,需要用户输入公司名称)
-
LinkToServer
在配置服务器的时候,需要检测用户输入的服务器地址是否正确
无输入参数
返回值:Result 描述 Result=0 配置正确
-
Login
用户登录
参数:
string CompanyName:公司名称,加密
string UserName:用户名称,加密
string Password:密码,加密
string DeviceTypeNo:设备型号,加密
string DeviceNo:设备编号,加密
string DeviceName:设备名称,加密
string HardID:未知,加密
string LoginTypeID:是否强制登录:0、否;1、是;加密
返回结构:
public class LoginResult
{
public int Result; // 返回结果,错误代码
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardNo; // 当前登录用户卡号
public string UserName; // 当前登录用户名称
public string DeviceName; // 后台服务器中设备名称
public string ReadCardMode; // Z-9000 对应的读卡模式:1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码;【返回的数据可以为空,可以同时选择多种模式,返回数据示例:多种模式 1,2,3,4, 一种模式 1, 】
public int UserType; // 用户分类【0、管理员;1、普通用户;】
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 公司未启用 Result=-4 当前公司使用到期 Result=-5 经销商使用到期 Result=-6 不存在合法的加密狗或证书 Result=-7 设备使用超额 Result=-8 登录用户不存在 Result=-9 密码输入错误 Result=-30 更换了登录手机【当前帐号已经在其他机器上登录】 Result=-32 加入新的“设备名称为空”判断 Result=-33 设备名称已经存在,请更换设备名称 Result=-34 新增设备失败 Result=-35 当前设备已经存在于其他公司,请到其他公司删除后,在重新登录
-
LoginByWeiXinID
用户获取WeiXinID登录(巡探登录:登录方式为获取WeiXinID)
参数:
string MobileNo:WeiXinID,加密
返回结构:
public class LoginResult
{
public int Result; // 返回结果,错误代码
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardNo; // 当前登录用户卡号
public string UserName; // 当前登录用户名称
public string LoginPassword; // 当前用户所属的公司编码【借用】
public string DeviceName; // 所属公司名称【借用】
public int UserType; // 用户分类【0、企业管理员;1、普通管理员;2、操作员;】
public int DealerID; // 当前用户所属的经销商ID
public int ErWeiMaStr; // 当前公司对应的二维码字符串
public int QyErweiPath; // 企业二维码网络图片地址
public string Message; // 错误信息【成功的时候为Token】
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 此手机号码未注册 Result=-3 公司未启用 Result=-4 当前公司使用到期 Result=-5 经销商使用到期 Result=-6 不存在合法的加密狗或证书 Result=-7 设备使用超额 Result=-8 登录用户不存在 Result=-9 密码输入错误 Result=-11 查询公司信息出现错误 Result=-30 更换了登录手机【当前帐号已经在其他机器上登录】 Result=-32 加入新的“设备名称为空”判断 Result=-33 设备名称已经存在,请更换设备名称 Result=-34 新增设备失败 Result=-100 该登陆账号对应的经销商不存在 Result=-200 该登陆账号对应的经销商二维码没有生成 Result=-35 当前设备已经存在于其他公司,请到其他公司删除后,在重新登录 Result=-40 没有接受到数据 Result=-41 没有接受到具体公司信息(公司名称为空) Result=-42 用户名称为空 Result=-43 用户密码为空
-
LoginOperators
用户登录(巡探卫士登录)
参数:
string DeviceTypeNo:机器型号(APP中定义的全局变量),加密
string MobileNo:登录帐号【所有的登录帐号为手机号】,加密
string Password:密码,加密
string LoginTypeID:是否强制登录:0、否;1、是;加密
返回结构:
public class LoginResult
{
public int Result; // 返回结果,错误代码
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardNo; // 当前登录用户卡号
public string UserName; // 当前登录用户名称
public string CompanyName; // 所属公司名称
public string LoginPassword; // 当前用户所属的公司编码【借用】
public string DeviceTypeNo; // 设备型号【我们建议的定义的一个固定常量,为了方便调用,此次通过接口返回属性的方式返回】
public string DeviceID; // 设备ID【将登录的手机号,当作设备ID,为了方便调用,此次通过接口返回属性的方式返回】
public string DeviceName; // 设备名称
public int UserType; // 用户分类【0、企业管理员;1、普通管理员;2、操作员;】
public int DealerID; // 当前用户所属的经销商ID
public string ReadCardMode; // Z-9000 对应的读卡模式:1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码;【返回的数据可以为空,可以同时选择多种模式,返回数据示例:多种模式 1,2,3,4, 一种模式 1, 】
public string ReadCardTimeSpacing; // Z-M900 系列 对应的读卡时间间隔(单位:分钟)
public string ErWeiMaStr; // 当前公司对应的二维码字符串
public string QyErweiPath; // 企业二维码网络图片地址
public string Message; // 错误信息【成功的时候为Token】
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据
(此时对 RouteCount 进行判断,当 RouteCount = 1 的时候,弹出一个对话框“您的存储记录配额即将用完,如需扩容请联系供应商 !”,然后继续登录)Result=-1 程序错误,Message为错误信息 Result=-2 此手机号码未注册 Result=-3 公司未启用 Result=-4 当前公司使用到期 Result=-5 经销商使用到期 Result=-6 不存在合法的加密狗或证书 Result=-7 设备使用超额 Result=-8 登录用户不存在 Result=-9 密码输入错误 Result=-11 查询公司信息出现错误 Result=-12 登录用户“未启用”,不能登录。 Result=-30 更换了登录手机【当前帐号已经在其他机器上登录】 Result=-32 加入新的“设备名称为空”判断 Result=-33 设备名称已经存在,请更换设备名称 Result=-34 新增设备失败 Result=-35 当前设备已经存在于其他公司,请到其他公司删除后,在重新登录 Result=-36 您的存储记录已超过配额。请联系供应商 ! Result=-100 该登陆账号对应的经销商不存在 Result=-200 该登陆账号对应的经销商二维码没有生成
-
LoginOperatorsCode
用户登录(巡探卫士登录,新版程序,需要激活码)
参数:
string DeviceTypeNo:激活码解码后的 DeviceTypeNo,加密
string MobileNo:激活码解码后的 DeviceID,加密
string UserName:用户名称(或者手机号码或者邮件地址),加密
string Password:密码,加密
string ActivationCode:激活码,不用加密!不用加密!不用加密!(激活码字符串本身就是加密的字符串)
string LoginTypeID:是否强制登录:0、否;1、是;加密
string DeviceString:收集到手机信息,不用加密!不用加密!不用加密!(json 字符串,暂时传入空值)
string AndroidID:AndroidID 安卓手机的 ID,不用加密!不用加密!不用加密! 【举例说明:1739f58129258a1f】
string APPActiCode:激活APP时,用到的激活码,不用加密!不用加密!不用加密! 【举例说明:U2LX0-SH8MK-DNTER-AU6WB】
返回结构:
public class LoginResult
{
public int Result; // 返回结果,错误代码
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardNo; // 当前登录用户卡号
public string UserName; // 当前登录用户名称
public string CompanyName; // 所属公司名称
public string LoginPassword; // 当前用户所属的公司编码【借用】
public string DeviceTypeNo; // 设备型号【我们建议的定义的一个固定常量,为了方便调用,此次通过接口返回属性的方式返回】
public string DeviceID; // 设备ID【将登录的手机号,当作设备ID,为了方便调用,此次通过接口返回属性的方式返回】
public string DeviceName; // 设备名称
public int UserType; // 用户分类【0、企业管理员;1、普通管理员;2、操作员;】
public int DealerID; // 当前用户所属的经销商ID
public string ReadCardMode; // Z-9000 对应的读卡模式:1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码;【返回的数据可以为空,可以同时选择多种模式,返回数据示例:多种模式 1,2,3,4, 一种模式 1, 】
public string ReadCardTimeSpacing; // Z-M900 系列 对应的读卡时间间隔(单位:分钟)
public string ErWeiMaStr; // 当前公司对应的二维码字符串
public string QyErweiPath; // 企业二维码网络图片地址
public string jSonContent; // 当前登录用户的权限信息
public string ErrorMessage; // 登录过程中,服务器返回的错误信息
public string Message; // 错误信息【成功的时候为Token】
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据
(此时对 RouteCount 进行判断,当 RouteCount = 1 的时候,弹出一个对话框“您的存储记录配额即将用完,如需扩容请联系供应商 !”,然后继续登录)Result=-1 程序错误,Message为错误信息 Result=-2 此手机号码未注册 Result=-3 公司未启用 Result=-4 当前公司使用到期 Result=-5 经销商使用到期 Result=-6 不存在合法的加密狗或证书 Result=-7 设备使用超额 Result=-8 登录用户不存在 Result=-9 密码输入错误 Result=-11 查询公司信息出现错误 Result=-12 登录用户“未启用”,不能登录。 Result=-30 更换了登录手机【当前帐号已经在其他机器上登录】 Result=-32 加入新的“设备名称为空”判断 Result=-33 设备名称已经存在,请更换设备名称 Result=-34 新增设备失败 Result=-35 当前设备已经存在于其他公司,请到其他公司删除后,在重新登录 Result=-36 您的存储记录已超过配额。请联系供应商 ! Result=-37 当前用户不允许在此设备上登录 Result=-100 该登陆账号对应的经销商不存在 Result=-200 该登陆账号对应的经销商二维码没有生成
-
NeedSMSCheck
从服务器的配置文件中,获取是否需要短信验证(注册、修改密码)
返回结构:
public class SimpleResult
{
public string Result; // 代码
public string Message; // 信息
}
返回值:Result 描述 Result=0 返回信息:0 不需要短信验证 Result=1 返回信息:1 短信验证(默认是需要进行短信验证的)
-
OutLogin
退出登录
参数:
string Token:Token
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
ProcessingHiddenTrouble
处理隐患
参数:
string Token: Token, 未加密
参数:
string id 隐患基础信息ID
string currUserName 当前处理人(登陆人名称)
string auditstat 隐患状态(1,2,3,4,5 对应处理中,处理驳回,审核中,审核驳回,审核完成)
string ProcrssinguserName 处理人 如 admin
string ProcrssingJieg 处理内容 如:处理成功,xxx
string ProcrssingTime 处理时间(格式:2019-05-08 9:00)
string ImgPathList 多图片地址列表(格式:1.jpg,2.jpg)多张图片之间以,隔开
返回值:Result 描述 Result=1 执行成功,Message为成功信息 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-10 当前登录帐号已经在其他机器上登录
-
QueryAddressCard
查询某一张地址卡
参数:
string Token:Token,
string CardNo: 地址卡号加密
返回结构:
ReturnValue<List<UserModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; // 返回的错误代码
public int MaxCount;//总记录数,当 MaxCount = 0 时,表示查询结果中,没有数据
public string Message; // 返回的错误内容
public T Values;
}
public class SpotInfo
{
public class SpotInfo
{
public string SpotID;//地点卡ID【数据库自增字段】
public string SpotName;//地点名称
public string CardNo;//地点卡号
public string Comments;//备注
public double Longitude;//经度
public double Latitude; //纬度
public string Address; //详细地址,暂时未用
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效 Result=-32 Token失效
-
QueryAddressCardAppendRoute
查询某一条线路能够添加的地址卡
参数:
string Token:Token,
string RouteID: 线路 ID,加密
string Keyword: 地址卡名称或者卡号,支持模糊查询,可以为空,加密
string PageIndex: 页码从 0 开始,加密
返回结构:
ReturnValue<List<SpotInfo>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总记录数
public int PageSize;//如果分页,每页显示的记录数
public string Message;
public T Values;
}
public class SpotInfo
{
public string SpotID;//地点卡ID【数据库自增字段】
public string SpotName;//地点名称
public string CardNo;//地点卡号
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效
-
QueryAddressCardExist
查询一批地址卡是否已经在平台注册,同时查询绑定到哪些线路
参数:
string Token:Token,
string ListCardNo: 批量地址卡号【多张地址卡,以英文逗号间隔,组成字符串,然后加密】
返回结构:
ReturnValue<List<UserModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; // 返回的错误代码
public int MaxCount;//总记录数,当 MaxCount = 0 时,表示查询结果中,没有数据
public string Message; // 返回的错误内容
public T Values;
}
public class SpotInfo
{
public string SpotID;//地点卡ID【数据库自增字段】【当 SpotID > 0 时,表示已经在此平台注册;;当 SpotID = 0 时,表示此卡号没有注册;】
public string SpotName;//地点名称
public string CardNo;//地点卡号
public string Comments;//此地址卡是否绑定线路【字符串,当为空时:此地址卡没有绑定到线路;非空:绑定到线路(一条或者多条线路)(绑定一条:1, 绑定多条:4,56, 注意字符串以英文逗号结尾)】
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效 Result=-32 Token失效
-
QueryAddressCardList
查询所有地址卡
参数:
string Token:Token,
string Keyword: 地址卡名称或者卡号,支持模糊查询,可以为空,加密
string PageIndex: 页码从 0 开始,加密
返回结构:
ReturnValue<List<UserModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总记录数
public int PageSize;//如果分页,每页显示的记录数
public string Message;
public T Values;
}
public class SpotInfo
{
public string SpotID;//地点卡ID【数据库自增字段】
public string SpotName;//地点名称
public string CardNo;//地点卡号
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token失效
-
QueryAlarminfo
查询警报数据
参数:
string Token:Token,
string ListRouteID: 线路 ID(当 RouteID = 0 时,查询所有线路数据;当需要传入多个线路ID,线路ID之间用英文逗号,分开),加密
string BeginDate: 开始时间(格式 yyyy-MM-dd),加密
string EndDate: 结束时间(格式 yyyy-MM-dd),加密
string PageIndex: 页码,每页 10 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<AlarmModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//警报的总记录数
public string Message;
public T Values;
}
public class AlarmModel
{
public int ID; //自增字段
public int RouteID; //线路 ID
public string RouteName; //线路名称
public string CurrentAddressCardNo; //地址卡卡号
public string CardName; //地址卡名称
public string CurrentManCardNo; //报警人卡号
public string UserName; //报警人名称
public int HandState; //是否处理(0、未处理;1、已处理;)
public string CurrentDateTime; //警报时间
public string HandingResult; // 处理结果
public string HandUserName; // 处理人员
public string HandTime; // 处理时间
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryAttendance
查询出勤数据【注意:此接口不分页,一次返回所有数据】
参数:
string Token:Token,
string ListUserCode:用户卡号【特别说明:此值为 QueryUsers 接口返回的 CardID 字段】(当有多个卡号时,使用英文逗号,隔开)【为了减少数据量,不能为空】
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据【不想定义更多类,直接借用QueryDetailedModel】
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public string UserNo; //人员卡号
public string UserName; //人员名称
public string CardNo; //合格次数
public string CardName; //总天数
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryCrashRecordList
查询设备跌摔记录
参数:
string Token:Token,
string ListRouteID: 线路 ID(当 RouteID = 0 时,查询所有数据;当有多个线路的时候,线路ID之间使用英文逗号,分开),加密
string BeginDate: 开始时间(格式 yyyy-MM-dd),加密
string EndDate: 结束时间(格式 yyyy-MM-dd),加密
string PageIndex: 页码,每页 10 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<CrashRecordModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//跌摔总记录数
public string Message;
public T Values;
}
public class CrashRecordModel
{
public string MeterType; //设备类型
public string DeviceRealID; //设备实际 ID
public string DeviceID; //设备编码(MeterType + DeviceRealID)
public int RouteID; //线路 ID
public string RouteName; //线路名称
public string CrashTime; //跌摔时间
public string UserCardID; //人员卡号(没有实际意义)
public string UserCardName; //人员名称(没有实际意义)
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryDevice
查询设备
参数:
string Token:Token,
string ListRouteID: 线路 ID 集合(当 RouteID = 0 时,查询所有数据;当有多个线路的时候,线路ID之间使用英文逗号,分开),加密
string Keyword: 设备名称或者设备编码,支持模糊查询,可以为空,加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<CrashRecordModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//跌摔总记录数
public string Message;
public T Values;
}
public class CrashRecordModel
{
public string MeterType; //设备类型
public string DeviceRealID; //设备实际 ID
public string DeviceID; //设备编码(MeterType + DeviceRealID)
public string DeviceName; //设备名称
public int RouteID; //线路 ID
public string RouteName; //线路名称
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryDeviceCoordinate
查询设备坐标
参数:
string Token:Token,
string ListDeviceID:查询多个设备时,使用英文逗号 , 将设备ID隔开【特别说明,设备ID,是 QueryDevice 接口返回数据的 DeviceID 字段】
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class DeviceCoordinate
{
public string DeviceID; //设备编号【后来输出显示设备名称】
public int isTude; //此设备是否是否有经纬度:0、没有;1、有;【部分设备没有经纬度信息,或者此设备还没有将经纬度信息发送到数据库】
public string Longitude; //经度
public string Latitude; //纬度
public string Time; //记录时间
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 Token 失效 Result=-4 最少需要输入一个设备ID
-
QueryDeviceNameByDeviceNo
用户登录,获取设备名称
参数:
string Token:非加密
string DeviceType:设备型号,加密
string DeviceID:设备ID,加密
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 用户不存在 Result=-10 当前登录帐号已经在其他机器上登录
-
QueryDeviceTrajectory
查询设备一段时间的轨迹坐标
参数:
string Token:Token,
string DeviceID:设备ID,每次只能查询一台设备【特别说明,设备ID,是 QueryDevice 接口返回数据的 DeviceID 字段】,加密
string BeginTime:开始时间,(格式:yyyy-MM-dd HH:mm:ss),加密
string EndTime:结束时间,(格式:yyyy-MM-dd HH:mm:ss),加密
string PageIndex: 页码,每页 50 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class DeviceCoordinate
{
public string DeviceID; //设备编号
public int isTude; //此设备是否是否有经纬度:0、没有;1、有;【部分设备没有经纬度信息,或者此设备还没有将经纬度信息发送到数据库】
public string Longitude; //经度
public string Latitude; //纬度
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 Token 失效 Result=-4 此设备查询没有轨迹数据,或者查询出错
-
QueryHomePageDetailed
查询统计数据明细【静态数据查询:首页底部查询“异常”“漏检”】
参数:
string Token:Token,
string ListRouteID:线路 ID集合,【传入 0 的时候,查询所有线路数据,当传入多条线路时候,中间以英文,逗号分割】加密
string TypeID:查询数据类型(2、漏检数据;4、异常数据;),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public int ID; //自增字段
public int HandState; //是否处理(0、未处理;1、已处理;)
public string UnsionID; //记录的唯一值
public string RouteName; //线路名称
public string StartTime; //计划起始时间
public string EndTime; //计划结束时间
public string CardNo; //地址卡卡号
public string CardName; //地址卡名称
public string PatrolTime; //巡检时间
public string PatrolMan; //计划巡检人员或者班组名称
public string UserName; //实际巡检人员名称【漏检、待巡时,为空】
public int PatrolResult; //巡检结果(-1:不再计划中,0:合格,1:误点,2:漏检,3、待检;)
public int IsAgent; //是否代检(0:否;1:是;)
public string HandingResult; // 处理结果
public string HandUserName; // 处理人员
public string HandTime; // 处理时间
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryLoginUser
查询当前用户的权限信息
参数:
string Token: Token数据
返回结构:
public class Operater
{
public string OperaterID; // 数据库字段ID,唯一值
public string OperaterName; // 当前登录用户名称
public string OperaterCate; // 用户分类【0、管理员;1、普通用户;】
}
返回值:结果 描述 Result=0 线路获取成功
MaxValue:
Values: List<Operater>> 当前登录人员信息Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-31 Token 失效
-
QueryMeasureTools
查询测量工具
参数:
string Token: Token
返回结构:
ReturnValue<List<PatrolRecordPictures>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //总数
public string Message;
public T Values;
}
public class PatrolRecordPictures // 不想写其他的类,借用一下,直接返回
{
public string UnsionID; // 测量工具编码(蓝牙地址、MAC地址、……)
public string PictureName; // 测量工具名称
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token 非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
QueryOriginData
查询原始数据
参数:
string Token:Token,
string ListRouteID:线路 ID,(当 RouteID = 0 时,查询所有线路数据;当需要传入多个线路ID,线路ID之间用英文逗号,分开)加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public string UnsionID; //唯一值
public string RouteName; //线路名称
public string CardNo; //地址卡卡号
public string CardName; //地址卡名称
public string PatrolTime; //巡检时间
public string UserNo; //巡检人员卡号
public string UserName; //巡检人员名称
public string Comments; //备注信息
public int IsExceptionItem; //原始数据巡检记录中,是否有事件或者项目信息(0:否;1:是;)
public int IsPictures; //原始数据巡检记录中,是否有图片信息(0:否;1:是;)
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryOriginDetailed
查询原始数据明细
参数:
string Token:Token,
string UnsionID:原始数据中的唯一值【有两个接口返回 QueryOriginData 以及 QueryPatrolSataDetailed】
返回结构:
ReturnValue<List<PatrolRecordPictures>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public string RouteName; //线路名称【或者工单名称】
public string CardNo; //地址卡卡号
public string CardName; //地址卡名称
public string PatrolTime; //巡检时间
public string UserNo; //巡检人员卡号
public string UserName; //巡检人员名称
public string Comments; //备注信息
public List<string> ListExceptionItem; //事件或者项目的集合
public List<string> ListPictures; //图片集合
public List<string> ListVideo; //视频集合
public string StartTime; //【工单】计划开始时间
public string EndTime; //【工单】计划结束时间时间
public string PatrolMan; //【工单】计划班组/人员
public int PatrolResult; //【工单】结果(0、合格;1、误点;2、漏检;3、待巡;5、代检;8、节假日;(计划中的休息日、工作日;))【2、漏检,显示红色 X 号;3、待巡,显示灰色 - 号;剩余的值,显示绿色 √ 号;】
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 Token失效
-
QueryPartolConfigInterval
查询【1、推送时间区间;】
参数:
string Token:Token
返回值:Result 描述 Result=0 执行成功,Message 为设置值,格式为“BeginTime|EndTime”,然后对返回值进行分割才行 Result=-1 程序错误,Message为错误信息 Result=-4 获取操作用户失败
-
QueryPartolConfigTime
查询【2、动态更新时间;】
参数:
string Token:Token
返回值:Result 描述 Result=0 执行成功,Message 为设置值 Result=-1 程序错误,Message为错误信息 Result=-4 获取操作用户失败
-
QueryPatrolSata
查询统计数据
参数:
string Token:Token,
string ListRouteID:线路 ID(当 RouteID = 0 时,查询所有线路数据;当需要传入多个线路ID,线路ID之间用英文逗号,分开),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
返回结构:
ReturnValue<List<PatrolSataModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class PatrolSataModel
{
public int ID; //自增字段
public int RouteID; //线路 ID
public string RouteName; //线路名称
public int CardNoNum; //线路的巡更点个数
public string SataDate; //统计时间(格式 yyyy-MM-dd)
public int ShouldCheckNum; //应捡数量
public int QualifiedNum; //合格数量
public int LateNum; //误点数量
public int MissNum; //漏检数量
public int ReplaceNum; //代检数量
public int NoCheckNum; // 待巡数量
public int ExceptionNum; //异常数量
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryPatrolSataByDate
查询统计数据【按照“日期”对线路进行汇总:用在“报表界面”】
参数:
string Token:Token,
string ListRouteID:线路 ID(当 RouteID = 0 时,查询所有线路数据;当需要传入多个线路ID,线路ID之间用英文逗号,分开),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
返回结构:
ReturnValue<List<PatrolSataModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class PatrolSataModel
{
public string SataDate; //统计时间(格式 yyyy-MM-dd)
public int CardNoNum; //巡更点个数
public int ShouldCheckNum; //应捡数量
public int QualifiedNum; //合格数量
public int LateNum; //误点数量
public int MissNum; //漏检数量
public int ReplaceNum; //代检数量
public int NoCheckNum; //待巡数量
public int ExceptionNum; //异常数量
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryPatrolSataByRealTime
查询统计数据【为巡检APP Z-9000准备,查询实时数据】
参数:
string Token:Token,
string ListRouteID:线路 ID加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
返回结构:
ReturnValue<List<PatrolSataModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class PatrolSataModel
{
public int ID; //自增字段
public int RouteID; //线路 ID
public string RouteName; //线路名称
public int CardNoNum; //线路的巡更点个数
public string SataDate; //统计时间(格式 yyyy-MM-dd)
public int ShouldCheckNum; //应捡数量
public int QualifiedNum; //合格数量
public int LateNum; //误点数量
public int MissNum; //漏检数量
public int ReplaceNum; //代检数量
public int NoCheckNum; //待巡数量
public int ExceptionNum; //异常数量
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryPatrolSataByRoute
查询统计数据【按照“线路”对日期进行汇总:用在“报表界面”】
参数:
string Token:Token,
string ListRouteID:线路 ID(当 RouteID = 0 时,查询所有线路数据;当需要传入多个线路ID,线路ID之间用英文逗号,分开),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
返回结构:
ReturnValue<List<PatrolSataModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class PatrolSataModel
{
public int RouteID; //线路 ID
public string RouteName; //线路名称
public int CardNoNum; //线路的巡更点个数
public int ShouldCheckNum; //应捡数量
public int QualifiedNum; //合格数量
public int LateNum; //误点数量
public int MissNum; //漏检数量
public int ReplaceNum; //代检数量
public int NoCheckNum; //待巡数量
public int ExceptionNum; //异常数量
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryPatrolSataDetailed
查询统计数据明细
参数:
string Token:Token,
string RouteID:线路 ID,加密
string TypeID:查询数据类型(-1、所有数据;140、合格数据;2、漏检数据;3、待检数据;4、异常数据;),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public string UnsionID; //记录的唯一值
public string RouteName; //线路名称
public string StartTime; //计划起始时间
public string EndTime; //计划结束时间
public string CardNo; //地址卡卡号
public string CardName; //地址卡名称
public string PatrolTime; //巡检时间
public string PatrolMan; //计划巡检人员/班组名称
public string UserName; //实际巡检人员名称【漏检、待巡时,为空】
public int PatrolResult; //巡检结果(-1:不再计划中,0:合格,1:误点,2:漏检,3、待检;4、异常;8、休息;)
public int IsAgent; //是否代检(0:否;1:是;)
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryPlanReport
查询计划报表
参数:
string Token:Token,
string RouteID:线路 ID,加密
string Language:语言,加密【返回的数据中,有部分数据需要定义,非数据库数据;;需要软件接口能够返回软件的语言:zh_CN、简体中文;en、英文;……】
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class PlanReportModel<T>
{
public long Result; //
public int MaxCount;//本线路计划的个数
public string Message;
public T Values;
}
public class PlanReportModel
{
public int PlanCount; //计划明细数量
public string PlanName; //计划名称
public string StateTime; //计划开始执行日期时间
public ListPlanDetailed; //计划明细的详细信息
}
public class PlanDetailedModel
{
public string ModelName; //模式名称
public string PlanTime; //计划时间段
public string PatrolMan; //计划人员
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryPlanTimeSection
查询计划时间段
参数:
string Token: Token
string RouteID:当前线路ID,非空,加密
string QueryDate:“今天(当前日期,格式为:yyyy-MM-dd,举例 2020-05-31)”,非空,加密
返回结构:
ReturnValue<List<PatrolRecordPictures>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //总数
public string Message;
public T Values;
}
public class PatrolRecordPictures // 不想写其他的类,借用一下,直接返回
{
public string UnsionID; // 计划时间段,开始时间(格式:HH:mm:ss 举例 00:00:00)
public string PictureName; // 计划时间段,结束时间(格式:HH:mm:ss 举例 23:59:59)
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token 非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
QueryRouteForTree
查询树状结构的线路信息
参数:
string Token:Token,
string Keyword: 线路名称查询关键字,支持模糊查询,可以为空,加密
返回结构:
ReturnValue<List<SimpleResult>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //错误代码
public int Message;//返回的数据
返回值:Result 描述 Result=0 执行成功,Message数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-4 获取用户信息失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-11 查询的结果为空【没有满足要求的数据】 Result=-31 Token失效
-
QueryRoutes
获取当前用户可使用的线路
参数:
string Token: Token数据
string PageIndex: 页码,每页十条数据,页码从0开始(此处取消分页,一次返回所有数据),加密
返回结构:
ReturnValue<List<RouteInfo>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;//线路总数
public string Message;
public T Values;
}
public class Route
{
public string RouteID;
public string ParentID;
public string RouteName;
public string CardNoNum; // 线路下对应的地址卡(巡更点)的数量
public string Comments;
}
返回值:结果 描述 Result=0 线路获取成功
MaxValue: 线路总数
Values: List<RouteInfo>> 线路信息Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-31 Token 失效
提示:
如果线路数量大于一页(>10),需要循环此方法进行获取!
-
QueryUserCardByUserName
用户登录,获取用户卡号
参数:
string Token:非加密
string UserName:用户名称,加密
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 用户不存在 Result=-10 当前登录帐号已经在其他机器上登录
-
QueryUserRoutes
查询某一指定用户拥有的线路ID
参数:
string Token:Token
string UserID:用户唯一标识【QueryOperators 接口返回的UserID】,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息【当 Result = 0 的时候,返回的是用户拥有的线路集合,多个线路ID,使用英文逗号,隔开】
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
QueryUserTypeOperators
获取登录用户对应的下级登录用户及路线权限
参数:
string Token: Token 数据 加密
string Keyword: 人员名称或者手机号,支持模糊查询,可以为空,加密
string PageIndex: 页码从 0 开始,加密
返回结构:
ReturnValue<List<LoginResult>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount; //人员总数
public int PageSize; //每页显示的记录数
public string Message;
public T Values;
}
public class LoginResult
{
public string UserID; // 用户 ID
public string UserName; // 用户名称
public string DeviceName; // 手机号码
public string UserType; // 用户:【0、企业管理员;1、普通管理员;2、普通用户;】
public string RouteCount; // 用户拥有权限的“线路”数量【当 RouteCount = 0 的时候,说明此用户没有“启用”】
public string RouteIDList; // 用户拥有权限的“线路”ID集合,逗号隔开,如3,4
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
提示:
如果人员数量大于一页,需要循环此方法进行获取!
-
QueryUsers
查询人员
参数:
string Token:Token,
string Keyword: 人员名称或者卡号,支持模糊查询,可以为空,加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<UserModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总记录数
public string Message;
public T Values;
}
public class UserModel
{
public int UserID; // ID 自增字段
public string CardID; //人员卡号
public string UserName; //人员名称
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryWordOrderData
查询 工单 数据
参数:
string Token:Token,
string TypeID:查询数据类型(-1、所有数据;默认传输一个 -1,不能为空),加密
string RouteName:工单名称(支持模糊查询,默认为空),加密
string ListRouteID:线路ID集合(多条线路ID,以英文逗号,分割,占位使用,设置为空),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public string UnsionID; //记录的唯一值
public int RouteID; //工单ID
public string RouteName; //工单名称
public string StartTime; //计划起始时间
public string EndTime; //计划结束时间
public string CardNo; //地址卡卡号
public string CardName; //地址卡名称
public string PatrolTime; //巡检时间
public string PatrolMan; //计划巡检人员/班组名称
public string UserName; //实际巡检人员名称【漏检、待巡时,为空】
public int PatrolResult; //巡检结果(-1:不再计划中,0:合格,1:误点,2:漏检,3、待检;4、异常;8、休息;)
public int IsAgent; //是否代检(0:否;1:是;)
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryWordOrderOriginData
查询 工单 原始数据
参数:
string Token:Token,
string TypeID:查询数据类型(-1、所有数据;默认传输一个 -1,不能为空),加密
string RouteName:工单名称(支持模糊查询,默认为空),加密
string ListRouteID:线路ID集合(多条线路ID,以英文逗号,分割,占位使用,设置为空),加密
string BeginDate:开始日期(格式: yyyy-MM-dd,不能为空),加密
string EndDate:结束日期(格式: yyyy-MM-dd,不能为空。查询某一天的数据,开始日期与结束日期相同),加密
string PageIndex: 页码,每页 100 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<QueryDetailedModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//总数
public string Message;
public T Values;
}
public class QueryDetailedModel
{
public string UnsionID; //唯一值
public int RouteID; //工单 ID
public string RouteName; //工单名称
public string CardNo; //地址卡卡号
public string CardName; //地址卡名称
public string PatrolTime; //巡检时间
public string UserNo; //巡检人员卡号
public string UserName; //巡检人员名称
public string Comments; //备注信息
public int IsExceptionItem; //原始数据巡检记录中,是否有事件或者项目信息(0:否;1:是;)
public int IsPictures; //原始数据巡检记录中,是否有图片信息(0:否;1:是;)
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
QueryXCXAlarminfo
查询警报数据(小程序专用)
参数:
string Token:Token,
string ListRouteID: 线路 ID(当 RouteID = 0 时,查询所有线路数据;当需要传入多个线路ID,线路ID之间用英文逗号,分开),加密
string BeginDate: 开始时间(格式 yyyy-MM-dd),加密
string EndDate: 结束时间(格式 yyyy-MM-dd),加密
string PageIndex: 页码,每页 10 条数据,页码从 0 开始,加密
返回结构:
ReturnValue<List<AlarmModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result; //
public int MaxCount;//警报的总记录数
public string Message;
public T Values;
}
public class AlarmModel
{
public int ID; //自增字段
public int RouteID; //线路 ID
public string RouteName; //线路名称
public string CurrentAddressCardNo; //地址卡卡号
public string CardName; //地址卡名称
public string CurrentManCardNo; //报警人卡号
public string UserName; //报警人名称
public int HandState; //是否处理(0、未处理;1、已处理;)
public string CurrentDateTime; //警报时间
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在
-
ReadCardModeAccurateQR
“读卡模式”精确扫描二维码,上传到服务器解码
参数:
string Token:Token
string Key:解密密匙【Z-M900、Z-M900 Pro 为 登录接口 LoginOperators 返回的 ErWeiMaStr 属性】
string QRString:读取二维码上面的字符串
string ScanTime:扫描时间(加密前的格式为 yyyy-MM-dd HH:mm:ss)加密
string SubmitTime:数据提交时间(加密前的格式为 yyyy-MM-dd HH:mm:ss)加密
string PreCode:第一次调用,默认为 0 ,【当上次调用错误(返回的 Result != 0 且 Result > 0)时,将返回结果中的 CheckCode2 属性值赋值给 PreCode ,再一次调用】,加密
string DeviceSN:二维码设备的机号【二维码地址卡的卡号】,第一次调用,默认为 0 ,【当上次调用错误(返回的 Result != 0 且 Result > 0)时,将返回结果中的 DeviceSN 属性值赋值给 DeviceSN ,再一次调用】,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
错误代码分四种:
1、第一种:Result = -1 表示调用方法的过程中出现问题,可以再一次调用或者程序错误,直接联系管理员;
2、第二种:Result < 0 具体说只有 -2、-31 两个值,此时表示 Token 出现问题,只能退出APP,重新登录后,再一次操作;
3、第三种:Result = 4020 ,表示需要校时(更换了电池或者其他原因导致),APP在等待 CheckCode2 秒后 ,第二次扫码调用方法 ReadCardModeAccurateQR 【再一次调用接口时,将 CheckCode2 赋值给 PreCode,将 DeviceSN 赋值给 DeviceSN】;
4、第四种:Result > 0 同时 Result != 4020,此时表示在解码的过程中出现问题,直接提示错误就可以了,等待APP再次扫码调用接口;
public string Message; // 返回的信息【Result = -1 时,程序错误原因】
【 返回值 Result > 0 时,返回json字符串,经过解析,对返回的字符串属性做如下说明:】
DeviceSN 动态二维码生成器生成的地址卡号,八位长度十六进制字符串:00897932
CheckCode
CheckCode2 校时需要等待的时间(单位:秒)
Battery 动态二维码生成器生成的电池电量,4482mV
ManufactureTime 设备生产时间,2023-05-09T18:40:00,标准UTC时间
ManufactureTimeStr设备生产时间,2023-05-09 18:40:00
QRStr 动态二维码生成器生成生成的加密后的地址卡字符串 000000062E080D2F38C59D3348A35412D68D4024/04ED337302CC82BB750CFC7DD0488F1B ,如果字符串中包含字符 / 则为新版的精确二维码;不包含,则为旧版的普通二维码
ScanTime 手机APP扫描二维码日期、时间,2024-05-21T15:36:23 标准UTC时间
ScanTimeStr 手机APP扫描二维码时间 15:36:23
DecodeTime 调用接口到服务器解码时间 2024-05-21T15:36:24.0164434+08:00 标准UTC时间
DecodeTimeStr 调用接口到服务器解码时间 15:36:24
RetCode 解码过程中的错误代码 4020
ErrorStr 解码过程中的错误描述以及代码 当前为更换电池,请重新扫码进行校时,4020
}
返回值:Result 描述 Result=0 解码成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-31 Token 失效 Result=4001 密钥文件打开失败 Result=4002 密钥文件写失败 Result=4003 密钥文件读失败 Result=4004 密钥文创建失败 Result=4005 密钥文件与二维码不匹配 Result=4000 二维码解码成功,但二维码版本不支持高级功能 Result=4016 二维码已经过期 Result=4017 二维码数据库连接错误 Result=4018 扫码时间或提交时间格式错误 Result=4019 扫码中断和服务器时间差异超过有效范围 Result=4020 当前为更换电池,请重新扫码进行校时 Result=4021 换电池校时,不在卡号和记录 Result=4022 校时操作,卡号校验错误
-
ReadNoHandMessage
阅读未处理的消息(新版APP)
参数:
string Token:占位
string ID:消息自身的ID,getNoHandMessage 接口返回的 ID,加密
string TypeID:消息的分类,getNoHandMessage 接口返回的 TypeID,加密
string ActivaCode:占位
string HandString:占位
返回结构:
public class ReturnValue
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 获取成功 Result=-1 程序错误,Message 为错误信息
-
RegisterCard
卡号注册
参数:
string Token: Token,
string RouteID: 线路ID【单单新增一个地址卡,不将地址卡绑定到“线路”的时候,RouteID = 0;;新增地址卡,同时将地址卡绑定到“线路”,此处的 RouteID > 0】, 加密
string CardNo: 卡号(八位长度的,十六进制字符串), 加密
string CardName: 卡号名称, 加密
string CardType: 卡类型:0=地点卡;1=人员卡, 加密
string Comments: 备注信息,最多100个字【可为空】, 加密
string Longitude: 经度(仅地点卡使用)【可为空】, 加密
string Latitude: 纬度(仅地点卡使用)【可为空】, 加密
返回值:Result 描述 Result = 0 注册成功, TimeCount 为添加的ID【int】;;;Message为新增的卡号(对注册GPS卡号,传入空卡号的时候有意义) Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-3 卡号已经存在 Result=-4 卡名称重复 Result=-5 不能选择“根线路” Result=-6 输入的线路不存在 Result=-7 不能选择“父线路” Result=-8 非地址卡,卡号不能为空 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 -
RegisterCompany
注册公司信息(旧APP,巡探卫士)
参数:
string DealerID:经销商ID(加密前,为正整数),加密
string DeviceTypeNo:机器型号(APP中定义的全局变量),加密
string CompanyName:公司名称,加密
string UserName:用户名,加密
string MobileNo:手机号码(保证用户输入的中国的手机号码前面不包含+86),加密
string Password:密码,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 注册成功 Result=-1 程序错误,Message为错误信息 Result=-10 公司名称已经注册(公司名称重复) Result=-11 手机号码已经注册(手机号码重复) Result=-12 注册公司失败 Result=-13 公司名称不能为空 Result=-14 发生未知错误,请联系管理员 Result=-15 输入的经销商编码不存在 Result=-18 发送注册验证码的手机号,已经被注册 Result=-19 发送注册验证码的Email,已经被注册
-
RegisterCompanyCode
注册公司信息(新版 APP)
参数:
string DealerID:经销商ID(加密前,为正整数,扫描二维码解码后获取),加密
string CompanyName:公司名称,加密
string DeviceTypeNo:机器型号(使用激活码,从激活码中,解码而来 00010801),加密
string DeviceID:机器号(使用激活码,从激活码中,解码而来 202503300001),加密
string UserName:用户名,加密
string PhoneNoEmail:发送验证码的手机号或者邮箱,加密
string Password:密码,加密
string ActivaCode:激活码
string PhoneEigenValue:手机特征值(AndroidID),加密
string ERCodeString:扫描二维码的内容,不加密,不加密,不加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 注册成功 Result=-1 程序错误,Message为错误信息 Result=-10 公司名称已经注册(公司名称重复) Result=-11 机器号 DeviceID 已经注册 Result=-12 注册公司失败 Result=-13 公司名称不能为空 Result=-14 生成公司编码失败 Result=-15 输入的经销商编码不存在 Result=-16 创建公司数据库失败,请联系管理员,在后台手动创建 Result=-17 注册使用的验证手机号码,已经被注册 Result=-18 发送注册验证码的手机号,已经被注册 Result=-19 发送注册验证码的Email,已经被注册
-
RegisterDevice
注册用户信息(新版APP)
分两种情况注册:
第一种:登陆前,通过扫描企业二维码注册,这个时候 参数 Token 为空;; DealerID、CompanyCode,不为空
第二种:登陆“巡探 查询 APP”后,注册,这个时候 参数 Token 不能为空;; DealerID、CompanyCode,为空
参数:
string Token:Token
string DealerID:经销商ID(加密前,为正整数),加密
string CompanyCode:公司编码(长度为6位),扫描企业二维码所得,加密
string DeviceTypeNo:机器型号(通过解码激活码所得,00010803),加密
string DeviceID:机号(通过解码激活码所得,2025032500001),加密
string PhoneNoEmail:注册的时候发送短信验证码或者邮件验证码的 号码加密
string UserName:用户名,加密
string PurviewID:用户权限ID(加密前,为正整数,默认为 1),加密
string Password:密码,加密
string ActivaCode:激活码
string ActivaString:激活码,解码后的 json 字符串
string PhoneEigenValue:手机特征值,AndroidID加密
string ModelString:功能码,json
string DeviceString:APK 收集的手机信息,json
string ERCodeString:扫描二维码的内容,不加密,不加密,不加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 注册成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token 错误 Result=-3 查询用户失败 Result=-19 此用户名称已经存在,不能重复注册 Result=-20 公司已经被删除,或者公司不存在 Result=-21 公司还没有启用,不能注册操作用户 Result=-22 此手机号码已经注册,不能重复注册 Result=-31 Token 失效
-
RegisterOperators
注册用户信息(旧版APP)
参数:
string DealerID:经销商ID(加密前,为正整数),加密
string DeviceTypeNo:机器型号(APP中定义的全局变量),加密
string CompanyCode:公司编码(长度为6位),加密
string UserName:用户名,加密
string PurviewID:用户权限ID(加密前,为正整数),加密
string MobileNo:手机号码(保证用户输入的中国的手机号码前面不包含+86),加密
string Password:密码,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 注册成功 Result=-1 程序错误,Message为错误信息 Result=-19 此用户名称已经存在,不能重复注册 Result=-20 公司已经被删除,或者公司不存在 Result=-21 公司还没有启用,不能注册操作用户 Result=-22 此手机号码已经注册,不能重复注册
-
RouteAddressCardSortAgain
线路下的地址卡重新排序,上移,或者下移
参数:
string Token:Token,
string RouteID: 线路 ID,加密
string CurrSotrID:选中的地址卡的排序号【SpotInfo 类中 Orders 字段】 加密
string SotrID:选中的地址卡,上一张地址卡的排序号【上移】;或者下一张地址卡的排序号【下移】加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-31 Token失效
-
SaveAlarmInfo
在手机上保存“报警信息”
参数:
string Token:Token
string UserName:当前用户的用户卡号,加密
string AddressCardNo:最后一次的地址卡号,加密
string RouteID:巡更线路ID,加密
string AlarmInfo:报警内容 加密
返回值:Result 描述 Result=0 报警信息发送成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token 非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-3 报警信息写入数据库失败
-
SaveData
Save data (For exception/event devices)
Parameters:
string UnisionID: An uniquo id of original data, Unencrypted
string sCardID: Tag id of a location point, Encrypted
string sPatrolMan: Tag id or user id of an user, Encrypted
string Time: Check time, The count of seconds since 1970.1.1 0:0:0, Encrypted
string sExceptionID: One or more exception IDs, separate the IDs by comma, Encrypted
string sMeterID: Device ID, Guard Tour Device ID, Encrypted
string sRoute: Route ID, the route id of checking, Encrypted
ReturnValue:
Result=0: Data saved
Result=1: Data existed
Result=-1: Error, Message field contains error message
-
SaveDataMachineMode1ByJSON
Save Machine data by json (For the devices contains Machine)
Parameters:
Instantiate class MachineData, fill the checked data in it and convert it to a json string as parameter
public class MachineData
{
public string RouteID;
public string SpotID;
public string CardID;
public double CheckTime;
public string MachineID;
public string RouteMachineID;
public string UserID;
public string UserCard;
public double Longitude;
public double Latitude;
public string DeviceID;
public string RecordCode;
public int MachineState;
public List<CheckItemInfo> CheckItems = new List<CheckItemInfo>();
}
public class CheckItemInfo
{
public int CheckItemID;
public int RouteCheckItemID;
public string CheckItemName;
public int CheckItemType;
public int UnitID;
public int RouteUnitID;
public double MaxValue;
public double MinValue;
public double DefaultValue;
public double ReferenceValue;
public string UnitName;
public double CheckValue;
public List<OptionItemInfo> Options = new List<OptionItemInfo>();
}
public class OptionItemInfo
{
public int OptionItemID;
public int RouteOptionItemID;
public string OptionItemName;
}
ReturnValue:
Result=0: Data saved
Result=1: Data existed
Result=-1: Error, Message field contains error message
-
SaveDataMode1ByJSON
Save data by json (For exception/event/Check Items devices)打卡记录保存
Parameters:
Instantiate class SpotInfo, fill the checked data in it and convert it to a json string as parameter
string Token:Token
string TimeZone:时区,
string str:巡检数据,json 数据格式
public class SpotInfoEx : SpotInfo
{
public List<CheckItemInfo> CheckItems = new List<CheckItemInfo>();
public List<ExceptionInfo> Exceptions = new List<ExceptionInfo>();
public List<string> Photos = new List<string>();
}
public class CheckItemInfo
{
public int CheckItemID;
public int RouteCheckItemID;
public string CheckItemName;
public int CheckItemType;
public int UnitID;
public int RouteUnitID;
public double MaxValue;
public double MinValue;
public double DefaultValue;
public double ReferenceValue;
public string UnitName;
public double CheckValue;
public List<OptionItemInfo> Options = new List<OptionItemInfo>();
}
public class ExceptionInfo
{
public int ExceptionID;
public string ExceptionName;
}
public class OptionItemInfo
{
public int OptionItemID;
public int RouteOptionItemID;
public string OptionItemName;
}
ReturnValue:
Result=0: Data saved
Result=1: Data existed
Result=-1: Error, Message field contains error message
Result=-10: 当前登录帐号已经在其他机器上登录
-
SaveDataMode1ByJSONNew
Save data by json (For exception/event/Check Items devices)打卡记录保存
Parameters:
Instantiate class SpotInfo, fill the checked data in it and convert it to a json string as parameter
string Token:Token
string DeviceType:机型型号【Z-9000 00010701、Z-M900 00010801、Z-M900 Pro 00010802】,加密
string TimeZone:时区,
string str:巡检数据,json 数据格式
public class SpotInfoEx : SpotInfo
{
public List<CheckItemInfo> CheckItems = new List<CheckItemInfo>();
public List<ExceptionInfo> Exceptions = new List<ExceptionInfo>();
public List<string> Photos = new List<string>();
}
public class CheckItemInfo
{
public int CheckItemID;
public int RouteCheckItemID;
public string CheckItemName;
public int CheckItemType;
public int UnitID;
public int RouteUnitID;
public double MaxValue;
public double MinValue;
public double DefaultValue;
public double ReferenceValue;
public string Comments; // 有客户需要每一条巡检项目,上传一条备注信息
public string UnitName;
public double CheckValue;
public List<OptionItemInfo> Options = new List<OptionItemInfo>();
}
public class ExceptionInfo
{
public int ExceptionID;
public string ExceptionName;
}
public class OptionItemInfo
{
public int OptionItemID;
public int RouteOptionItemID;
public string OptionItemName;
}
ReturnValue:
Result=0: Data saved
Result=1: Data existed
Result=-1: Error, Message field contains error message
Result=-10: 当前登录帐号已经在其他机器上登录
-
SaveDeviceReadCardModel
保存设备读卡模式进数据库
参数:
string Token:Token 不为空;
string MeterID:设备完整机号(GetAPPDeviceList 接口 返回的 MeterID 属性),加密
string DeviceReadCardModel:用户选择的读卡模式(可以多选 1,2,3,4,5 中间以英文逗号分割),不为空 加密
返回结构:
public class DeviceMode
{
public string MeterType; // 机器型号 00010801、00010802
public string DeviceRealID; // 机器完整的机号(机器型号 + 机器ID) 举例 0001080113800138000、00010803202503250456
public string MeterID; // 登录用户名称【如果使用人脸登录,则使用这个属性做为参数】
public string DeviceAllowReadCardModel; // 当前设备【能够允许】的读卡模式【1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码; 返回的值为1,2,3】
public string DeviceReadCardModel; // 当前设备【已经设置成功】的读卡模式【返回的值为1,2,3 ,可以为多种打卡模式】
public int RouteID; // 当前设备绑定的线路
public int RouteName; // 当前设备绑定的线路
}
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token非法 Result=-3 Token失效 Result=-10 当前帐号已经在其他设备登录
-
SaveExceptionDataJSON
执法记录仪 保存 打卡记录
Parameters:
Instantiate class SpotInfo, fill the checked data in it and convert it to a json string as parameter
public class SpotInfoEx : SpotInfo
{
public List<CheckItemInfo> CheckItems = new List<CheckItemInfo>();
public List<ExceptionInfo> Exceptions = new List<ExceptionInfo>();
public List<string> Photos = new List<string>();
}
public class CheckItemInfo
{
public int CheckItemID;
public int RouteCheckItemID;
public string CheckItemName;
public int CheckItemType;
public int UnitID;
public int RouteUnitID;
public double MaxValue;
public double MinValue;
public double DefaultValue;
public double ReferenceValue;
public string UnitName;
public double CheckValue;
public List<OptionItemInfo> Options = new List<OptionItemInfo>();
}
public class ExceptionInfo
{
public int ExceptionID;
public string ExceptionName;
}
public class OptionItemInfo
{
public int OptionItemID;
public int RouteOptionItemID;
public string OptionItemName;
}
ReturnValue:
Result=0: Data saved
Result=1: Data existed
Result=-1: Error, Message field contains error message
Result=-10: 当前登录帐号已经在其他机器上登录
-
SaveGPSInfo
保存 GPS 数据
参数:
string Token: Token 数据
string DeviceNo: 设备编码,加密
string str: jSon 字符串
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 Result=-32 传入的经纬度错误
-
SaveHomePageConfig
保存“首页底部配置值”
参数:
string Token: Token 数据
string TypeID:分类:0、紧急警报;1、项目异常;2、漏检提醒;3、跌摔记录;加密
string LoginName:当前登录用户的用户名称加密
string MaxID:最大值,加密
当 TypeID = 0 时,MaxID 传入 HomePage 返回数据中 MaxAlarmID
当 TypeID = 1 时,MaxID 传入 HomePage 返回数据中 MaxOriginID
当 TypeID = 2 时,MaxID 传入 HomePage 返回数据中 MaxMissID
当 TypeID = 3 时,MaxID 传入 HomePage 返回数据中 MaxCrashID
返回值:结果 描述 Result=0 新增成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 Token失效 提示:Result=-4 保存失败
- SaveMeasureTools
在手机上保存“新增测量工具”信息
参数:
string Token:Token
string ToolNo:测量工具编码(蓝牙地址、MAC地址、……),非空,加密
string ToolName:测量工具名称,非空,加密
string Comments:备注,加密
返回值:Result 描述 Result=0 保存成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token 非法 Result=-3 写入数据库失败 Result=-4 编码已经存在 Result=-5 名称已经存在 Result=-10 当前登录帐号已经在其他机器上登录
- SaveRecordF1
- SaveSampleData
- SaveShakeData
保存 测温测震 数据
参数:
string Token: Token
string DeviceTypeNo:机器型号(固定值 00010702),非空,加密
string DeviceNo:机器编号,非空,加密
string str: jSon 字符串
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 Result=-32 传入的经纬度错误
- SaveShakeDataByMachine
保存 测温测震 数据
参数:
string Token: Token
string RouteID:UnsionID,可以为空
string RouteID:线路ID,非空,加密
string DeviceTypeNo:机器型号(固定值 00010702),非空,加密
string DeviceNo:机器编号,非空,加密
string str: jSon 字符串
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 Result=-32 传入的经纬度错误
- SendNETEmail
- SendSMSMessage
发送短信 或者 邮箱验证码
参数:
string MobileNo:手机号码(保证用户输入的中国的手机号码前面不包含+86)或者邮件地址,加密
string SMSContent:新的短信内容(直接为空)加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 发送成功【此时 Message 为六位验证码(纯数字)】 Result=-1 发送错误,Message为错误信息 Result=-11 手机号码错误 Result=100022 其他类似这种大于 0 的值,是第三方返回的类容
- SetDeviceRoute
设备与线路绑定
参数:
string Token: Token, 未加密
string DeviceID: 设备编号, 加密
string RouteID: 线路ID, 加密
返回值:Result 描述 Result=0 绑定成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-3 当前设备不存在,尝试重新登录! Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效! - SetPartolConfigInterval
设置【1、推送时间区间;】
参数:
string Token:Token
string BeginTime:开始时间(格式 HH:mm)加密
string EndTime:结束时间(格式 HH:mm)加密
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 新增失败 Result=-4 获取操作用户失败
- SetPartolConfigTime
设置【2、动态更新时间;】
参数:
string Token:Token
string ConfigValue:设置值(数值型)加密
返回值:Result 描述 Result=0 执行成功 Result=-1 程序错误,Message为错误信息 Result=-2 新增失败 Result=-4 获取操作用户失败
- SetValidCardTime
设置同一个点有效时间,默认5分钟
参数:
string Token:Token
string TimeNum:设置时常(分钟)数字型
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 设置同一个点有效时间成功 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
- TokenEffective
判断 Token 是否有效- UpdatMobileNoPassword
忘记密码后手机重置密码
参数:
MobileNo Token:手机号码加密
string Password:新密码,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-31 手机未注册
- UpdatMobileNoPasswordCode
新APP首页,忘记密码,修改用户密码
参数:
string DeviceID:使用激活码解码后的DeviceID 加密
string UserInfo:用户登录名称 或 用户绑定的手机号码 或 Email 加密
string Password:新密码,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-31 DeviceID
- UpdateAddressCard
重新更新地址卡的经纬度
参数:
string Token: Token,
string CardNo: 卡号(八位长度的,十六进制字符串), 加密
string Comments: 备注信息,最多100个字【可为空】, 加密
string Longitude: 经度【不可为空】, 加密
string Latitude: 纬度【不可为空】, 加密
返回值:Result 描述 Result = 0 更新成功 Result=-1 错误, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效 - UpdateAddressName
修改某一张地址卡的名称
参数:
string Token:Token,
string CardNo: 地址卡的卡号【八位长度的十六进制字符串】。加密
string CardName: 新的地址卡名称加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message 为“新增的线路的 ID” Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-12 新的地址卡名称已经存在 Result=-31 Token失效
- SaveMeasureTools
-
UpdateAssignPassword
修改指定用户密码
参数:
string Token:Token
string Token:指定用户ID,operatorID
string Password:新密码,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-31 Token 失效
-
UpdateDangerRejectStat
修改隐患驳回阅读状态
参数:
string Token: Token, 未加密
参数:
string userId 用户ID返回值:Result 描述 Result=1 执行成功 Result=-1 程序错误,Message为错误信息 Result=-10 当前登录帐号已经在其他机器上登录
-
UpdateDeviceName
重命名设备名称
参数:
string Token:Token
string DeviceNo:设备编号,加密
string DeviceName:设备名称,加密
返回值:Result 描述 Result=0 设备名称保存成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token 非法 Result=-3 设备(手机)名称为空,需要输入手机名称 Result=-31 Token 失效
-
UpdateMeasureTools
在手机上“编辑测量工具名称”信息
参数:
string Token:Token
string ToolNo:测量工具编码(蓝牙地址、MAC地址、……),非空,加密
string ToolName:测量工具名称,非空,加密
返回值:Result 描述 Result=0 保存成功 Result=-1 程序错误,Message为错误信息 Result=-2 Token 非法 Result=-3 写入数据库失败 Result=-5 名称已经存在 Result=-10 当前登录帐号已经在其他机器上登录
-
UpdateMessageState
更新对应的消息的状态
参数:
string Token: Token 数据 加密
string MessageTargetID: 消息发送目标的 ID【多个ID之间使用 , 隔开】,加密
string StateID: 更改后的状态(只能传入 2 接收成功;3 已经阅读;),加密
返回结构:
返回值:结果 描述 Result=0 更新成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
UpdatePassword
修改登录用户密码
参数:
string Token:Token
string Password:新密码,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-31 Token 失效
-
UpdateReadCardMode
管理员切换“读卡模式”
参数:
string Token:Token
string DeviceID:设备ID【Z-9000的设备是设备机号】【Z-M900、Z-M900 Pro 为 登录接口 LoginOperators 返回的 DeviceID 属性】,加密
string ReadCardMode:用户切换后的读卡模式【读卡模式:1、普通二维码;2、蓝牙读卡;3、射频读卡;4、GPS;5、精确二维码;】,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 当前登录用户非法 Result=-4 当前用户无操作权限 Result=-31 Token 失效
-
UpdateReadCardTimeSpacing
修改公司“读卡时间间隔”
参数:
string Token:Token
string ReadCardTimeSpacing:读卡时间间隔(单位:分钟),加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 当前登录用户非法 Result=-4 当前用户无操作权限 Result=-31 Token 失效
-
UpdateRouteName
修改一条线路(修改线路名称)
参数:
string Token:Token,
string RouteID: 需要修改的线路的 ID 【必须为大于零的正整数】,加密
string RouteName: 新的线路名称加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message 为“新增的线路的 ID” Result=-1 出错, Message为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-12 新的线路名称已经存在 Result=-31 Token失效
-
UpdateUserPurview
修改用户权限
参数:
string Token:Token
string UserID:用户唯一标识【QueryOperators 接口返回的UserID】,加密
string UserTypeID: 用户权限,只有这三种:【0、企业管理员;1、普通管理员;2、普通用户;】,加密
string ListRouteID: 设置的用户拥有的线路ID集合【多个线路ID,使用英文逗号,隔开,然后加密】,加密
返回结构:
public class SimpleResult
{
public string Result; // 错误代码
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 修改成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
-
UploadUserFinger
上传人员指纹信息
参数:
string Token: Token 数据
string DeviceNo: 设备编码(加密)
string FingerIndex: 指纹序号(加密)
string FingerString: 指纹十六进制字符串
返回结构:
ReturnValue<List<UserFingerModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;
public string Message;
public T Values;
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-4 指纹已经存在,无须重新上传 Result=-5 指纹数据写入指纹模板失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-31 Token 失效
提示:
-
UploadUserFingerByFile
上传人员指纹信息【使用Text文件的形式上传指纹】
参数:
string Token: Token 数据
string DeviceNo: 设备编码(加密)
string FileName: Text文件名称(示例:123456.txt),注意,每次上传的txt文件的名称唯一
返回结构:
ReturnValue<List<UserFingerModel>> json 字符串数据
public class ReturnValue<T>
{
public long Result;
public int MaxCount;
public string Message;
public T Values;
}
返回值:结果 描述 Result=0 获取成功 Result=-1 错误, Message 为错误信息 Result=-2 Token非法 Result=-3 获取登录用户数据失败 Result=-4 指纹已经存在,无须重新上传 Result=-5 指纹数据写入指纹模板失败 Result=-6 写入数据库失败 Result=-10 当前登录帐号已经在其他机器上登录 Result=-11 上传的txt文件,是空文件,没有内容 Result=-12 上传的txt文件,内容错误,行数不是双数行 Result=-13 未找到上传的txt指纹文件 Result=-31 Token 失效
提示:
-
UserLogin
用户登录(巡探--查询APP、Android、IOS、小程序)
参数:
string CompanyName:公司名称,加密
string UserName:用户名称,加密
string Password:密码,加密
string UserType:用户类型(1、单用户登录;2、经销商多用户登录(默认);),加密
返回结构:
public class LoginResult
{
public int Result; // 返回结果,错误代码
public int UserID; // 用户ID,数据库字段ID,唯一值
public string CardNo; // 当前登录用户卡号
public string UserName; // 当前登录用户名称
public int UserType; // 用户分类【0、管理员;1、普通用户;】
public string DeviceName; // 借用,实际上的值为“公司编码”
public int RouteCount; // 借用 RouteCount 保存当前公司是否拥有“Z-9000”的机器:0、没有;1、拥有;
public string UsersCardID; // 借用 UsersCardID 保存当前公司是否拥有“隐患相关的六大权限”,表现形式为:0,1,0,1,0,1, 【0、表示没有此权限;1、表示拥有;】
// 为一个字符串,以英文逗号 , 隔开,对应权限分别为:1、隐患录入;2、隐患处理;3、隐患审核;4、隐患浏览;5、隐患驳回;6、隐患统计;
public string jSonContent; // jSon 字符串,控制APP中按钮的 显示(true)/隐藏(false)
public string Message; // 错误信息
}
返回值:Result 描述 Result=0 执行成功,Message为Token数据 Result=-1 程序错误,Message为错误信息 Result=-2 公司不存在 Result=-3 公司未启用 Result=-4 当前公司使用到期 Result=-5 经销商使用到期 Result=-6 不存在合法的加密狗或证书 Result=-7 设备使用超额 Result=-8 登录用户不存在 Result=-9 密码输入错误
-
WeiXinTransit
微信中转
参数:
string TransitID:传入的参数,加密
返回结构 jSon 字符串:
-
getContactMessage
有后台获取联系方式
参数:
string Token:占位
string DeviceTypeNo:机器型号(通过解码激活码所得,00010803),加密
string DeviceID:机号(通过解码激活码所得,2025032500001),加密
string TypeID:占位,加密
string ActivaCode:激活码
返回结构:
public class ReturnValue
{
public string Result; // 错误代码
public string Message; // 错误信息
}
public class ContactModel
{
public int No; // 序号
public string Title; // 显示标题
public List<ContactDetailModel> ListDetail; // 明细
public string Remark; // 备注(用不上,占位)
}
public class ContactDetailModel
{
public int No; // 序号
public bool Href; // 是否超链接【true、是(在页面上,加上超链接地址,点击转到对应页面);false、不做操作】
public bool CallNo; // 能否拨打电话【true、能(在页面上,点击,可以直接转到电话页面,自动拨打电话);false、不做操作】
public string PicturePath; // 图片地址
public string Describe; // 显示标题
public string Content; // 显示内容
public string Remark; // 备注(用不上,占位)
}
返回值:Result 描述 Result=0 获取成功 Result=-1 程序错误,Message 为错误信息
-
getNoHandMessage
获取未处理的消息
参数:
string Token:占位
string DeviceTypeNo:机器型号(通过解码激活码所得,00010803),加密
string DeviceID:机号(通过解码激活码所得,2025032500001),加密
string TypeID:占位,加密
string ActivaCode:激活码
返回结构:
public class ReturnValue
{
public string Result; // 错误代码
public string Message; // 错误信息
}
public class MessageModel
{
public int ID; // 序号
public int TypeID; // 消息分类
public string TypeName; // 消息分类 名称
public string Title; // 显示标题
public string Content; // 显示内容
public string Remark; // 备注(用不上,占位)
public DateTime CreateTime; // 时间
}
返回值:Result 描述 Result=0 获取成功 Result=-1 程序错误,Message 为错误信息
此 Web 服务使用 http://tempuri.org/ 作为默认命名空间。
建议: 公开 XML Web services 之前,请更改默认命名空间。
每个 XML Web services 都需要一个唯一的命名空间,以便客户端应用程序能够将它与 Web 上的其他服务区分开。http://tempuri.org/ 可用于处于开发阶段的 XML Web services,而已发布的 XML Web services 应使用更为永久的命名空间。
应使用您控制的命名空间来标识 XML Web services。例如,可以使用公司的 Internet 域名作为命名空间的一部分。尽管有许多 XML Web services 命名空间看似 URL,但它们不必指向 Web 上的实际资源。(XML Web services 命名空间为 URI。)
使用 ASP.NET 创建 XML Web services 时,可以使用 WebService 特性的 Namespace 属性更改默认命名空间。WebService 特性适用于包含 XML Web services 方法的类。下面的代码实例将命名空间设置为“http://microsoft.com/webservices/”:
C#
[WebService(Namespace="http://microsoft.com/webservices/")]
public class MyWebService {
// 实现
}
Visual Basic
<WebService(Namespace:="http://microsoft.com/webservices/")> Public Class MyWebService
' 实现
End Class
C++
[WebService(Namespace="http://microsoft.com/webservices/")]
public ref class MyWebService {
// 实现
};
有关 XML 命名空间的更多详细信息,请参阅 Namespaces in XML (XML 命名空间)上的 W3C 建议。
有关 WSDL 的更多详细信息,请参阅 WSDL Specification (WSDL 规范)。
有关 URI 的更多详细信息,请参阅 RFC 2396。