验证 C2PA 证书实例签名

使用说明

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

注意事项

本接口仅校验指定 InstanceId 下摘要与签名的密码学有效性，不解析媒体容器，也不等同于对完整媒体文件执行 C2PA Manifest 结构、内容绑定（Hash）和证书信任状态（Trust List）校验。完整内容凭证的验证方法请参见 C2PA Manifest 写入规范指导文档。

请求说明

请求方法：POST

接入地址：pca.volcengineapi.com

API 版本：2025-10-01

调试

API Explorer

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

去调试

请求参数

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

Query

Action string 必选示例值：C2PAVerify

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

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

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

Body

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

C2PA 证书实例 ID。验签使用该实例的证书公钥。您可以调用 ListC2PAInstances 查询实例 ID。

MessageType string 必选示例值：DIGEST

消息类型。目前固定取值：DIGEST，表示 Message 为内容摘要。

Message string 必选示例值：vSsar3708Jvp9****

Base64 编码后的待验签摘要。摘要长度需与 SigningAlgorithm 对应的哈希算法一致：SHA-256 为 32 字节、SHA-384 为 48 字节、SHA-512 为 64 字节。

Signature string 必选示例值：WiQOj1tDMIOx****

Base64 编码后的待验证签名值，通常为 C2PASign 返回的 Signature。

SigningAlgorithm string 必选示例值：RSASSA_PSS_SHA_512

签名算法，需与签名时使用的算法及证书密钥类型匹配。取值：

RSASSA_PSS_SHA_256

RSASSA_PSS_SHA_384

RSASSA_PSS_SHA_512

RSASSA_PKCS1_V1_5_SHA_256

RSASSA_PKCS1_V1_5_SHA_384

RSASSA_PKCS1_V1_5_SHA_512

ECDSA_SHA_256

ECDSA_SHA_384

ECDSA_SHA_512

ED25519_SHA_512

返回参数

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

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

完成本次验签的证书实例 ID。

SignatureValid boolean 示例值：true

签名是否有效。

-true：验签通过

-false：签名与摘要不匹配或签名无效

SigningAlgorithm string 示例值：RSASSA_PSS_SHA_512

本次验签使用的签名算法。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	MalformedRequest	The request is malformed.	请求格式错误。
400	MissingParameter.InstanceId	The required parameter InstanceId is missing.	未提供必填参数 InstanceId。
400	InvalidParameter.InstanceId	InstanceId format is invalid.	InstanceId 不合法。
400	MissingParameter.MessageType	The required parameter MessageType is missing.	未提供必填参数 MessageType。
400	InvalidParameter.MessageType	MessageType is invalid.	MessageType 无效，当前仅支持 DIGEST。
400	MissingParameter.Message	The required parameter Message is missing.	未提供必填参数 Message。
400	InvalidParameter.Message	Message is too large.	Message 长度不合法。
400	MissingParameter.Signature	The required parameter Signature is missing.	未提供必填参数 Signature。
400	InvalidParameter.Signature	Signature is too large.	Signature 长度不合法。
400	InvalidParameter.SigningAlgorithm	The signing algorithm is invalid.	SigningAlgorithm 不在接口支持的签名算法列表中。
400	InvalidParameter.DigestSize	The message digest size is invalid.	Message 的摘要长度与 SigningAlgorithm 不匹配。
400	InvalidParameter.KeyAlgoSigningAlgoNotMatch	The key algorithm does not match the signing algorithm.	实例密钥算法与请求中的 SigningAlgorithm 不匹配。
404	InstanceNotFound	Instance not found.	当前账号下不存在指定的 InstanceId。
500	InternalError	The request failed due to an internal error.	服务内部错误。

证书中心