V2.1 Get Product¶

通过 productKey 获取产品的详细信息。

如果你在使用 API 批量更新相关产品信息后调用当前 API，建议两次调用间隔 2 秒左右，以免获取到未更新数据。

若当前 API 支持在 EnOS 2.1.0 及以上环境中使用，并已新增 V2.4 版本。推荐使用最新版本，参见 V2.4 Get Product。

操作权限¶

使用此 API 前，确保服务账号已被授予包含下列服务和操作权限的策略。有关授权服务账号的更多信息，参见管理服务账号。

需授权的服务	所需操作权限
产品	Read

请求格式¶

GET https://{apigw-address}/connect-service/v2.1/products?action=get

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织ID。如何获取 orgId 信息>>
productKey	Query	必需	String	产品的 Product Key。如何获取 productKey 信息>>

响应参数¶

名称	数据类型	描述
data	Product 结构体	产品的具体信息，见 Product 结构体。

Product 结构体¶

名称	数据类型	描述
orgId	String	资产所属的组织 ID。
productKey	String	产品的 Product Key。
productName	StringI18n	产品名称。结构参见国际化名称结构体。
productSecret	String	产品私钥。
productDesc	String	`true`：返回产品描述信息。 `false` （默认）：不返回产品描述信息。
productType	String	产品类型，`Device` 代表普通类型， `Gateway` 代表网关类型。
dataFormat	String	数据类型，`Custom` 代表用户自定义类型， `Json` 代表 JSON 类型。
productTags	Map（Key 和 Value 为 string）	产品标签。如何使用标签 >>
protocolGatewayIds	String	资产绑定的协议网关 ID。
modelId	String	资产所属模型 ID。如何获取 modelId 信息>>
dynamicActiveEnabled	Boolean	`true`：支持动态激活。 `false` （默认）：不支持动态激活。
biDirectionalAuth	Boolean	是否支持双向认证。``True``表示支持，``False``表示不支持。双向认证是通过 CA 证书机制对数据进行加密和解密的过程，确保在设备和云之间进行更安全的通信。更多信息，参见基于证书的双向认证。
createTime	Long	创建时间。
createBy	String	创建人。
updateTime	Long	更新时间。
updateBy	String	更新人。
defaultValidDay	Integer	仅当 `biDirectionalAuth` 为 `true` 时适用。此参数在该产品下的设备/网关申请证书时使用。当设备/网关申请证书但未指定有效期时，此参数将作为证书有效期。
maxValidDay	Integer	仅当 `biDirectionalAuth` 为 `true` 时适用。当该产品下的设备/网关申请证书时，作为设备/网关的最大证书有效期。

错误码¶

代码	错误信息	描述
11404	Product cannot be found	`productKey` 不存在。

示例¶

请求示例¶

url: https://{apigw-address}/connect-service/v2.1/products?action=get&orgId=yourOrgId&productKey=yourProductKey
method: GET

返回示例¶

{
    "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":null,
        "protocolGatewayIds":null,
        "modelId":"202model",
        "dynamicActivateEnabled":false,
        "biDirectionalAuth":false,
        "createBy":"DM001",
        "createTime":1582861255508,
        "updateBy":"DM001",
        "updateTime":1582861255508,
        "defaultValidDay":null,
        "maxValidDay":null
    }
}

SDK 示例¶

你可以在 Github 上获取接入服务的 SDK 示例：

Java
Python