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

WHOIS 查询

域名

查询域名的注册商、注册与到期时间、状态和域名服务器，覆盖主流后缀。

GET https://api.wanmi.net/open/v1/whois

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

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

公开 RDAP/WHOIS 注册信息，公开源失败时使用既有兜底。联系人沿用站内隐私规则；不返回上游服务商标识和原文。无公开记录是成功的 empty 结果。

返回示例

{
  "state": "ready",
  "data": {
    "normalizedQueryAscii": "example.com",
    "normalizedQueryUnicode": "example.com",
    "risks": [],
    "domainAscii": "example.com",
    "domainUnicode": "example.com",
    "dates": {
      "created": null,
      "expires": null,
      "updated": null
    },
    "registrar": "Example Registrar",
    "nameServers": [],
    "statuses": [],
    "recordStatus": "record_found",
    "source": {
      "protocol": "rdap"
    }
  }
}

在线试调

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

前往控制台获取 API key

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

代码示例

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

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

请求参数

参数类型必填说明
domainstring必填最短 1 字符；最长 253 字符
例如：example.com
返回字段与完整结构
字段类型必返说明
stateready | empty | degraded是—
dataobject是—
data.calendarDatesobject[]否—
data.calendarDates.[]fieldcreated | expires | updated | transferred是—
data.calendarDates.[]datestring是date；格式 ^(?:(?:\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])))$
data.calendarDates.[]timeZonestring | null是—
data.datesobject是—
data.dates.createdstring | null是—
data.dates.expiresstring | null是—
data.dates.updatedstring | null是—
data.dates.transferredstring | null否—
data.warningsWHOIS_REGISTRAR_UNAVAILABLE | WHOIS_DATE_TIMEZONE_UNKNOWN[]否—
data.detailsobject否—
data.details.contactsobject否—
data.details.contacts.registrantobject是—
data.details.contacts.registrant.namestring | null是—
data.details.contacts.registrant.organizationstring | null是—
data.details.contacts.registrant.emailstring | null是—
data.details.contacts.registrant.phonestring | null是—
data.details.contacts.registrant.streetstring | null是—
data.details.contacts.registrant.citystring | null是—
data.details.contacts.registrant.statestring | null是—
data.details.contacts.registrant.postalCodestring | null是—
data.details.contacts.registrant.countrystring | null是—
data.details.contacts.adminobject是—
data.details.contacts.admin.namestring | null是—
data.details.contacts.admin.organizationstring | null是—
data.details.contacts.admin.emailstring | null是—
data.details.contacts.admin.phonestring | null是—
data.details.contacts.admin.streetstring | null是—
data.details.contacts.admin.citystring | null是—
data.details.contacts.admin.statestring | null是—
data.details.contacts.admin.postalCodestring | null是—
data.details.contacts.admin.countrystring | null是—
data.details.contacts.techobject是—
data.details.contacts.tech.namestring | null是—
data.details.contacts.tech.organizationstring | null是—
data.details.contacts.tech.emailstring | null是—
data.details.contacts.tech.phonestring | null是—
data.details.contacts.tech.streetstring | null是—
data.details.contacts.tech.citystring | null是—
data.details.contacts.tech.statestring | null是—
data.details.contacts.tech.postalCodestring | null是—
data.details.contacts.tech.countrystring | null是—
data.details.registryDomainIdstring | null是—
data.details.registrarIanaIdstring | null是—
data.details.registrarUrlstring | null是—
data.details.registrarWhoisServerstring | null是—
data.details.resellerstring | null是—
data.details.abuseEmailstring | null否—
data.details.abusePhonestring | null否—
data.details.nameServersobject[]是—
data.details.nameServers.[]namestring是最短 1 字符；最长 253 字符
data.details.nameServers.[]ipv4string[]是—
data.details.nameServers.[]ipv6string[]是—
data.details.dnssecobject | null是—
data.details.dnssec.signedboolean是—
data.details.dnssec.dsDataobject[]是—
data.domainAsciistring是最短 1 字符；最长 253 字符
data.domainUnicodestring是最短 1 字符；最长 253 字符
data.nameServersstring[]是—
data.normalizedQueryAsciistring是最短 1 字符；最长 253 字符
data.normalizedQueryUnicodestring是最短 1 字符；最长 253 字符
data.recordStatusrecord_found | no_public_record是—
data.registrarstring | null是—
data.risksobject[]是—
data.risks.[]codeDOMAIN_MIXED_SCRIPT_RISK是—
data.risks.[]labelAsciistring是最短 1 字符
data.risks.[]messagestring是最短 1 字符
data.risks.[]scriptsstring[]是—
data.statusesstring[]是—
data.sourceobject是—
data.source.protocolrdap | whois是—
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": {
        "calendarDates": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string",
                "enum": [
                  "created",
                  "expires",
                  "updated",
                  "transferred"
                ]
              },
              "date": {
                "type": "string",
                "format": "date",
                "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])))$"
              },
              "timeZone": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "field",
              "date",
              "timeZone"
            ],
            "additionalProperties": false
          }
        },
        "dates": {
          "type": "object",
          "properties": {
            "created": {
              "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "expires": {
              "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updated": {
              "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "transferred": {
              "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "created",
            "expires",
            "updated"
          ],
          "additionalProperties": false
        },
        "warnings": {
          "maxItems": 2,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "WHOIS_REGISTRAR_UNAVAILABLE",
              "WHOIS_DATE_TIMEZONE_UNKNOWN"
            ]
          }
        },
        "details": {
          "type": "object",
          "properties": {
            "contacts": {
              "type": "object",
              "properties": {
                "registrant": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "organization": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "email": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "phone": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "street": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "city": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "state": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "postalCode": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "country": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "name",
                    "organization",
                    "email",
                    "phone",
                    "street",
                    "city",
                    "state",
                    "postalCode",
                    "country"
                  ],
                  "additionalProperties": false
                },
                "admin": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "organization": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "email": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "phone": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "street": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "city": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "state": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "postalCode": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "country": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "name",
                    "organization",
                    "email",
                    "phone",
                    "street",
                    "city",
                    "state",
                    "postalCode",
                    "country"
                  ],
                  "additionalProperties": false
                },
                "tech": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "organization": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "email": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "phone": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "street": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "city": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "state": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "postalCode": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "country": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "name",
                    "organization",
                    "email",
                    "phone",
                    "street",
                    "city",
                    "state",
                    "postalCode",
                    "country"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "registrant",
                "admin",
                "tech"
              ],
              "additionalProperties": false
            },
            "registryDomainId": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                },
                {
                  "type": "null"
                }
              ]
            },
            "registrarIanaId": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,16}$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "registrarUrl": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri"
                },
                {
                  "type": "null"
                }
              ]
            },
            "registrarWhoisServer": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 253,
                  "pattern": "^[a-z0-9.-]+$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "reseller": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                },
                {
                  "type": "null"
                }
              ]
            },
            "abuseEmail": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                },
                {
                  "type": "null"
                }
              ]
            },
            "abusePhone": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                },
                {
                  "type": "null"
                }
              ]
            },
            "nameServers": {
              "maxItems": 64,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "ipv4": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "ipv4",
                      "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$"
                    }
                  },
                  "ipv6": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "ipv6",
                      "pattern": "^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))$"
                    }
                  }
                },
                "required": [
                  "name",
                  "ipv4",
                  "ipv6"
                ],
                "additionalProperties": false
              }
            },
            "dnssec": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "signed": {
                      "type": "boolean"
                    },
                    "dsData": {
                      "maxItems": 64,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "keyTag": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 65535
                          },
                          "algorithm": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 255
                          },
                          "digestType": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 255
                          },
                          "digest": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2048,
                            "pattern": "^[a-f0-9]+$"
                          }
                        },
                        "required": [
                          "keyTag",
                          "algorithm",
                          "digestType",
                          "digest"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "signed",
                    "dsData"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "registryDomainId",
            "registrarIanaId",
            "registrarUrl",
            "registrarWhoisServer",
            "reseller",
            "nameServers",
            "dnssec"
          ],
          "additionalProperties": false
        },
        "domainAscii": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253
        },
        "domainUnicode": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253
        },
        "nameServers": {
          "maxItems": 64,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 253
          }
        },
        "normalizedQueryAscii": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253
        },
        "normalizedQueryUnicode": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253
        },
        "recordStatus": {
          "type": "string",
          "enum": [
            "record_found",
            "no_public_record"
          ]
        },
        "registrar": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            },
            {
              "type": "null"
            }
          ]
        },
        "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
          }
        },
        "statuses": {
          "maxItems": 64,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "source": {
          "type": "object",
          "properties": {
            "protocol": {
              "type": "string",
              "enum": [
                "rdap",
                "whois"
              ]
            }
          },
          "required": [
            "protocol"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "dates",
        "domainAscii",
        "domainUnicode",
        "nameServers",
        "normalizedQueryAscii",
        "normalizedQueryUnicode",
        "recordStatus",
        "registrar",
        "risks",
        "statuses",
        "source"
      ],
      "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 以便排查。
422API_QUERY_UNSUPPORTED暂不支持查询此目标。
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 联系支持。