Shulou(Shulou.com)06/01 Report--

This article introduces the relevant knowledge of "what are the knowledge points of the interface list of the Internet of things". In the operation of actual cases, many people will encounter such a dilemma. Next, let the editor lead you to learn how to deal with these situations. I hope you can read it carefully and be able to achieve something!

Interface list and interface description

Authorization management

Get access tokens: developers obtain tokens by creating the corresponding authorization credentials for cloud applications on the development platform.

Refresh user tokens: for security reasons, each OAuth token is currently valid for two hours, and you need to use refresh_token in exchange for a new token when it expires.

Note: access_token has a time limit and no number of times, while refresh_token has no time limit, but can only take effect once.

Login-free token: generate a login-free token based on the graffiti user uid, which is required for some scenarios or API APIs to make requests.

User management

Synchronization users: this API is an account synchronization API. You can create accounts and modify account information according to different parameters according to your own business scenarios.

If the same user name is passed in under the same application, the last user information of the user will be updated.

For direct use in graffiti OEM App, OEM App only supports mobile phone number and email address, and the password hash rule is MD5 algorithm.

Get user list: the user data associated with the application you created on the graffiti IoT platform can be pulled through this API. Considering the user's privacy security, the user's personal privacy field will be encrypted.

Get user information: used to get user information.

Distribution network management: with the improvement of product distribution network richness, the cloud development platform iterates over the mainstream distribution network capabilities and provides rights management interfaces to meet the requirements of different distribution network modes, such as Wi-Fi distribution network, Bluetooth distribution network, Bluetooth + Wi-Fi dual-mode distribution network and so on.

Generate distribution network token: before discovering a device, you need to apply for a temporary token. After graffiti client SDK is used for distribution network, the device can automatically complete the discovery and account binding after receiving the distribution network token. Currently, Wi-Fi distribution network and BLE + Wi-Fi distribution network are supported, and more capabilities are being continuously expanded (BLE equipment needs to scan the device QR code to obtain the only ID for the distribution network).

Polling distribution network result: since the device distribution network is an asynchronous process, the time for a device to successfully join the network varies according to the network quality. Therefore, developers are required to poll the API until the device list is queried or stop polling when the timeout occurs (the polling period is once per second, and the timeout period is recommended to be 100 seconds).

Open gateway allows sub-devices to enter the network: because sub-devices do not have direct networking capability, adding sub-devices requires a gateway to join. After the gateway enters the allowed state, the sub-devices can join the local network of the gateway and complete the storage through the gateway.

Get the list of sub-devices entering the network: sub-device distribution network is an asynchronous process, and sub-devices will be added to the gateway according to the number of devices and network conditions. Therefore, you need to poll this API to obtain the list of sub-devices according to the initial discovery time. Combined with your own business end discovery process, it is recommended that you poll each time for 1 second to 100 seconds.

Get the list of sub-devices under the gateway: obtain the list of sub-devices through the gateway device ID.

Equipment control

Get instruction set (by category): query the instruction set by category. This instruction set is the richest instruction set under the graffiti public domain category and can be used by developers. If you are a platform class developer, it is recommended to follow this category for development and docking.

Get instruction set (by device): query the functions supported by the device, and the obtained instructions can be used to issue control.

Get device specification attributes (including instruction set, state set): get the instruction set and state set supported by the device according to the device ID.

Issuing device instructions: according to the obtained instruction set, it can be issued according to one or more sets of instructions, and whether multiple instructions can be executed at the same time depends on the specific product.

Get the latest status of the device: query the latest status of the device according to the device ID.

Timing management

Add scheduled tasks to the device: this interface adds scheduled tasks to the device. Through the parameter loops, it can be divided into cyclic timing task and non-cyclic timing task.

Cycle timing: cycle timing can be set from Monday to Sunday with a cycle of one week.

Non-cyclic timing: set the timing task of the specified time node, and the interface will limit the set time node. The time node needs to be after the current time, otherwise the scheduled task cannot be created and prompted that the scheduled task has expired.

Query the list of scheduled tasks under the device: this API is used to query the detailed list of scheduled tasks added under the specified device ID.

Get the scheduled task information of a category under a device: this API is used to obtain the scheduled task information of a category under a specified device.

Update the information of a scheduled task group of a device: this interface is used to update the information of a scheduled task group of the device.

Update / get the status of the device timing task group: this API is used to update / obtain the status of the device timing task group.

Create / update group timing tasks: this API is used to create / update group timing tasks.

Whole house management

Add a family: add a family and a room under the family to the family.

Modify family: modify basic family information.

Delete / query families: delete / query families based on family ID.

Query the details of the devices under the home: query the list of devices under the home according to the home ID.

Add rooms: add rooms according to family ID

Modify / delete / query rooms: modify / delete / query rooms according to family ID and room ID.

Add family members: add family members to a family.

