C2PA 实例签名 ## 使用说明 * C2PA 证书的私钥由云端 HSM 托管，不支持导出。所有签名操作均通过本接口在云端完成。 * 本接口要求调用方在本地先对待签名的原始内容计算摘要（Hash），再将摘要 Base64 编码后作为 `Message` 传入。 * 请求的 C2PA 证书实例必须处于 **已签发** 状态，且未过期、未吊销、未欠费。 ## 注意事项请求频率：同一个租户每秒最多允许请求 20 次。 ## 请求说明 * 请求方法：POST * 接入地址：`pca.volcengineapi.com` * API 版本：2025\-10\-01 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=C2PASign&groupName=C2PA&serviceCode=pca&version=2025-10-01) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query **Action** string 必选 `示例值：C2PASign` 要执行的操作，取值：C2PASign。 **Version** string 必选 `示例值：2025-10-01` API的版本，取值：2025\-10\-01。 ### Body **InstanceId** string 必选 `示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361****` C2PA 证书实例 ID。实例需处于**已签发**状态。您可以调用 [ListC2PAInstances](https://docs.volcengine.com/docs/6638/2665210) 查询实例 ID。 **MessageType** string 必选 `示例值：DIGEST` 消息类型。目前固定取值：`DIGEST`，表示 `Message` 为内容摘要。 **Message** string 必选 `示例值：vSsar3708Jvp9Szi2NWZZ02Bqp1q****` Base64 编码后的待签名摘要。摘要长度需与 `SigningAlgorithm` 对应的哈希算法一致：SHA\-256 为 32 字节、SHA\-384 为 48 字节、SHA\-512 为 64 字节。 **SigningAlgorithm** string 必选 `示例值：RSASSA_PSS_SHA_256` 签名算法。取值： * 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 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **InstanceId** string `示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361e****` C2PA 证书实例 ID。 **Signature** string `示例值：2hwgC/f0lbbo4/N5lXS595Cl****` Base64 编码后的签名值。 **SigningAlgorithm** string `示例值：RSASSA_PSS_SHA_256` 本次签名实际使用的签名算法。 ## 请求示例 ```json POST /?Action=C2PASign&Version=2025-10-01 HTTP/1.1 Host: pca.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20260908T040242Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260908/cn-beijing/pca/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "InstanceId": "c2pa-cert-b7eb5c7094cc4e89ac806802361****", "MessageType": "DIGEST", "Message": "vSsar3708Jvp9Szi2NWZZ02Bqp1q****", "SigningAlgorithm": "RSASSA_PSS_SHA_256" } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20260908120256224219184235EE5698", "Action": "C2PASign", "Version": "2025-10-01", "Service": "pca", "Region": "cn-beijing" }, "Result": { "InstanceId": "c2pa-cert-b7eb5c7094cc4e89ac806802361e****", "Signature": "2hwgC/f0lbbo4/N5lXS595Cl****", "SigningAlgorithm": "RSASSA_PSS_SHA_256" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |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 |InvalidParameter.SigningAlgorithm |The signing algorithm is invalid. |SigningAlgorithm 不在接口支持的签名算法列表中。 | |400 |InvalidParameter.DigestSize |The message digest size is invalid. |Message 的摘要长度与 SigningAlgorithm 不匹配。 | |400 |InstanceCertificateNotIssued |The certificate has not been issued. |实例证书未签发。 | |400 |InstanceCertificateExpired |The certificate has expired. |实例证书已超过有效期，无法继续用于签名。 | |400 |InstanceCertificateRevoked |The certificate has been revoked. |实例证书已被吊销，无法继续用于签名。 | |400 |InstanceOverdue |The instance is overdue. |实例已欠费，无法继续用于签名。 | |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. |服务内部错误。 |

证书中心