setMessageCallback（设置报警回调地址）

setMessageCallback：设置报警回调地址

要点：https://openapi.lechange.cn/openapi/setMessageCallback · 见错误码

设置开发者账号的消息回调地址。

请求参数

参数名	参数类型	是否必填	默认值	合法值	参数说明
token	String	是			管理员accessToken
status	String	是		"on","off"	是否订阅消息
callbackUrl	String	否	""	消息回调URL status为on时，必填;status为off时，可为空;	开发者接收设备消息的地址，需要可以被外网访问
callbackFlag	String	否	""	alarm、deviceStatus、iot、numberstat、faceAnalysis、capabilityEvent、transfer、rtFace、intelliAnalysis（逗号组合，含义见事件消息类型）	回调大类白名单；订阅标准能力变更须含 capabilityEvent。status 为 on 时必填；off 时可空。
callbackAuth	String	否	""	yes / no	是否对回调 URL 做鉴权校验；传非空时按平台规则校验
basePush	String	否	"2"	"1"：推送；"2"：不推送	标示开发者账号下关联的乐橙APP设备消息是否推送

备注：callbackFlag代表的是事件消息大类，具体的类型定义参考事件消息类型定义

请求示例

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time":1603350639,
        "nonce":"350f4c7a-a352-46cf-ae03-f4f526f5d99f"
    },
    "id":"b8f45dbb-79ad-4a7e-8b24-7eb618c5191f",
    "params":{
        "callbackFlag":"alarm,deviceStatus",
        "basePush":"2",
        "callbackUrl":"https://www.baidu.com",
        "token": "<yourAccessToken>",
        "status":"on"
    }
}

响应字段

无data数据返回

响应示例

{
    "id":"b8f45dbb-79ad-4a7e-8b24-7eb618c5191f",
    "result":{
        "code":"0",
        "msg":"操作成功"
    }
}

错误码

本接口可能返回下列码；完整分组见错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 token
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1039`	分钟级限流	等到下一分钟再试
`OP1040`	调用超限	降低频率
`DV1007`	设备离线或超时	等设备上线

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`	子账号无指定权限	在子账号策略中补权限
`SUB1002`	子账号无任何设备权限	授权设备或调整策略
`SUB1005`	子账号 token 过期	重新获取子账号 token
`SUB1006`	子账号与设备无授权关系	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定当前应用	先创建并绑定子账号
`SUB1007`	创建子账号失败	核对参数后重试
`SUB1009`	子账号创建失败，账号格式错误	`account` 须为手机号或邮箱
`SUB1010`	子账号创建失败，账号已存在	勿重复绑定同一子账号到应用

更多见错误码 · SUB。

说明

仅支持管理员 accessToken；子账号不可调用本接口。

status=on 时平台会对 callbackUrl 探活：须接受 POST、Content-Type: application/json、body {}，并返回 2xx。不支持仅 GET 或 302 跳转，否则可能 PARAM_ILLEGAL_VALUE。步骤见配置平台消息推送。