CertificateUpdateOrganization - 更新信息模板--证书中心-火山引擎

文档中心

立即注册

导航

CertificateUpdateOrganization - 更新信息模板

最近更新时间：2025.01.10 11:56:51首次发布时间：2024.11.13 19:44:18

调用本接口更新指定信息模板的内容。

请求说明

请求频率：同一个租户每秒最多允许请求20次。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	CertificateUpdateOrganization	要执行的操作，取值：CertificateUpdateOrganization。
Version	String	是	2024-10-01	API的版本，取值：2024-10-01。

Body

参数	类型	是否必填	示例值	描述
Contact	Object	否		联系人信息。
OrganizationId	String	是	org-879f6502723b4e0f8762cf3528f4****	要更新的信息模板的ID。您可以调用CertificateGetOrganizationList接口获取所有信息模板的ID。
Type	String	否	Enterprise	设置信息模板的类型。该参数有以下取值： `Individual`：个人类型模板。 `Enterprise`：企业类型模板。
Tag	String	否	doc-test	设置信息模板的名称。
Name	String	否	测试企业	设置企业名称。当 Type 为 `Enterprise` 时，该参数必填。
Address	String	否	北京市海淀区某街道某号	设置企业地址。当 Type 为 `Enterprise` 时，该参数必填。
City	String	否	北京	设置企业所在城市。当 Type 为 `Enterprise` 时，该参数必填。
Province	String	否	北京	设置企业所在省份或州。当 Type 为 `Enterprise` 时，该参数必填。
Country	String	否	CN	设置企业所属国家的 ISO 3166-1 代码。当 Type 为 `Enterprise` 时，该参数必填。
PostalCode	String	否	100080	设置企业所在地的邮政编码。（仅适用于中国地区。）
Department	String	否	系统部	设置企业部门。
Email	String	否	doc-test@example.com	设置企业邮箱。
BusinessLicenseNo	String	否	11100000000000000R	设置企业统一社会信用代码。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=CertificateUpdateOrganization&Version=2024-10-01 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241031T060232Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241031/cn-beijing/certificate_service/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
    "OrganizationId": "org-879f6502723b4e0f8762cf3528f4****",
    "Type": "Enterprise",
    "Tag": "doc-test-updated",
    "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"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20241108170306E25CAC3871567504CDEF",
        "Action": "CertificateUpdateOrganization",
        "Version": "2024-10-01",
        "Service": "certificate_service",
        "Region": "cn-beijing"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The required parameter %s is missing.	缺少必填参数。
400	InvalidParameter	The specified parameter %s is invalid.	指定的参数值无效。
400	MalformedRequest	The request is malformed	请求参数格式不合法。
400	SystemBusy	The system is busy. Please try again later.	系统繁忙，请稍后重试。
400	NotFound. InformationTemplate	The specified information template is not found	指定的信息模板不存在。
500	InternalError	The request has failed due to an unknown error.	未知错误。