You need to enable JavaScript to run this app.
文档中心
云原生消息引擎

云原生消息引擎

请输入
  • 文档首页
    • 云原生消息引擎MQTT 实例用户指南API 参考MQTT密钥RegisterDeviceCredential - 注册 MQTT 用户设备访问凭证
复制全文
下载 pdf
我的收藏
MQTT密钥
RegisterDeviceCredential - 注册 MQTT 用户设备访问凭证
复制全文
下载 pdf
我的收藏
RegisterDeviceCredential - 注册 MQTT 用户设备访问凭证
调用 RegisterDeviceCredential 接口，注册 MQTT 用户设备访问凭证。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值：RegisterDeviceCredential​
要执行的操作，取值：RegisterDeviceCredential。​
​
Version string 必选 示例值：2024-09-01​
API 的版本，取值：2024-09-01。​
​
InstanceId string 必选 示例值：mqtt-***​
MQTT 实例 ID。​
​
ClientId string 必选 示例值：cid****​
设备的 ClientID。​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
InstanceId string 示例值：mqtt-***​
MQTT 实例 ID。​
​
ClientId string 示例值：cid***​
设备的 ClientID。​
​
UpdateTime long 示例值：1746685669000​
更新时间。​
​
CreateTime long 示例值：1746685669000​
创建时间。​
​
DeviceAccessKeyId string 示例值：ddx.2xxs​
设备的 AccessKeyID。​
​
DeviceAccessKeySecret string 示例值：Ax.exxdd​
设备的 AccessKey Secret。​
​
​
请求示例​
​
POST /?Action=RegisterDeviceCredential&Version=2024-09-01 HTTP/1.1​
Host: bmq.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260324T023332Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260324/cn-beijing/bmq/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"InstanceId": "mqtt-***",​
"ClientId": "cid****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "2026032410335****0691131C9878",​
"Action": "RegisterDeviceCredential",​
"Version": "2024-09-01",​
"Service": "bmq",​
"Region": "cn-beijing"​
},​
"Result": {​
"InstanceId": "mqtt-***",​
"ClientId": "cid***",​
"UpdateTime": 1746685669000,​
"CreateTime": 1746685669000,​
"DeviceAccessKeyId": "ddx.2xxs",​
"DeviceAccessKeySecret": "Ax.exxdd"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
200​
InternalServiceError​
internal service error, please contact with admin​
内部服务错误，请联系技术支持或提交工单。​
200​
InvalidParameter​
parameter is invalid, pls check parameters​
参数值无效。​
200​
ParameterEncodingError​
Failure encoding object into query map​
参数编码异常，请联系技术支持或提交工单。​
200​
Unauthorized​
authorized error​
授权错误，请授权或切换账号后重试。​
400​
ClientDuplicated​
client GID_android_rw@@@246289e8-a06c-9761-db76-077c89460c54 exists​
客户端已存在。​
​
​
最近更新时间：2026.03.24 10:50:06
这个页面对您有帮助吗？
有用
有用
无用
无用