Swiniot
  1. API LIST
  • Swiniot Open Platform
    • API LIST
      • Token Acquisition and Usage Guide
      • Electricity Meter API
        • Query total electricity meter count
        • Query single electricity meter information
        • Query electricity meter recharge records
        • Query electricity consumption of a single meter
        • Query all electricity meter information
        • Query three-phase meter voltage, current, and power
        • Bind electricity meter
        • Unbind electricity meter
        • Electricity meter recharge
        • Electricity meter reading reset
        • Electricity meter switch
        • Set electricity price
        • Switch electricity meter payment mode
        • Electricity meter operation log
        • Bluetooth switch
        • Bluetooth switch - response
        • Bluetooth meter reading
        • Bluetooth meter reading - response
        • Bluetooth recharge
        • Bluetooth recharge - response
      • Water Meter API
        • Water meter recharge - Bluetooth
        • Water meter recharge - Bluetooth -response
        • Query total water meter count
        • Query single water meter information
        • Query water meter recharge records
        • Query water consumption of a single water meter
        • Batch query all water meter information
        • Add water meter
        • Water meter reading reset
        • Water meter operation log
        • Water meter recharge
        • Modify water price
        • Modify water meter payment mode
        • Valve-controlled water meter open/close valve
      • Super Gateway Door Lock API
        • Door Lock Command Dispatch
          • Door lock Bluetooth initialization command
          • Add, edit, or delete landlord password (only one password allowed)
          • Add, edit, or delete tenant password (only one password allowed)
          • Open door
          • Call the disconnect remote command before connecting via Bluetooth. Otherwise, the Bluetooth connection will fail.
          • Unbind door lock
          • Door card operations (add, delete, etc.)
          • Fingerprint operations (add, delete, etc.)
        • Door Lock Callback Commands
          • Door lock initialization callback API
          • API to call after door lock initialization is complete
          • Landlord password add, delete, or update callback API
          • Tenant password add, delete, or update callback API
          • Open door callback
          • Door lock unbind callback API
          • Door card Bluetooth callback API
          • Fingerprint Bluetooth callback API
        • Door lock list
  1. API LIST

Token Acquisition and Usage Guide

This document is intended for developers and product managers involved in project integration.
Before beginning development, you must request account credentials from your integration contact. Use these credentials to obtain an access token. The token is valid for 30 days. The token acquisition endpoint has a rate limit of 1 request per 30 seconds. If the limit is exceeded, you must wait 30 seconds before retrying.
The platform APIs support querying data including electricity meter count, meter basic information, meter remaining balance, meter pricing, meter power consumption, meter recharge records, water meter basic information, water meter consumption, water meter recharge records, and more. Device control APIs for electricity and water meters are also available.
Base API URL: https://api.swiniot.com
Request method: GET
Token acquisition endpoint:
https://api.swiniot.com/open/api/getToken/{username}/{password}/{secret}
After obtaining the token, all subsequent GET requests must include an Authorization header field with the token value.
Example — querying the total electricity meter count:
image.png
Modified at 2026-06-12 08:03:20
Next
Query total electricity meter count
Built with