跳到主要内容
← 返回 API 目录

SSL 证书检查

解析与证书

检查证书颁发机构、有效期、域名匹配与证书链。

GET https://api.wanmi.net/open/v1/ssl-check

每天 100 次免费，超出 ¥0.01/次 · 同一账号多个 key 共用

用多少付多少。云工具 API 无免费次数，创建时预留余额，成功交付才结算（异步 PDF 在领取时结算）；失败释放或补偿。主动开通按量付费后，免费次数用完按接口单价从钱包扣费；余额不足或每日扣费上限已到时拒绝，不欠费。仅成功交付收费，符合接口契约的降级成功照常收费；失败和未交付不收费。每次扣费及补偿可在控制台账单查看，单价以各接口当前配置及调用准入快照为准。

沿用站内公网 DNS、安全 TLS 握手与 CAA 检查，仅连接 443。过期、自签名等证书发现仍是成功诊断；上游失败、限流或不完整检查不计次。

返回示例

{
  "state": "empty",
  "data": {
    "normalizedQueryAscii": "example.com",
    "normalizedQueryUnicode": "example.com",
    "risks": [],
    "caa": {
      "effectiveOwnerName": null,
      "inherited": false,
      "records": [],
      "source": {
        "cacheStatus": "miss",
        "dataSource": "公开查询",
        "observedAt": "2026-10-22T00:00:00.000Z"
      },
      "status": "no_record"
    },
    "tls": {
      "certificate": null,
      "cipherSuite": null,
      "findings": [],
      "port": 443,
      "protocol": null,
      "source": {
        "cacheStatus": "miss",
        "dataSource": "公开查询",
        "observedAt": "2026-10-22T00:00:00.000Z"
      },
      "status": "no_address"
    }
  }
}

在线试调

粘贴你自己的 key，浏览器会直接向 api.wanmi.net 发送请求。key 仅在当前页面内存中使用，不保存、不上传主站。成功调用会计入免费次数；已开通按量付费时，超出免费次数会按接口单价扣余额。

前往控制台获取 API key

响应点击“发送请求”查看真实返回
等待请求

代码示例

curl --max-time 65 'https://api.wanmi.net/open/v1/ssl-check?host=example.com' \
  -H "Authorization: Bearer $WANMI_API_KEY"

将 WANMI_API_KEY 设为环境变量。请在自己的服务器中运行，勿将 key 放进公开代码。

请求参数

