安治云维保服务平台

介绍
 签名算法
 报障接口
- 单条报障
- 获取障单状态
 工单接口
- 批量提交工单
 获取受理用户
 状态码

签名

签名参数

参数名	类型	描述	示例
appid	string	用户唯一标识，在管理控制台获取	9b11127a9701975c734b8aee81ee3526
secretkey	string	秘钥，在管理控制台获取	5C3C18144B84DF184960C4ACC425CC58
nonce	string	随机字符串，不长于32位	5K8264ILTKCH16CQ2502SI8ZNMTM67VS
timestamp	string	当前时间戳	1550045202
func	string	请求方法名	addFault

签名步骤

第一步，将签名参数按照参数名ASCII码从小到大排序（字典序），排序后：

appid=9b11127a9701975c734b8aee81ee3526&func=single_fault&nonce=5K8264ILTKCH16CQ2502SI8ZNMTM67VS&secretkey=5C3C18144B84DF184960C4ACC425CC58×tamp=1550045202

第二步，对以上字符串做md5加密

md5(appid=9b11127a9701975c734b8aee81ee3526&func=single_fault&nonce=5K8264ILTKCH16CQ2502SI8ZNMTM67VS&secretkey=5C3C18144B84DF184960C4ACC425CC58×tamp=1550045202)

第三步，将得到的字符串所有字符转换为大写得到sign

单条报障

请求

URL地址：http://www.azycloud.cn/api/fault/addFault

访问方式：POST

请求参数

参数名	类型	必传	描述	示例
appid	string	是	用户唯一标识，在管理控制台获取	9b11127a9701975c734b8aee81ee3526
nonce	string	是	随机字符串，不长于32位	5K8264ILTKCH16CQ2502SI8ZNMTM67VS
timestamp	string	是	当前时间戳	1550045202
func	string	是	请求方法名	addFault
sign	string	是	签名，详见签名生成算法	83259563315EE50FFDE1E380BF24EEF9
device_name	string	是	设备名称	软件园南门球技机
device_code	string	是	设备编号(唯一)	QJJ0058
device_no	string	否	设备型号	YES-HD9836M
device_address	strring	是	设备安装地址	厦门市软件园二期南门球技机
device_brand	string	否	设备品牌	雅视威
longitude	string	否	经度	118.1867462355
latitude	string	否	纬度	24.4886389643
fault_number	string	否	障单编号(用于反馈,允许空)	0001
fault_describe	string	是	障单描述	离线
fault_level	int	否	障单等级(1到5,数字越小越紧急,默认3位普通障单)	3
target_id	string	是	受理用户的巡检标识(维保关系中设置的巡检标识)	凯迪

参数示例

参数类型：JSON


{
	"code": "0001",
	"desc": "获取成功",
	"data": {
		"appid": "a400de5613b30293ce820ade79a2df64",
		"func": "addFault",
		"nonce": "123654789zxjsnd",
		"secretkey": "332CBDBAF5565A3BA22DB56F378FF309",
		"timestamp": 1598601958,
		"sign": "005F5B2EA668308C94554A9C32A43AF0",
		"is_encryption": "no",
		"data": {
			"device_name": "软件园南门球技机",
			"device_code": "QJJ0058",
			"device_no": "YES-HD9836M",
			"device_address": "厦门市软件园二期南门球技机",
			"device_brand": "雅视威",
			"longitude": "118.1867462355",
			"latitude": "24.4886389643",
			"fault_number": "000001",
			"fault_describe": "离线",
			"fault_level": 3,
			"target_id": "凯迪"
		}
	}
}

响应

名称	类型	描述
code	string	0000:失败;0001成功;
desc	text	例如"成功"，或者相应错误信息

Json返回示例


失败：
{
	"code": "0000",
	"desc": "巡检标识错误",
	"data": []
}
成功：
{
	"code": "0001",
	"desc": "报障成功",
	"data": []
}

获取障单状态

请求

URL地址：http://www.azycloud.cn/Api/fault/getFaultState

访问方式：POST

请求参数

参数名	类型	必传	描述	示例
appid	string	是	用户唯一标识，在管理控制台获取	9b11127a9701975c734b8aee81ee3526
nonce	string	是	随机字符串，不长于32位	5K8264ILTKCH16CQ2502SI8ZNMTM67VS
timestamp	string	是	当前时间戳	1550045202
func	string	是	请求方法名，func=get_faultstate	get_faultstate
sign	string	是	签名，详见签名生成算法	83259563315EE50FFDE1E380BF24EEF9
fault_number	string	是	障单编号（由客户提供,请确保唯一性）	000001

参数示例

参数类型：JSON


{
	"appid": "a400de5613b30293ce820ade79a2df64",
	"func": "getFaultState",
	"nonce": "123654789zxjsnd",
	"secretkey": "332CBDBAF5565A3BA22DB56F378FF309",
	"timestamp": 1598601958,
	"sign": "18C760516CC79706688F639713C2EE93",
	"data": {
		"fault_number": "000001"
	}
}

响应

名称	类型	描述
code	int	0000:失败;0001成功;
desc	text	例如"成功"，或者相应错误信息
FaultState	int	障单状态：-4.障单挂起 -3.审核挂起 -2.是否终止 -1.无效 0.回退 1.提交成功 2.查看订单 3.已派单 4.已接单 5.上门服务 6.提交完成 7.完成订单 8.已评价
FaultNumber	string	障单编号
CreateTime	date	创建时间

