# CreateProductTopic
调用该接口为指定产品创建自定义Topic类。
# 请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateProductTopic | 系统规定参数。取值:CreateProductTopic。 |
| Operation | String | 是 | PUB | 设备对该Topic类的操作权限,取值:PUB:发布。SUB:订阅。 |
| ProductKey | String | 是 | aldDEin**** | 要创建Topic类所属产品的ProductKey。 |
| TopicShortName | String | 是 | resubmit | 设置Topic类的自定义类目名称。Topic格式必须以/进行分层,区分每个类目。类目命名只能包含字母、数字和下划线(_),每级类目不能为空。自定义Topic类前三个类目已固定为/${productKey}/${deviceName}/user/,定义TopicShortName将Topic类填充完整。 |
| IotInstanceId | String | 是 | 6912917943269**** | 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。 |
| Desc | String | 否 | submit a test topic | Topic类的描述信息。长度限制为100字符(一个汉字占一个字符)。 |
# 返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | iot.system.SystemException | 调用失败时,返回的错误码。 |
| ErrorMessage | String | 系统异常 | 调用失败时,返回的出错信息。 |
| RequestId | String | olmM8Mc9H3DcP7y4kGswzCG6lKHSAndq | 平台为该请求生成的唯一标识符。 |
| Success | Boolean | true | 是否调用成功。 true:表示调用成功。 false:表示调用失败。 |
| TopicId | String | 7228157********* | 调用成功时,物联网平台为新建的Topic类生成的Topic ID。 |
# 示例
请求示例
http://open.${区域}.fenydata.com/fenydata-java-open/?Action=CreateProductTopic
&ProductKey=aldDEin****
&TopicShortName=submit
&Operation=PUB
&Desc=submit a test topic
&<公共请求参数>
正常返回示例
XML格式
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
<RequestId>FCC27691-9151-4B93-9622-9C90F30542EC</RequestId>
<Success>true</Success>
<TopicId>7228157*********</TopicId>
</xml>
JSON格式
{
"RequestId": "FCC27691-9151-4B93-9622-9C90F30542EC",
"Success": true,
"TopicId": "7228157*********"
}
← 修改服务端订阅 删除自定义Topic →