2.4.1.7. 接口定义 - 2.4.1.7.22. Service（服务） - 《Mixlinker MixIOT 中文文档》

2.4.1.7.22. Service（服务）

2.4.1.7.22. Service（服务）

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

调用接口：

属性	值
url	/api/service/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		否
is_all	是否返回所有数据	Boolean	1：是，0：否；如果为空，则默认0	否

condition参数：

格式

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

举例

[["service_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": [
            {
                "service_id": 1001,
                "service_name": "施工服务",
                "date": "2018-11-30 09:16:18",
                "category": "",
                "description": null,
                "customer_id": 1001,
                "equipment_id": 1001,
                "staff": "",
                "attachment": "",
                "template": null,
                "script": null,
                "reference": "",
                "created": "2018-11-30 09:16:52",
                "is_available": 1
            }
        ]
    }
}

2.4.1.7.22.2. 查询Service指定记录

调用接口：

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

请求参数：

字段	字段名称	字段类型	说明	是否必传
service_id	服务标识	String		是

返回参数：

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

返回示例：

{
    "code": 200,
    "msg": "查询成功",
    "mix_code":130001,
    "mix_msg":"",
    "mix_ext":"",
    "result": {
        "service_id": 1001,
        "service_name": "施工服务",
        "date": "2018-11-30 09:16:18",
        "category": "",
        "description": null,
        "customer_id": 1001,
        "equipment_id": 1001,
        "staff": "",
        "attachment": "",
        "template": null,
        "script": null,
        "reference": "",
        "created": "2018-11-30 09:16:52",
        "is_available": 1
    }
}

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

调用接口：

属性	值
url	/api/exp/service/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.22.4. 添加service

调用接口：

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

请求参数：

字段	字段名称	字段类型	是否必传
service_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.22.5. 编辑service

调用接口：

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

请求参数：

字段	字段名称	字段类型	是否必传
service_id	服务标识	String	是
service_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.22.6. 删除service

调用接口：

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

请求参数：

字段	字段名称	字段类型	说明	是否必传
service_id	服务标识	String		是

返回参数：

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

返回示例：

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