CodeSignCertificateQuickPlaceOrder - 快速购买代码签名证书--证书中心-火山引擎

文档中心

证书中心

API参考

CodeSignCertificateQuickPlaceOrder - 快速购买代码签名证书

调用本接口购买代码签名证书。

使用说明

购买成功后，系统会创建代码签名证书实例，DigiCert 会在验证开发者身份后签发证书。证书签发后，您将收到一个 Ukey（硬件令牌），该设备用于安全存储代码签名证书私钥，是执行代码签名的必要硬件。Ukey 将邮寄到您指定的收件地址。

注意事项

请确保您的火山引擎账户有充足的余额。如果账户余额不足以抵扣代码签名证书订单的费用，那么订单将无法创建。

请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必填	示例值	描述
City	String	是	Beijing	城市（L）。
CommonName	String	是	测试企业	证书签发的主体名称，即组织或企业名称。
ContactEmail	String	是	zhangsan@example.com	联系人邮箱。用于接收证书申请进度通知及验证邮件，务必填写有效邮箱。
ContactName	String	是	SanZhang	联系人姓名。证书申请人的真实姓名。
ContactPhone	String	是	+86-13800000000	联系人电话。用于证书申请过程中的身份验证和沟通。
Country	String	是	CN	国家代码。申请人所在国家，通常使用 ISO 3166-1 标准代码（如 CN 代表中国）。
Name	String	是	MyCodeSignCert	证书备注名称。
Period	Integer	是	365	证书服务的时长。单位：天。
Plan	String	是	digicert_code_signing_ov_1	指定您希望订购的代码签名证书的规格。证书规格采用以下格式：`<品牌>_<域名类型>_<证书类型>`。 `Plan`参数有以下取值： digicert_code_signing_ov_1：OV（组织验证） digicert_code_signing_ev_1：EV（扩展验证）
PostalCode	String	否	100000	邮政编码。
Project	String	是	default	指定证书归属的火山引擎项目的名称。如果不设置该参数，证书将归属到`default`项目。项目是火山引擎提供的一种资源管理工具。您可以使用项目对资源进行分组。更多信息，请参见使用“项目”管理证书中心资源。
Province	String	是	Beijing	省份或州（ST）。
ShippingAddr	String	是	北京市海淀区XX路XX号	收件地址。证书物理介质 Ukey（硬件令牌）的邮寄地址，需填写详细的收件地址。
ShippingPhone	String	是	+86-13800000000	收件人电话。用于证书 Ukey（硬件令牌）的物流配送联系。
ShippingReceiver	String	是	Si Li	收件人姓名。证书 Ukey（硬件令牌）的收件人。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
InstanceId	String	cert-c88df6d4a1b348c3b714b746d3cc****	证书实例 ID。

请求示例

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

{
  "City": "Beijing",
  "CommonName": "测试企业",
  "ContactEmail": "zhangsan@example.com",
  "ContactName": "SanZhang",
  "ContactPhone": "+86-13800000000",
  "Country": "CN",
  "Name": "MyCodeSignCert",
  "Period": 365,
  "Plan": "digicert_code_signing_ov_1",
  "PostalCode": "100000",
  "Project": "default",
  "Province": "Beijing",
  "ShippingAddr": "北京市海淀区XX路XX号",
  "ShippingPhone": "+86-13800000000",
  "ShippingReceiver": "Si Li"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20260422191326028103065016984268",
    "Action": "CodeSignCertificateQuickPlaceOrder",
    "Version": "2024-10-01",
    "Service": "certificate_service",
    "Region": "cn-beijing"
  },
  "Result": {
    "InstanceId": "cert-c88df6d4a1b348c3b714b746d3cc**** "
  }
}

错误码

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

状态码	错误码	错误信息	说明
400	MalformedRequest	The request is malformed	请求参数格式不合法。
500	InternalError	The request has failed due to an unknown error.	未知错误。

最近更新时间：2026.04.23 11:54:28

这个页面对您有帮助吗？

有用

无用

证书中心

使用说明 #

注意事项 #

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #