You need to enable JavaScript to run this app.
文档中心
证书中心

证书中心

复制全文
下载 pdf
信息模板管理
CertificateAddOrganization - 创建信息模板
复制全文
下载 pdf
CertificateAddOrganization - 创建信息模板
调用本接口创建一个信息模板。​
注意事项​
每个租户可以同时拥有最多200个信息模板(涵盖企业和个人类型的信息模板)。​
请求说明​
请求频率:同一个租户每秒最多允许请求20次。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Query​
Action string 必选 示例值:CertificateAddOrganization​
要执行的操作,取值:CertificateAddOrganization。​
​
Version string 必选 示例值:2024-10-01​
API的版本,取值:2024-10-01。​
​
​
​
Body​
Type string 必选 示例值:Enterprise​
要创建的信息模板的类型。该参数有以下取值:​
  • Individual:个人类型模板,只能用于申请 DV 证书​
  • Enterprise:企业类型模板,可用于申请 DV、OV、EV 证书​
​
Tag string 必选 示例值:doc-test​
设置信息模板的名称。​
​
Name string 可选 示例值:测试企业​
设置企业名称。​
当 Type 为 Enterprise 时,该参数必填。​
​
Address string 可选 示例值:北京市海淀区某街道某号​
设置企业地址。​
当 Type 为 Enterprise 时,该参数必填。​
​
City string 可选 示例值:北京​
设置企业所在城市。​
当 Type 为 Enterprise 时,该参数必填。​
​
Province string 可选 示例值:北京​
设置企业所在省级行政区或州。​
当 Type 为 Enterprise 时,该参数必填。​
​
Country string 可选 示例值:CN​
设置企业所属国家的两位字母代码,如CN表示中国、US表示美国。​
当 Type 为 Enterprise 时,该参数必填。​
​
PostalCode string 可选 示例值:100080​
设置企业所在地的邮政编码。(仅适用于企业位于中国内地的情形。)​
​
Department string 可选 示例值:系统部​
设置企业部门。​
​
Email string 可选 示例值:doc-test@example.com​
设置企业邮箱。​
​
BusinessLicenseNo string 可选 示例值:11100000000000000R​
设置企业统一社会信用代码。​
​
Contact object 必选 示例值:​
设置证书联系人信息。​
FirstName string 必选 示例值:三​
联系人名字。​
​
LastName string 必选 示例值:张​
联系人姓氏。​
​
Email string 必选 示例值:zhangsan@example.com​
联系人邮箱。​
​
Phone string 必选 示例值:13111111111​
联系人电话号码。​
​
IdCardNo string 可选 示例值:310000202010202020​
联系人身份证号。​
​
​
ProjectName string 可选 示例值:default​
设置信息模板所属火山引擎项目的名称。​
若未指定该参数,则信息模板将被添加到 default 项目。​
​
Tags object[] 可选 示例值:[{"Key":"env","Value":"test"}]​
信息模板绑定的资源标签列表。每个元素为一组标签键值对,用于对信息模板进行分类和管理。​
Key string 必选 示例值:env​
标签键。​
​
Value string 必选 示例值:test​
标签值。​
​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
OrganizationId string 示例值:org-879f6502723b4e0f8762cf3528f4****``​
证书中心为您创建的信息模板生成的ID。​
​
​
​
请求示例​
​
POST /?Action=CertificateAddOrganization&Version=2024-10-01 HTTP/1.1​
Host: certificate-service.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260511T024616Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260511/cn-beijing/certificate_service/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"Type": "Enterprise",​
"Tag": "doc-test",​
"Name": "测试企业",​
"Address": "北京市海淀区某街道某号",​
"City": "北京",​
"Province": "北京",​
"Country": "CN",​
"PostalCode": "100080",​
"Department": "系统部",​
"Email": "doc-test@example.com",​
"BusinessLicenseNo": "11100000000000000R",​
"Contact": {​
"FirstName": "三",​
"LastName": "张",​
"Email": "zhangsan@example.com",​
"Phone": "13111111111",​
"IdCardNo": "310000202010202020"​
},​
"ProjectName": "default",​
"Tags": [​
{​
"Key": "env",​
"Value": "test"​
}​
]​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260511104655071000045218CCD386",​
"Action": "CertificateAddOrganization",​
"Version": "2024-10-01",​
"Service": "certificate_service",​
"Region": "cn-beijing"​
},​
"Result": {​
"OrganizationId": "`org-879f6502723b4e0f8762cf3528f4****`"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidParameter​
The specified parameter %s is invalid.​
指定的参数值无效。​
400​
MissingParameter​
The required parameter %s is missing.​
缺少必填参数。​
400​
QuotaExceeded​
%s has exceeded the quota. example: The memory size of the specified disk has exceeded the quota.​
资源超出配额限制。​
400​
NotFound.Project​
The specified project is not found​
未找到指定的项目。​
500​
InternalError​
The request has failed due to an unknown error.​
未知错误。​
​
​
最近更新时间:2026.05.11 11:17:46
这个页面对您有帮助吗?
有用
有用
无用
无用