参数类型必填说明
hoststring必填最短 1 字符；最长 253 字符
例如：example.com
返回字段与完整结构
字段类型必返说明
stateready | empty | degraded是—
dataobject是—
data.caaobject是—
data.caa.effectiveOwnerNamestring | null是—
data.caa.inheritedboolean是—
data.caa.issueobject否—
data.caa.issue.codestring是格式 ^[A-Z][A-Z0-9_]*$
data.caa.issue.messagestring是最短 1 字符
data.caa.issue.retryableboolean是—
data.caa.recordsobject[]是—
data.caa.records.[]criticalboolean是—
data.caa.records.[]explanationstring是最短 1 字符
data.caa.records.[]flagsinteger是最小 0；最大 255
data.caa.records.[]ownerNamestring是最短 1 字符；最长 253 字符
data.caa.records.[]tagissue | issuewild | iodef是—
data.caa.records.[]ttlinteger是最小 0；最大 4294967295
data.caa.records.[]valuestring是最长 4096 字符
data.caa.sourceobject是—
data.caa.source.cacheStatushit | miss | mixed | not_used是—
data.caa.source.dataSourcestring是最短 1 字符
data.caa.source.observedAtstring是date-time；格式 ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
data.caa.statusrecords | no_record | nxdomain | servfail | timeout | failed | rate_limited | limit_exceeded是—
data.normalizedQueryAsciistring是最短 1 字符；最长 253 字符
data.normalizedQueryUnicodestring是最短 1 字符；最长 253 字符
data.risksobject[]是—
data.risks.[]codeDOMAIN_MIXED_SCRIPT_RISK是—
data.risks.[]labelAsciistring是最短 1 字符
data.risks.[]messagestring是最短 1 字符
data.risks.[]scriptsstring[]是—
data.tlsobject是—
data.tls.certificateobject | null是—
data.tls.certificate.chainobject是—
data.tls.certificate.daysRemaininginteger是最小 -9007199254740991；最大 9007199254740991
data.tls.certificate.hostnameMatchboolean是—
data.tls.certificate.issuerobject是—
data.tls.certificate.sanCountinteger是最小 0；最大 9007199254740991
data.tls.certificate.sanTruncatedboolean是—
data.tls.certificate.subjectobject是—
data.tls.certificate.subjectAlternativeNamesstring[]是—
data.tls.certificate.validFromstring是date-time；格式 ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
data.tls.certificate.validityStatusvalid | expired | not_yet_valid是—
data.tls.certificate.validTostring是date-time；格式 ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
data.tls.cipherSuitestring | null是—
data.tls.findingsobject[]是—
data.tls.findings.[]codeTLS_CERT_EXPIRED | TLS_CERT_NOT_YET_VALID | TLS_HOSTNAME_MISMATCH | TLS_CERT_SELF_SIGNED | TLS_CERT_CHAIN_INVALID是—
data.tls.findings.[]messagestring是最短 1 字符
data.tls.findings.[]severityerror | warning是—
data.tls.issueobject否—
data.tls.issue.codestring是格式 ^[A-Z][A-Z0-9_]*$
data.tls.issue.messagestring是最短 1 字符
data.tls.issue.retryableboolean是—
data.tls.port443是—
data.tls.protocolstring | null是—
data.tls.sourceobject是—
data.tls.source.cacheStatushit | miss | mixed | not_used是—
data.tls.source.dataSourcestring是最短 1 字符
data.tls.source.observedAtstring是date-time；格式 ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
data.tls.statusconnected | no_address | connection_failed | timeout | handshake_failed | handshake_too_large | rate_limited是—
metaobject否—
meta.cacheStatushit | miss | mixed | not_used否—
meta.dataSourcestring否最短 1 字符
meta.lastSuccessfulAtstring否date-time；格式 ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
meta.observedAtstring否date-time；格式 ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
meta.staleboolean否—
meta.traceIdstring否格式 ^[a-zA-Z0-9._:-]{8,128}$
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "enum": [
        "ready",
        "empty",
        "degraded"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "caa": {
          "type": "object",
          "properties": {
            "effectiveOwnerName": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 253
                },
                {
                  "type": "null"
                }
              ]
            },
            "inherited": {
              "type": "boolean"
            },
            "issue": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string",
                  "pattern": "^[A-Z][A-Z0-9_]*$"
                },
                "message": {
                  "type": "string",
                  "minLength": 1
                },
                "retryable": {
                  "type": "boolean"
                }
              },
              "required": [
                "code",
                "message",
                "retryable"
              ],
              "additionalProperties": false
            },
            "records": {
              "maxItems": 32,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "critical": {
                    "type": "boolean"
                  },
                  "explanation": {
                    "type": "string",
                    "minLength": 1
                  },
                  "flags": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 255
                  },
                  "ownerName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "tag": {
                    "type": "string",
                    "enum": [
                      "issue",
                      "issuewild",
                      "iodef"
                    ]
                  },
                  "ttl": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "value": {
                    "type": "string",
                    "maxLength": 4096
                  }
                },
                "required": [
                  "critical",
                  "explanation",
                  "flags",
                  "ownerName",
                  "tag",
                  "ttl",
                  "value"
                ],
                "additionalProperties": false
              }
            },
            "source": {
              "type": "object",
              "properties": {
                "cacheStatus": {
                  "type": "string",
                  "enum": [
                    "hit",
                    "miss",
                    "mixed",
                    "not_used"
                  ]
                },
                "dataSource": {
                  "type": "string",
                  "minLength": 1
                },
                "observedAt": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                }
              },
              "required": [
                "cacheStatus",
                "dataSource",
                "observedAt"
              ],
              "additionalProperties": false
            },
            "status": {
              "type": "string",
              "enum": [
                "records",
                "no_record",
                "nxdomain",
                "servfail",
                "timeout",
                "failed",
                "rate_limited",
                "limit_exceeded"
              ]
            }
          },
          "required": [
            "effectiveOwnerName",
            "inherited",
            "records",
            "source",
            "status"
          ],
          "additionalProperties": false
        },
        "normalizedQueryAscii": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253
        },
        "normalizedQueryUnicode": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253
        },
        "risks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "const": "DOMAIN_MIXED_SCRIPT_RISK"
              },
              "labelAscii": {
                "type": "string",
                "minLength": 1
              },
              "message": {
                "type": "string",
                "minLength": 1
              },
              "scripts": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                }
              }
            },
            "required": [
              "code",
              "labelAscii",
              "message",
              "scripts"
            ],
            "additionalProperties": false
          }
        },
        "tls": {
          "type": "object",
          "properties": {
            "certificate": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "object",
                      "properties": {
                        "certificates": {
                          "maxItems": 10,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "fingerprint256": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 256
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "issuer": {
                                "type": "object",
                                "properties": {
                                  "commonName": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 1024
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "organization": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 1024
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "commonName",
                                  "organization"
                                ],
                                "additionalProperties": false
                              },
                              "subject": {
                                "type": "object",
                                "properties": {
                                  "commonName": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 1024
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "organization": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 1024
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "commonName",
                                  "organization"
                                ],
                                "additionalProperties": false
                              },
                              "validFrom": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "validTo": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "fingerprint256",
                              "issuer",
                              "subject",
                              "validFrom",
                              "validTo"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "depth": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 64
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "trusted",
                            "self_signed",
                            "invalid"
                          ]
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "certificates",
                        "depth",
                        "status",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "daysRemaining": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "hostnameMatch": {
                      "type": "boolean"
                    },
                    "issuer": {
                      "type": "object",
                      "properties": {
                        "commonName": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 1024
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "organization": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 1024
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "commonName",
                        "organization"
                      ],
                      "additionalProperties": false
                    },
                    "sanCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "sanTruncated": {
                      "type": "boolean"
                    },
                    "subject": {
                      "type": "object",
                      "properties": {
                        "commonName": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 1024
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "organization": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 1024
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "commonName",
                        "organization"
                      ],
                      "additionalProperties": false
                    },
                    "subjectAlternativeNames": {
                      "maxItems": 128,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024
                      }
                    },
                    "validFrom": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    },
                    "validityStatus": {
                      "type": "string",
                      "enum": [
                        "valid",
                        "expired",
                        "not_yet_valid"
                      ]
                    },
                    "validTo": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                    }
                  },
                  "required": [
                    "chain",
                    "daysRemaining",
                    "hostnameMatch",
                    "issuer",
                    "sanCount",
                    "sanTruncated",
                    "subject",
                    "subjectAlternativeNames",
                    "validFrom",
                    "validityStatus",
                    "validTo"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "cipherSuite": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512
                },
                {
                  "type": "null"
                }
              ]
            },
            "findings": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "enum": [
                      "TLS_CERT_EXPIRED",
                      "TLS_CERT_NOT_YET_VALID",
                      "TLS_HOSTNAME_MISMATCH",
                      "TLS_CERT_SELF_SIGNED",
                      "TLS_CERT_CHAIN_INVALID"
                    ]
                  },
                  "message": {
                    "type": "string",
                    "minLength": 1
                  },
                  "severity": {
                    "type": "string",
                    "enum": [
                      "error",
                      "warning"
                    ]
                  }
                },
                "required": [
                  "code",
                  "message",
                  "severity"
                ],
                "additionalProperties": false
              }
            },
            "issue": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string",
                  "pattern": "^[A-Z][A-Z0-9_]*$"
                },
                "message": {
                  "type": "string",
                  "minLength": 1
                },
                "retryable": {
                  "type": "boolean"
                }
              },
              "required": [
                "code",
                "message",
                "retryable"
              ],
              "additionalProperties": false
            },
            "port": {
              "type": "number",
              "const": 443
            },
            "protocol": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64
                },
                {
                  "type": "null"
                }
              ]
            },
            "source": {
              "type": "object",
              "properties": {
                "cacheStatus": {
                  "type": "string",
                  "enum": [
                    "hit",
                    "miss",
                    "mixed",
                    "not_used"
                  ]
                },
                "dataSource": {
                  "type": "string",
                  "minLength": 1
                },
                "observedAt": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                }
              },
              "required": [
                "cacheStatus",
                "dataSource",
                "observedAt"
              ],
              "additionalProperties": false
            },
            "status": {
              "type": "string",
              "enum": [
                "connected",
                "no_address",
                "connection_failed",
                "timeout",
                "handshake_failed",
                "handshake_too_large",
                "rate_limited"
              ]
            }
          },
          "required": [
            "certificate",
            "cipherSuite",
            "findings",
            "port",
            "protocol",
            "source",
            "status"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "caa",
        "normalizedQueryAscii",
        "normalizedQueryUnicode",
        "risks",
        "tls"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "cacheStatus": {
          "type": "string",
          "enum": [
            "hit",
            "miss",
            "mixed",
            "not_used"
          ]
        },
        "dataSource": {
          "type": "string",
          "minLength": 1
        },
        "lastSuccessfulAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "observedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "stale": {
          "type": "boolean"
        },
        "traceId": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9._:-]{8,128}$"
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "state",
    "data"
  ],
  "additionalProperties": false
}