Set member permissions: set administrator and non-administrator role permissions for family members, and modify the names of family members.

Delete / query family members: delete / query a family member.

Query the list of households: query the list of households according to uid.

Query / add / modify / delete the equipment in the room under the family: query / add / modify / delete the equipment in the room under the family.

Scene automation

Query the list of scenarios under the family: query the list of scenarios under the family.

Query the default scene picture list: query the default scene image list.

Trigger / add / delete / modify scene: trigger to hold / add / delete / modify a scene in a row.

Query the list of devices that support scenarios in the home: query the list of devices that support scenarios in the home.

Scene binding / binding: the API is mainly suitable for scene switchgear. The scene switch has a corresponding switch button, and each switch button has a corresponding instruction. Through this API, you can bind the specified switch instruction to the scene, that is, the scene switch is associated with the scene. After the binding is successful, the scenario can be triggered directly by issuing instructions to the API.

Scene unbinding: the API is mainly suitable for scene switches. After a switch in the scene switch is bound to the specified scene, it can be unbound through this API.

Query the list of scenarios where devices have been bound: the API is mainly applicable to scene switches. Query the list of scenes associated with the scene switch device ID.

Add / modify / remove Automation: add / modify / remove Automation features for your home.

Query automation list: query automation list.

Query single automation: query a single automation scenario in the home.

Trigger the external conditions of automation: trigger the external conditions of the automation scene in the home.

Query the list of devices that support automation scenarios: query the list of devices that support automation scenarios in your home.

Query the weather conditions supported by automation scenarios: query the weather conditions supported by automation.

Get the linkage condition of family support: obtain the standard function point of linkage condition or action according to the family ID.

Get the linkage condition supported by the device: obtain the standard function point of the linkage condition or action according to the device ID.

Enable / deactivate automation: enable / deactivate automation scenarios.

Data service

Get an overview of the data: get an overview of the data.

Statistics of App daily registered users: statistics of App daily registered users.

Statistics of daily active users of App: statistics of daily active users of App.

Get App device data profile: get App device data overview.

Get the general overview of the equipment: get the general overview of the equipment.

Obtain the regional distribution data of active equipment: obtain the regional distribution data of active equipment.

Obtain activation device regional distribution detail data: obtain activation device regional distribution detail data.

Statistics of equipment daily active users / activation / co-activation data: statistics of equipment daily active users / activation / co-activation data.

Get device active data profile: get device active data overview.

Get historical cumulative value: get historical cumulative value.

Get the statistical types supported by the device: query the statistical types currently supported by the device.

Statistics by hour / day / week / month: returns the statistics of the equipment for nearly 7 days in the unit of hour / day / week / month.

Weather service

Query city list: get information about the cities that support weather data in the country according to the country code.

Query city information: query city information according to city ID.

Query city list according to longitude and latitude: query city list according to longitude and latitude.

Query city weather forecast: query the weather forecast according to the city ID.

Query the weather forecast according to IP: query the weather forecast according to the city IP.

Query the weather according to longitude and latitude: query the weather information of the city according to the longitude and latitude of the city.

Query the current weather conditions of the city: query the weather conditions of the city on the same day according to the city ID.

Equipment management

Get device details: you can query the details of the device, including device properties and the latest status of the device.

Get the list of devices under the user: you can query the list of devices that can be operated under the user, including device attributes and the latest status of the device.

Get device list: provides the ability to query device list by application, product and device ID. When calling this API, it is recommended to select one of the three request parameters. If the data permission dimension meets any of the following, the relevant device data can be obtained:

Application dimension: the application dimension is for equipment buyers. Device purchasers obtain device data by binding applications (OEM App created on the graffiti platform or graffiti-based client SDK developed by themselves) to the device.

Product dimension: the product dimension is for equipment manufacturers. The manufacturer creates the product on the graffiti platform, and then produces the equipment based on this product (the device is connected to the graffiti cloud), and finally obtains or controls the data of the equipment produced by the manufacturer.

Modify the function point name: to meet the multi-channel sub-device, you can modify the sub-device name.

Query device log: query device operation history according to query conditions.

Restore the factory settings of the device: restore the factory settings according to the device ID.

Remove device: remove the device according to the device ID.

Query the device list under the gateway: query the device list under the gateway.

Query equipment ex-factory information: query equipment ex-factory information.

Modify device name: modify the device name.

Modify multi-channel name: it can be modified when there is a multi-channel name of the device, and now supports plug-in devices.

OTA upgrade

Get the upgrade information of the device: get the upgrade information of the device.

Confirm equipment upgrade: confirm equipment upgrade.

Equipment group

Query device group list

Query group details

Query group list

Create a device group

Modify group grouping

Delete a group group

Send instructions to the equipment group

This is the end of the content of "what are the knowledge points of the interface list of the Internet of things"? thank you for your reading. If you want to know more about the industry, you can follow the website, the editor will output more high-quality practical articles for you!

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.