Json返回示例


{
	"code": "0001",
	"desc": "成功",
	"data": {
		"FaultNumber": "000001",
		"FaultState": 1,
		"CreateTime": "2020-08-31 16:23:21"
	}
}

批量提交工单

请求

URL地址：http://www.azycloud.cn/api/fault/batchAddWorkOrder

访问方式：POST

请求参数

参数名	类型	必传	描述	示例
appid	string	是	用户唯一标识，在管理控制台获取	9b11127a9701975c734b8aee81ee3526
nonce	string	是	随机字符串，不长于32位	5K8264ILTKCH16CQ2502SI8ZNMTM67VS
timestamp	string	是	当前时间戳	1550045202
func	string	是	请求方法名，func=batch_workorder	batch_workorder
sign	string	是	签名，详见签名生成算法	83259563315EE50FFDE1E380BF24EEF9
data	array	是	工单列表
work_order_num	string	是	工单标号(用于返回工单状态)	6551125665633ab
work_order_level	int	是	工单等级(1~5,,数字越小越紧急)	5
target_id	string	是	巡检标识(本公司,分公司或维保公司)	凯迪
device_info	array	是	设备数据	列表
device_code	string	是	设备编码(唯一编码)	abc369258741
device_name	string	是	设备名称	软件园圆形球机
device_address	string	是	设备地址	望海路东门
device_no	string	是	设备型号	SXT00581
device_brand	string	是	设备品牌	海康威视
device_latitude	string	是	设备所在纬度	24.4444444
device_longitude	string	是	设备所在经度	118.2345678
fault_list	array	是	障单	列表
fault_num	string	是	障单编号(用于障单状态查询)	zd789456123
fault_describe	string	是	故障信息	离线
fault_level	int	是	故障等级(数字越小,越紧急)	3

参数示例

参数类型：JSON


{
	"appid": "a400de5613b30293ce820ade79a2df64",
	"func": "batchAddWorkOrder",
	"nonce": "123654789zxjsnd",
	"secretkey": "332CBDBAF5565A3BA22DB56F378FF309",
	"timestamp": 1598601958,
	"sign": "8AE030E4CE15A557D1F9F8ECD280B1EE",
	"data": [{
		"work_order_num": "6551125665633ab",
		"work_order_level": 5,
		"target_id": "凯迪",
		"device_info": {
			"device_code": "abc369258741",
			"device_name": "软件园圆形球机",
			"device_address": "软件园观日路30号302",
			"device_no": "QT001",
			"device_brand": "海康威视",
			"device_latitude": "24.4444444",
			"device_longitude": "118.2345678"
		},
		"fault_list": [{
			"fault_num": "zd789456123",
			"fault_describe": "离线",
			"fault_level": 3
		}]
	}]
}

响应

名称	类型	描述
code	int	0000:失败;0001成功;
desc	text	例如"工单上报成功"，或者相应错误信息

Json返回示例


失败：
{
	"code": "0000",
	"desc": "巡检标识错误",
	"data": []
}
成功：
{
	"code": "0001",
	"desc": "工单上报成功",
	"data": []
}

获取受理用户

请求

URL地址：http://www.azycloud.cn/api/fault/getRelationList

访问方式：POST

请求参数

参数名	类型	必传	描述	示例
appid	string	是	用户唯一标识，在管理控制台获取	9b11127a9701975c734b8aee81ee3526
nonce	string	是	随机字符串，不长于32位	5K8264ILTKCH16CQ2502SI8ZNMTM67VS
timestamp	string	是	当前时间戳	1550045202
func	string	是	请求方法名，func=get_relation	getRelationList
sign	string	是	签名，详见签名生成算法	83259563315EE50FFDE1E380BF24EEF9

参数示例

参数类型：JSON

{
    "appid": "9b11127a9701975c734b8aee81ee3526",
    "nonce": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
    "timestamp": "11550045202",
    "func": "getRelationList",
    "sign": "83259563315EE50FFDE1E380BF24EEF9"
}

响应

名称	类型	描述
code	int	0001:成功;0000:失败
desc	text	例如"成功"，或者相应错误信息
company_type	int	公司类型 (2维保公司 3分公司)
company	text	绑定的公司名称
target_id	text	巡检标识(受理人;如果该值为空进前往安治云售后服务平台进行设置)

Json返回示例


{
	"code": "0001",
	"desc": "成功",
	"data": [{
		"company_type": 2,
		"company": "厦门凯迪空间电子有限公司",
		"target_id": "凯迪"
	},{
		"company_type": 3,
		"company": "分公司",
		"target_id": ""
	}]
}

错误码

错误码	描述	原因	解决方案
0000	失败	一般为参数错误导致或后台配置的原因	检查参数或根据后台配置进行修改
0001	成功	成功提示	执行成功的唯一返回值

障单等级

数字码	说明
1	超级紧急故障，核心所有设备全部故障。
2	紧急故障，核心单台设备故障，影响业务运行。
3	普通的设备故障
4	设备性能明显下降但还能工作
5	技术咨询，版本升级

障单状态

数字码	说明
-4	障单挂起
-3	审核挂起
-2	终止障单
-1	无效障单
0	障单回退
1	障单上报成功
2	障单已被查看
3	障单已被分配
4	障单已被接取
5	正在上门维修
6	维修完成
7	障单完成
8	用户已评价障单