创建GB28181凭证

最近更新时间:2026-03-19 18:16:28

天翼云智能视图服务API

1.创建GB28181凭证

接口功能介绍

本接口用于创建GB28181凭证,该凭证用于GB28181设备注册。

接口约束

URI

POST /gb28181Certs

路径参数

Query参数

请求参数

请求头header参数

参数是否必填参数类型说明示例下级对象
AuthorizationString认证信息。CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-TypeString互联网媒体类型。application/json;charset=utf-8
HostString主机。vssapi.ctyun.cn
VersionString版本。2021-11-25
TimestampString时间戳。1689643309

请求体body参数

参数是否必填参数类型说明示例下级对象
UserNameString凭证用户名,长度1-64位,仅支持输入小写字母和数字。cert
PasswordString凭证密码,凭证密码长度为8位~32位的字符串,至少包含以下三种字符:大写字母、小写字母、数字和特殊字符(@#_-*)。qwER1234
DescriptionString凭证描述。cert

响应参数

参数参数类型说明示例下级对象
statusCodeInteger响应状态码。200
errorString错误码,执行成功时,不返回该字段。VSS_0001
messageString响应信息。请求成功
requestIdString请求ID。362d4e78556b47129182d0881fade86b
returnObjObject响应数据,执行失败时,不返回该字段。returnObj

表 returnObj

参数参数类型说明示例下级对象
UserNameString凭证用户名。cert
UserTypeString凭证类型。normal
DescriptionString凭证描述。描述
CreatedTimeString凭证创建时间。1681370054428110
UpdatedTimeString凭证更新时间。1681370054428110
RequestIdString请求ID。64c9f09a7d434519abbcdd5e20620732

请求示例

请求url

POST '/gb28181Certs'

请求头header

{
    "Authorization": "CT-HMAC-SHA256 Credential=DS6X6E782JHKU7KHHMSH/2023-04-13/vss, SignedHeaders=content-type;host;timestamp, Signature=5131b2a142fca37d0ede208122a5183c32a466296df265609aac653221e00e71",
    "Content-Type": "application/json;charset=utf-8",
    "Host": "vssapi.ctyun.cn",
    "Version": "2021-11-25",
    "Timestamp": "1681369836"
}

请求体body

{
  "UserName":"openapi01",
  "Password":"********"
}

响应示例

{
  "statusCode": 200,
  "message": "请求成功",
  "requestId": "64c9f09a7d434519abbcdd5e20620732",
  "returnObj": {
    "UserName": "openapi01",
    "UserType": "normal",
    "Description": "",
    "CreatedTime": "1681370054428110",
    "UpdatedTime": "1681370054428110",
    "RequestId": "64c9f09a7d434519abbcdd5e20620732"
  }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。