Swiniot API document
  1. API LIST
  • SwinIot
    • API LIST
      • token获取及使用说明
      • 电表接口
        • 查询电表总数
        • 查询单个电表的信息
        • 查询电表的充值记录
        • 查询单个电表的用电量
        • 查询所有电表信息
        • 查询三相电表电压电流功率
        • 电表绑定
        • 电表解绑
        • 电表充值
        • 电表清零
        • 电表开关
        • 设置电价
        • 电表切换付费模式
        • 电表操作日志
        • 蓝牙开关
        • 蓝牙开关-应答
        • 蓝牙抄表
        • 蓝牙抄表-应答
        • 蓝牙充值
        • 蓝牙充值-应答
      • 水表接口
        • 查询水表总数
        • 查询单个水表信息
        • 查询水表的充值记录
        • 查询单个水表的用水量
        • 批量查询所有水表信息
        • 添加水表
        • 水表清零
        • 水表操作日志
        • 水表充值
        • 修改水费单价
        • 修改水表付费模式
        • 阀控水表开合闸
      • 超级网关门锁接口
        • 门锁发送指令
          • 门锁蓝牙初始化指令
          • 房东密码添加,编辑， 删除（只能添加一个）
          • 租客密码添加,编辑， 删除（只能添加一个）
          • 开门
          • 链接蓝牙先调一下断远程的指令。 否则会链接不上蓝牙
          • 门锁解绑
          • 门卡系列（初始化添加， 删除 等等）
          • 指纹系列（初始化添加， 删除 等等）
        • 门锁回调指令
          • 门锁初始化回调接口
          • 门锁初始化完成后调的一个接口
          • 房东添加， 删除 ， 修改密码 回调接口
          • 租客添加， 删除 ， 修改密码 回调接口 Copy
          • 开门回调
          • 门锁解绑回调接口
          • 门卡蓝牙 回调接口
          • 指纹蓝牙 回调接口
        • 门锁列表
  1. API LIST

token获取及使用说明

本文档设计使用用户为项目对接的开发人员和产品经理。
项目对接开发前，你需要向对接人员申请获取账户密钥。通过密钥可获取访问token，token的有效期为30天，获取token接口的访问频率为30秒/次，超过次数后需等候30秒再继续访问。
平台接口支持查询电表数量、电表基本信息、电表余量、电表电价、电表用电量、电表充值记录、水表基本信息、水表用水量、水表的充值记录等数据，同时开放使用电表和水表的设备控制类接口。
统一接口前缀地址为：https://api.swiniot.com
统一请求方式：GET
获取token接口：https://api.swiniot.com/open/api/getToken/账户名/密码/密钥
获取到token后，后续所有接口的get请求，需要在请求的header中添加Authorization字段，值为token的值。
以请求查询电表总数接口为例，请求如下：
image.png
Modified at 2026-05-20 06:06:47
Next
查询电表总数
Built with