V2.1 Get Product¶
Get the details of a product via its productKey
.
This API is available in EnOS 2.1.0 and above. Version 2.4 has been added and it is recommended to use V2.4 Get Product.
If you need to invoke this API after performing bulk updates to relevant products using other APIs, it is recommended to wait for about 2 seconds to avoid obtaining unupdated data.
Request Format¶
GET https://{apigw-address}/connect-service/v2.1/products?action=get
Request Parameters (URI)¶
Name |
Location (Path/Query) |
Mandatory/Optional |
Data Type |
Description |
---|---|---|---|---|
orgId |
Query |
Mandatory |
String |
The organization ID which the asset belongs to. How to get orgId>> |
productKey |
Query |
Mandatory |
String |
The product key. |
Response Parameters¶
Name |
Data Type |
Description |
---|---|---|
data |
Product Struct |
The details of the product. For more information, see Product Struct. |
Product Struct ¶
Name |
Data Type |
Description |
---|---|---|
orgId |
String |
The organization ID which the asset belongs to. |
productKey |
String |
The product key. |
productName |
StringI18n |
The product name. |
productSecret |
String |
The product private key. |
productDesc |
String |
The product description. |
productType |
String |
The product type. |
dataFormat |
String |
|
productTags |
Map |
The product tags. (The Key and Value are of String type.) |
protocolGatewayIds |
String |
The protocol gateway ID to which the asset is bound. |
modelId |
String |
The model ID which the asset belongs to. |
dynamicActiveEnabled |
Boolean |
|
biDirectionalAuth |
Boolean |
|
createTime |
Long |
The time the product is created. |
createBy |
String |
The name of the person who created the product. |
updateTime |
Long |
The time when the product was last updated. This will have the same value as |
updateBy |
String |
The name of the person who updated the product. |
defaultValidDay |
Integer |
Only applicable when |
maxValidDay |
Integer |
Only applicable when |
Error Codes¶
Code |
Message |
Description |
---|---|---|
11404 |
Product cannot be found |
The |
Samples¶
Request Sample¶
url: https://{apigw-address}/connect-service/v2.1/products?action=get&orgId=yourOrgId&productKey=yourProductKey
method: GET
Return Sample¶
{
"code":0,
"msg":"OK",
"requestId":"864291ce-ca48-457f-a790-a3415c0169ad",
"data":{
"orgId":"yourOrgId",
"productKey":"yourProductKey",
"productName":{
"defaultValue":"202cp",
"i18nValue":{
"en_US":"",
"zh_CN":""
}
},
"productSecret":"yourProductSecret",
"productDesc":"",
"productType":"Device",
"dataFormat":"Json",
"productTags":{},
"protocolGatewayIds":{},
"modelId":"202model",
"dynamicActivateEnabled":false,
"biDirectionalAuth":false,
"createBy":"DM001",
"createTime":1582861255508,
"updateBy":"DM001",
"updateTime":1582861255508,
"defaultValidDay":null,
"maxValidDay":null
}
}
SDK Samples¶
You can access the SDK samples for Connection Service on GitHub: