本文档介绍了火山引擎SSL证书服务是如何响应API请求的。

响应状态码

SSL证书服务的响应状态码的介绍如下：

• 2xx：表示SSL证书服务已成功响应了API请求。但是成功响应未必保证API请求是成功的。参见判断API请求是否成功。
• 4xx：表示SSL证书服务无法返回客户端请求的内容。原因是客户端请求不合法。例如：
  • 请求的文件不存在。
  • 请求方法不正确。
  • 请求中缺少必要的参数。例如缺少Action参数。
  • 请求者没有操作目标资源的权限。
• 5xx：表示请求已经失败了。失败的原因是SSL证书服务发生了内部错误。例如SSL证书服务服务不可用。

判断API请求是否成功

在您判断API请求是否成功时，不建议您使用SSL证书服务的响应状态码。我们建议您使用以下判断标准：

• 如果一个API请求成功，响应正文的ResponseMetadata结构体中不包含Error字段。
• 其余情况都被认为是请求失败。您可以在ResponseMetadata结构体的Error字段中找到相应的错误消息。

关于SSL证书服务中的常见错误，参见公共错误码。

响应示例

请求成功的响应示例

{
    "ResponseMetadata": {
        "RequestId": "202310181514120D6AD8DCBB673D4445B5",
        "Action": "QuickApplyCertificate",
        "Version": "2021-06-01",
        "Service": "certificate_service",
        "Region": "cn-north-1"
    },
	"Result": {...}
}

请求失败的响应示例

{
    "ResponseMetadata": {
        "RequestId": "202310181514120D6AD8DCBB673D4445B5",
        "Action": "QuickApplyCertificate",
        "Version": "2021-06-01",
        "Service": "certificate_service",
        "Region": "cn-north-1"
        "Error": {
            "Code": 2000,
            "Message": "服务器内部错误"
        }
    }
}