文档中心

证书中心

API 参考

GetC2PAInstance - 获取 C2PA 证书

获取 C2PA 证书

使用说明

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

注意事项

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

请求说明

请求方法：POST

接入地址：pca.volcengineapi.com

API 版本：2025-10-01

调试

API Explorer

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

去调试

请求参数

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

Query

Action string 必选示例值：GetC2PAInstance

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

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：已终结

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”顺序拼接。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
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.	服务内部错误。

最近更新时间：2026.09.08 17:24:37

这个页面对您有帮助吗？

有用

无用