Terms commonly used in these products are explained as follows:
Term | Definitions | Alias & Former Name |
---|---|---|
Product | It is a set of OneNET platform resources (e.g. devices, APIKeys, triggers and applications). One product corresponds to a unique masterkey, product ID, and device registration code, and contains multiple devices, which have the same features and are distinguished by unique SNs. | Item |
Product id | The pid is an authentication information groups and unique product identification code assigned by the platform to the created product. It is used to identify a unique product, as one of device login authentication parameters. | Item ID |
APIKey | It is an authentication parameter used to call APIs. Master-APIkey: the only APIKey with administrator authority under the product, which has the authority to manage all devices under the product. Device-APIkey: the device-level APIkey, which has the access authority for all associated devices. | |
accessKey | More secure access keys which are used as an implicit authentication parameter (indirect transmission) to access the platform. Access authentication is performed by participating in token calculation and transmission. | |
token | A more secure authentication parameter which is composed of multiple parameters and transmitted directly in the tunnel. | |
Registration code | It is the unique code under the product which can be used as one of the API authentication parameters for a real device to call the registered device | |
Device | It is classified under one product and the mapping of a real device on the platform. It is used to establish a connection to the real device through connection messages, as a minimum unit of platform resource allocation. | |
Authentication information group | It is the unique parameter set of the device in the platform, consisting of the device ID, product ID and device SN. The parameters are required for authentication during the connection of a real device (the parameters may vary depending on the device access protocol). | |
Device ID | It is an authentication information group assigned by the platform, and the unique identification code of the device within the platform. | |
SN | It is an authentication information group, and the unique serial number defined by the hardware manufacturer. It is used as a parameter of the device created/registered, which is unique and taken as one authentication parameter during device connection. | auth_info Device ID |
Data stream | It is a device attribute, which can be used as an individual data attribute of the device, such as the temperature = 10, or a combination of device data attributes, such as coordinates = x:10 y:20. | |
Data stream template | It is an attribute of the collected data of all devices under the product such as the “PH2.5”, “formaldehyde concentration” and others reported by the air quality tester. | |
Data point | Data that a device uploads to the data stream every time. | |
Script | The platform supports user-defined data analysis rules to analyze binary/string data (only applicable to TCP + script access). |