错误码

HTTP错误码含义与处理
400INVALID_REQUEST请检查请求；保留响应中的 traceId 以便排查。
400API_INPUT_INVALID请按参数表检查输入；参数错误不计入免费次数。
400API_TARGET_BLOCKED目标不符合公网查询规则，请检查域名或网址。
401API_KEY_REQUIRED在 Authorization 请求头中添加 Bearer key。
401API_KEY_INVALID检查 key 是否正确；轮换后请更新程序中的 key。
401API_KEY_REVOKEDkey 已吊销，请在控制台创建新的 key。
402API_BALANCE_INSUFFICIENT请检查请求；保留响应中的 traceId 以便排查。
403API_SPEND_REACTIVATION_REQUIRED请检查账户状态和权限后再试。
403ACCOUNT_BALANCE_SPEND_DISABLED请检查账户状态和权限后再试。
403STEP_UP_IDENTITY_RISK_COOLDOWN_ACTIVE请检查账户状态和权限后再试。
403API_KEY_BANNEDkey 已封禁，请联系支持。
403API_SCOPE_FORBIDDEN此 key 无权调用该接口，请在控制台检查权限。
403API_KEY_CHANGEDkey 已发生变化，请使用最新的 key。
403REALNAME_VERIFICATION_REQUIRED请检查账户状态和权限后再试。
403ACCOUNT_API_ACCESS_DISABLED请检查账户状态和权限后再试。
403ACCOUNT_LOGIN_DISABLED请检查账户状态和权限后再试。
403ACCOUNT_CLOSED请检查账户状态和权限后再试。
403ACCOUNT_CLOSING请检查账户状态和权限后再试。
403ACCOUNT_PENDING_REGISTRATION请检查账户状态和权限后再试。
403ACCOUNT_SUSPENDED请检查账户状态和权限后再试。
403ACCOUNT_STATE_INVALID请检查账户状态和权限后再试。
404API_NOT_FOUND请检查请求；保留响应中的 traceId 以便排查。
405API_METHOD_NOT_ALLOWED请检查请求；保留响应中的 traceId 以便排查。
408API_REQUEST_ABORTED请检查请求；保留响应中的 traceId 以便排查。
409API_RESERVATION_EXPIRED请检查请求；保留响应中的 traceId 以便排查。
409API_SPEND_VERSION_CHANGED请检查请求；保留响应中的 traceId 以便排查。
409WALLET_SPEND_LIMIT_EXCEEDED请检查请求；保留响应中的 traceId 以便排查。
410API_UNAVAILABLE接口已下架，请查看目录中的已开放接口。
421API_HOST_INVALID请检查请求；保留响应中的 traceId 以便排查。
429API_RATE_LIMITED请求过于频繁，请按 Retry-After 等待后重试。
429API_FREE_QUOTA_EXHAUSTED今日免费次数已用完；可在控制台主动开通按量付费，或等待次日免费次数恢复。
429API_SITE_QUOTA_EXHAUSTED接口的全站日容量已满，请稍后再试。
429API_DAILY_SPEND_LIMIT_EXCEEDED请检查请求；保留响应中的 traceId 以便排查。
429API_UPSTREAM_RATE_LIMITED请检查请求；保留响应中的 traceId 以便排查。
500INTERNAL_ERROR服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
500API_TELEMETRY_INVALID服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
500ACCOUNT_RESTRICTIONS_INVALID服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
502API_EXECUTION_FAILED服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
502API_INVALID_RESPONSE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
502API_RESPONSE_TOO_LARGE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
502API_UPSTREAM_UNAVAILABLE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503API_BILLING_NOT_CONFIGURED服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503API_BILLING_UNAVAILABLE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503WALLET_POLICY_UNAVAILABLE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503WALLET_LEDGER_UNAVAILABLE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503OPEN_API_DISABLED服务尚未开放或暂时停用，请稍后再试。
503API_LIMIT_UNAVAILABLE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503API_QUOTA_UNAVAILABLE服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
503API_QUOTA_NOT_CONFIGURED服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。
504API_EXECUTION_TIMEOUT服务暂时未能完成调用；失败不计次，请保留 X-Request-Id 联系支持。