查询 C2PA 证书详情

使用说明

调用本接口需要传入已存在的 C2PA 证书实例 ID。您可以调用 ListC2PAInstances 查询实例 ID。

注意事项

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

请求说明

请求方法：POST

接入地址：pca.volcengineapi.com

API 版本：2025-10-01

调试

API Explorer

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

去调试

请求参数

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

Query

Action string 必选示例值：DescribeC2PAInstance

要执行的操作，取值：DescribeC2PAInstance。

Version string 必选示例值：2025-10-01

API的版本，取值：2025-10-01。

Body

InstanceId string 必选示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361****

C2PA 证书实例 ID。您可以调用 ListC2PAInstances 查询实例 ID。

返回参数

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

InstanceId string 示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361****

证书实例 ID。

Status string 示例值：issued

证书实例状态列表。取值：

pending：验证中

issued：已签发

cancelled：已取消

terminated：已终结

Email string 示例值：sign@example.com

证书主体中的企业邮箱。

Organization string 示例值：Example Inc.

证书主体中的组织名称（O）。

Supplier string 示例值：globalsign

证书供应商（CA 品牌）。

CertType string 示例值：s/mime

证书类型。

Plan string 示例值：globalsign_smime_ov_1y

证书规格。取值：

globalsign_smime_ov_1y：GlobalSign OV S/MIME 1 年期

globalsign_smime_ov_2y：GlobalSign OV S/MIME 2 年期

Description string 示例值：业务线A签名证书

证书实例备注名。

CreateTime string 示例值：2026-09-01T10:00:00Z

实例创建时间（UTC）。

Certificate string 示例值：-----BEGIN CERTIFICATE-----\nMIIEqzCC......mSD5gds=\n-----END CERTIFICATE-----\n

终端实体证书内容，PEM 格式。

CertificateChain string 示例值：-----BEGIN CERTIFICATE-----\nMIIEszCC......../m8Fxw==\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIDjjCC......fl\nMrY=\n-----END CERTIFICATE-----\n

完整证书链内容，PEM 格式，按“终端实体证书 → 中间 CA → 根 CA”顺序拼接。

Subject object 示例值：-

证书主体信息。

CommonName string 示例值：sign.example.com

公用名（CN）。

Country string 示例值：CN

国家或地区代码（C）。

Organization string 示例值：Example Inc.

组织名称（O）。

Issuer object 示例值：-

证书签发者信息。

CommonName string 示例值：sign.example.com

公用名（CN）。

Country string 示例值：CN

国家或地区代码（C）。

Organization string 示例值：Example Inc.

组织名称（O）。

SerialNumber string 示例值：7d1fa2c3e4b56a7890d1e2f3a4b5c6d7

证书序列号。

NotBefore integer 示例值：1756720800

证书生效时间，Unix 时间戳，单位：秒。

NotAfter integer 示例值：1788256800

证书到期时间，Unix 时间戳，单位：秒。

NotBeforeUTC string 示例值：2026-09-01 00:00:00 +0000 UTC

证书签发时间（UTC）。

NotAfterUTC string 示例值：2027-09-01 00:00:00 +0000 UTC

证书到期时间（UTC）。

KeyAlgorithm string 示例值：RSA_4096

证书密钥算法。

FingerPrintSha1 string 示例值：9f1b2c3d4e5f60718293a4b5c6d7e8f9012345c4

证书指纹（SHA-1）。

FingerPrintSha256 string 示例值：a53b846e14b33939e6cd7f9cf320****

证书指纹（SHA-256）。

Contact object 示例值：-

证书申请时填写的联系人信息。

Name string 示例值：Zhang San

联系人姓名。

Email string 示例值：contact@example.com

联系人邮箱。

Phone string 示例值：+86-138****0000

联系人电话。

Project string 示例值：default

资源所属项目组。

Tags object[] 示例值：-

证书实例绑定的标签。

Key string 示例值：env

资源标签键。

Value string 示例值：test

资源标签值。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	MalformedRequest	The request is malformed.	请求格式错误。
400	MissingParameter.InstanceId	The required parameter InstanceId is missing.	未提供必填参数 InstanceId。
400	InvalidParameter.InstanceId	InstanceId format is invalid.	InstanceId 不合法。
404	InstanceNotFound	Instance not found.	当前账号下不存在指定的 InstanceId。
500	InternalError	The request failed due to an internal error.	服务内部错误。

证书中心