Namron simplify
    Namron simplify
    • 设备与平台交互协议
    • App端接入注意事项
    • 设备属性
    • 设备类型
    • 公用
      • 发送Email验证码
        POST
    • SSE
      • SSE事件
      • 建立连接
        POST
      • 关闭连接
        DELETE
    • 账号
      • V1
        • 注册
        • 登入
        • 登出
        • 忘记密码
        • 修改密码
        • 删除账号
        • 查询账号信息
        • 修改账号信息
        • 刷新 access_token
        • 刷新 refresh_token
        • 第三方账号登录
      • V2
        • 查询账号信息
    • 天气
      • 天气预报
        GET
    • 家庭
      • 创建家庭
        POST
      • 修改家庭
        PUT
      • 删除家庭
        DELETE
      • 解绑家庭
        DELETE
      • 查询家庭列表
        GET
      • 查询家庭详情
        GET
      • 查询成员列表
        GET
      • 查询成员详情
        GET
      • 修改成员信息
        PUT
      • 删除成员
        DELETE
      • 查询成员码
        GET
      • 查询转移码
        GET
      • 查询家庭码详情
        GET
      • 加入家庭
        POST
      • 切换转移码状态
        PUT
      • 转移家庭
        PUT
      • 查询家庭的网关设备
        GET
      • Mesh 网络配置
        PUT
    • 楼层
      • 查询楼层列表
      • 创建楼层
      • 修改楼层
      • 删除楼层
    • 房间
      • V1
        • 创建房间
        • 修改房间
        • 删除房间
        • 查询房间列表
        • 查询房间详情
        • 置顶房间
        • 查询置顶的房间列表
        • 房间添加到文件夹
      • V2
        • 查询房间列表
        • 删除房间
    • 设备
      • v1
        • 查询设备列表
        • 查询设备详情
        • 查询设置品类
        • 绑定设备
        • 修改设备
        • 删除设备
        • 控制设备
        • 批量控制设备
        • 取消定时控制设备
        • 置顶设备
        • 查询置顶的设备列表
        • 查询设备电量列表
        • 查询设备告警日志记录
        • 修改设备显示状态
      • v2
        • 绑定设备
    • OTA
      • Ble本地升级(单个设备)
        • 查询可升级的固件
      • 设备联网升级
        • 单设备
          • OTA检查
          • OTA执行
        • 批量
          • OTA检查(按家庭)
          • OTA执行
    • 群组
      • 创建群组
      • 修改群组
      • 删除群组
      • 查询群组列表
      • 查询群组详情
      • 查询子设备型号列表
      • 查询可用的子设备型号列表
      • 群组属性上报
    • 模式
      • 查询模式列表
      • 查询模式详情
      • 创建模式
      • 修改模式
      • 删除模式
      • 执行模式
      • 置顶模式
      • 查询置顶的模式列表
    • 文件夹
      • 查询文件夹列表
      • 创建文件夹
      • 修改文件夹
      • 删除文件夹
    • 自动化
      • V1
        • 查询自动化列表
        • 查询自动化详情
        • 查询执行日志列表
        • 创建自动化
        • 修改自动化
        • 删除自动化
        • 执行自动化
      • V2
        • 查询自动化列表
    • Mesh 网络
      • 设备
        • 设备注册
        • 设备注册(批量)
        • 设备上报
        • 设备绑定网关
      • 群组
        • 创建 Mesh 群组
        • 修改 Mesh 群组
        • 删除 Mesh 群组
      • 模式
        • 创建 Mesh 模式
        • 修改 Mesh 模式
        • 删除 Mesh 模式
      • 自动化
        • 创建 Mesh 自动化
        • 修改 Mesh 自动化
        • 删除 Mesh 自动化
    • 推送消息
      • 查询消息列表
      • 设置 firebase token
    • 权限
      • 设置权限
    • 网关
      • 数据迁移
        • 是否允许数据迁移
    • 生物节律
      • 查询配置信息
      • 设置【设备】配置信息
      • 设置【规则】配置信息
      • 配置生效
    • 资源置顶
      • 置顶
      • 查询置顶的【设备】列表
      • 查询置顶的【房间】列表
    • 资源隐藏
      • 隐藏
      • 隐藏列表

    App端接入注意事项

    提示
    93f40546-aecb-4846-b3ce-d21434943de5.png
    所有接口的Request Headers都可带上Accept-Language,指定语言环境,缺省情况,默认为en-US
    除了公用模块,其他功能模块的接口都必须带上Authorization
    Authorization的值是登录API返回的access_token
    注意

    HTTP状态码说明#

    状态码原因
    200请求成功
    400请求失败
    401请求头缺少Token
    403权限不足
    404未找到资源
    405不允许的方法
    406非法请求
    409网关不在线
    410Token过期
    412Token无效
    417Token无法解析
    423已有OTA任务进行中,尚未完成
    429请求太频繁,QPS受限
    500服务器内部错误
    危险

    密码加密#

    涉及密码的API,提交的密码字段数据均使用AES-128-CBC加密,非明文传输。
    加密之后,把加密的数据再做一次Base64Encode
    KEY:gKoGGuPrteWD7xZs
    IV:NgHTKeYt1RvSR2Ie
    示例:
    明文 Abc123456789
    密文 7w0RBkpSyjpy1P0l9qVuOw==
    修改于 2025-06-19 09:47:57
    上一页
    设备与平台交互协议
    下一页
    设备属性
    Built with