2.4.1.7. 接口定义 - 2.4.1.7.2. Activity（作业） - 《Mixlinker MixIOT 中文文档》

2.4.1.7.2. Activity（作业）

2.4.1.7.2. Activity（作业）

2.4.1.7.2.1. 查询列表(关注设备或关注客户或无设备ID)

调用接口：

属性	值
url	/api/activity/get_list
http方法	post
Content-Type	application/json或application/x-www-form-urlencoded

请求参数：

字段	字段名称	字段类型	说明	是否必传
page_index	查询页码	Integer	大于 0，如果为空，则默认从第一页显示	否
page_size	每页记录数	Integer	大于 0，如果为空，则默认为 20	否
condition	查询条件	Json	LIKE模糊搜索条件	否
start_time	开始时间	Datetime	按创建时间搜索的开始时间和结束时间	否
end_time	结束时间	Datetime		否

condition参数：

格式

[["${key}", "${operator}", "${value}"]] 即 [["查询值", "运算符", "查询内容"]]

举例

[["activity_id", "=", "1001"]]

返回参数：

字段	字段名称	字段类型	说明	是否必传
code	返回码	Integer	200：成功 500：失败	是
msg	提示信息	String		是
result	结果	Json		是

返回数据举例：

{
    "code": 200,
    "msg": "查询成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": {
        "page_index": 1,
        "page_size": 20,
        "total_pages": 1,
        "total_records": 1,
        "data": [
            {
                "activity_id": 1001,
                "activity_name": "日常作业",
                "date": "2018-12-07 12:30:00",
                "category": "",
                "description": null,
                "customer_id": 1001,
                "equipment_id": 1001,
                "staff": "",
                "attachment": "",
                "template": null,
                "script": null,
                "reference": "",
                "created": "2018-12-07 12:30:00",
                "is_available": 1
            }
        ]
    }
}

2.4.1.7.2.2. 查询指定记录

调用接口：

属性	值
url	/api/activity/get
http方法	post
Content-Type	application/json或application/x-www-form-urlencoded

请求参数：

字段	字段名称	字段类型	说明	是否必传
activity_id	作业标识	String		是

返回参数：

字段	字段名称	字段类型	说明	是否必传
code	返回码	Integer	200：成功 500：失败	是
msg	提示信息	String		是
result	返回结果	Json		是

返回示例：

{
    "code": 200,
    "msg": "查询成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": {
        "activity_id": 1001,
        "activity_name": "日常作业",
        "date": "2018-12-07 12:30:00",
        "category": "",
        "description": null,
        "customer_id": 1001,
        "equipment_id": 1001,
        "staff": "",
        "attachment": "",
        "template": null,
        "script": null,
        "reference": "",
        "created": "2018-12-07 12:30:00",
        "is_available": 1
    }
}

2.4.1.7.2.3. 查询列表（EXP使用：关注设备）

调用接口：

属性	值
url	/api/exp/activity/get_list
http方法	post
Content-Type	application/json或application/x-www-form-urlencoded

请求参数：

字段	字段名称	字段类型	说明	是否必传
page_index	查询页码	Integer	大于 0，如果为空，则默认从第一页显示	否
page_size	每页记录数	Integer	大于 0，如果为空，则默认为 20	否
condition	查询条件	Json	LIKE模糊搜索条件	否
start_time	开始时间	Datetime	按创建时间搜索的开始时间和结束时间	否
end_time	结束时间	Datetime		否

返回参数：

字段	字段名称	字段类型	说明	是否必传
code	返回码	Integer	200：成功 500：失败	是
msg	提示信息	String		是
result	结果	Json		是

返回数据举例：

{
    "code": 200,
    "msg": "查询成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": {
        "page_index": 1,
        "page_size": 20,
        "total_pages": 1,
        "total_records": 0,
        "data": []
    }
}

2.4.1.7.2.4. 添加activity

调用接口：

属性	值
url	/api/activity/add
http方法	post
Content-Type	application/json或application/x-www-form-urlencoded

请求参数：

字段	字段名称	字段类型	是否必传
activity_name	作业名称	String	是
date	作业时间	datetime	否
category	作业类型	String	否
description	描述	Text	否
customer_id	客户标识	String	否
equipment_id	设备标识	String	否
staff	服务人员	String	否
attachment	服务附件路径	String	否
template	模板/样式	text	否
script	脚本	text	否
reference	参考号	String	否

返回参数：

字段	字段名称	字段类型	说明	是否必传
code	返回码	Integer	200：成功 500：失败	是
msg	提示信息	String		是
result	返回结果	Json		是

返回示例：

{
    "code": 200,
    "msg": "添加成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": []
}

2.4.1.7.2.5. 编辑activity

调用接口：

属性	值
url	/api/activity/edit
http方法	post
Content-Type	application/json或application/x-www-form-urlencoded

请求参数：

字段	字段名称	字段类型	是否必传
activity_id	作业标识	String	是
activity_name	作业名称	String	否
date	作业时间	datetime	否
category	作业类型	String	否
description	描述	Text	否
customer_id	客户标识	String	否
staff	服务人员	String	否
attachment	服务附件路径	String	否
template	模板/样式	text	否
script	脚本	text	否
reference	参考号	String	否

返回参数：

字段	字段名称	字段类型	说明	是否必传
code	返回码	Integer	200：成功 500：失败	是
msg	提示信息	String		是
result	返回结果	Json		是

返回示例：

{
    "code": 200,
    "msg": "编辑成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": []
}

2.4.1.7.2.6. 删除activity

调用接口：

属性	值
url	/api/activity/delete
http方法	post
Content-Type	application/json或application/x-www-form-urlencoded

请求参数：

字段	字段名称	字段类型	说明	是否必传
activity_id	作业标识	String		是

返回参数：

字段	字段名称	字段类型	说明	是否必传
code	返回码	Integer	200：成功 500：失败	是
msg	提示信息	String		是
result	返回结果	Json		是

返回示例：

{
    "code": 200,
    "msg": "删除成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": []
}