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

域名价格

域名

按后缀查询本站的标准域名展示价格。

GET https://api.wanmi.net/open/v1/domain-pricing

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

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

1～10 个后缀的标准域名展示价，显式使用 display_snapshot。金额为整数人民币分，不构成交易报价；不提供溢价域名价格。stale 保留历史价格与时间，purchaseEligible 始终 false。

返回示例

{
  "state": "ready",
  "data": {
    "priceClass": "standard",
    "tlds": [
      "com",
      "net"
    ],
    "items": [
      {
        "tld": "com",
        "status": "priced",
        "cache": {
          "status": "hit"
        },
        "dataSource": "展示价快照",
        "observedAt": "2026-10-22T00:00:00.000Z",
        "purchaseEligible": false,
        "purchaseBlockCode": "PURCHASE_NOT_IMPLEMENTED",
        "currency": "CNY",
        "markupConfigured": true,
        "minimumRegistrationYears": 1,
        "priceClass": "standard",
        "calculationFormula": "registration_price_plus_annual_renewal_price",
        "registrationPriceFen": 8000,
        "renewalPriceFen": 9000,
        "oneYearTotalFen": 8000,
        "threeYearTotalFen": 26000,
        "snapshotRef": "00000000-0000-4000-8000-000000000001"
      },
      {
        "tld": "net",
        "status": "priced",
        "cache": {
          "status": "hit"
        },
        "dataSource": "展示价快照",
        "observedAt": "2026-10-22T00:00:00.000Z",
        "purchaseEligible": false,
        "purchaseBlockCode": "PURCHASE_NOT_IMPLEMENTED",
        "currency": "CNY",
        "markupConfigured": true,
        "minimumRegistrationYears": 1,
        "priceClass": "standard",
        "calculationFormula": "registration_price_plus_annual_renewal_price",
        "registrationPriceFen": 8000,
        "renewalPriceFen": 9000,
        "oneYearTotalFen": 8000,
        "threeYearTotalFen": 26000,
        "snapshotRef": "00000000-0000-4000-8000-000000000001"
      }
    ]
  }
}

在线试调

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

前往控制台获取 API key

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

代码示例

curl --max-time 95 'https://api.wanmi.net/open/v1/domain-pricing?tlds=com%2Cnet' \
  -H "Authorization: Bearer $WANMI_API_KEY"

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

请求参数

参数类型必填说明
tldsstring必填1～10 个后缀；仅标准域名展示价，不查询溢价域名价格；最短 1 字符；最长 2549 字符；格式 ^[^,\s]{1,253}(?:\s*,\s*[^,\s]{1,253}){0,9}$
例如：com,net
返回字段与完整结构
字段类型必返说明
stateready | empty | degraded是—
dataobject是—
data.itemsobject | object | object | object | object[]是—
data.items.[]providerNoticesicp_filing_unavailable | local_presence_required | premium_unsupported | purchase_unavailable[]否—
data.items.[]cacheobject是—
data.items.[]dataSourcestring是最短 1 字符
data.items.[]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.items.[]purchaseEligiblefalse是—
data.items.[]tldstring是最短 1 字符；最长 253 字符
data.items.[]calculationFormularegistration_price_plus_annual_renewal_price是—
data.items.[]currencyCNY是—
data.items.[]markupConfiguredtrue是—
data.items.[]minimumRegistrationYearsinteger是最小 1；最大 10
data.items.[]oneYearTotalFeninteger否最小 0；最大 9007199254740991
data.items.[]priceClassstandard是—
data.items.[]registrationPriceFeninteger是最小 0；最大 9007199254740991
data.items.[]renewalPriceFeninteger否最小 0；最大 9007199254740991
data.items.[]snapshotRefstring是uuid；格式 ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
data.items.[]threeYearTotalFeninteger否最小 0；最大 9007199254740991
data.items.[]purchaseBlockCodePURCHASE_NOT_IMPLEMENTED是—
data.items.[]statuspriced是—
data.items.[]providerNoticesicp_filing_unavailable | local_presence_required | premium_unsupported | purchase_unavailable[]否—
data.items.[]cacheobject是—
data.items.[]dataSourcestring是最短 1 字符
data.items.[]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.items.[]purchaseEligiblefalse是—
data.items.[]tldstring是最短 1 字符；最长 253 字符
data.items.[]calculationFormularegistration_price_plus_annual_renewal_price是—
data.items.[]currencyCNY是—
data.items.[]markupConfiguredtrue是—
data.items.[]minimumRegistrationYearsinteger是最小 1；最大 10
data.items.[]oneYearTotalFeninteger否最小 0；最大 9007199254740991
data.items.[]priceClassstandard是—
data.items.[]registrationPriceFeninteger是最小 0；最大 9007199254740991
data.items.[]renewalPriceFeninteger否最小 0；最大 9007199254740991
data.items.[]snapshotRefstring是uuid；格式 ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
data.items.[]threeYearTotalFeninteger否最小 0；最大 9007199254740991
data.items.[]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))$
data.items.[]purchaseBlockCodePRICE_STALE是—
data.items.[]statusstale是—
data.items.[]providerNoticesicp_filing_unavailable | local_presence_required | premium_unsupported | purchase_unavailable[]否—
data.items.[]cacheobject是—
data.items.[]dataSourcestring是最短 1 字符
data.items.[]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.items.[]purchaseEligiblefalse是—
data.items.[]tldstring是最短 1 字符；最长 253 字符
data.items.[]markupConfiguredfalse是—
data.items.[]purchaseBlockCodePRICE_RULE_UNCONFIGURED是—
data.items.[]statusunconfigured是—
data.items.[]providerNoticesicp_filing_unavailable | local_presence_required | premium_unsupported | purchase_unavailable[]否—
data.items.[]cacheobject是—
data.items.[]dataSourcestring是最短 1 字符
data.items.[]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.items.[]purchaseEligiblefalse是—
data.items.[]tldstring是最短 1 字符；最长 253 字符
data.items.[]purchaseBlockCodeTLD_UNSUPPORTED | PRICE_NOT_OFFERED是—
data.items.[]statusunsupported是—
data.items.[]providerNoticesicp_filing_unavailable | local_presence_required | premium_unsupported | purchase_unavailable[]否—
data.items.[]cacheobject是—
data.items.[]dataSourcestring是最短 1 字符
data.items.[]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.items.[]purchaseEligiblefalse是—
data.items.[]tldstring是最短 1 字符；最长 253 字符
data.items.[]problemobject是—
data.items.[]purchaseBlockCodePRICE_QUERY_FAILED是—
data.items.[]statusquery_failed是—
data.priceClassstandard是—
data.tldsstring[]是—
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": {
        "items": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "providerNotices": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "icp_filing_unavailable",
                        "local_presence_required",
                        "premium_unsupported",
                        "purchase_unavailable"
                      ]
                    }
                  },
                  "cache": {
                    "type": "object",
                    "properties": {
                      "expiresAt": {
                        "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))$"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "hit",
                          "miss",
                          "not_used"
                        ]
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "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))$"
                  },
                  "purchaseEligible": {
                    "type": "boolean",
                    "const": false
                  },
                  "tld": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "calculationFormula": {
                    "type": "string",
                    "const": "registration_price_plus_annual_renewal_price"
                  },
                  "currency": {
                    "type": "string",
                    "const": "CNY"
                  },
                  "markupConfigured": {
                    "type": "boolean",
                    "const": true
                  },
                  "minimumRegistrationYears": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10
                  },
                  "oneYearTotalFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "priceClass": {
                    "type": "string",
                    "const": "standard"
                  },
                  "registrationPriceFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "renewalPriceFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "snapshotRef": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  },
                  "threeYearTotalFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "purchaseBlockCode": {
                    "type": "string",
                    "const": "PURCHASE_NOT_IMPLEMENTED"
                  },
                  "status": {
                    "type": "string",
                    "const": "priced"
                  }
                },
                "required": [
                  "cache",
                  "dataSource",
                  "observedAt",
                  "purchaseEligible",
                  "tld",
                  "calculationFormula",
                  "currency",
                  "markupConfigured",
                  "minimumRegistrationYears",
                  "priceClass",
                  "registrationPriceFen",
                  "snapshotRef",
                  "purchaseBlockCode",
                  "status"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "providerNotices": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "icp_filing_unavailable",
                        "local_presence_required",
                        "premium_unsupported",
                        "purchase_unavailable"
                      ]
                    }
                  },
                  "cache": {
                    "type": "object",
                    "properties": {
                      "expiresAt": {
                        "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))$"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "hit",
                          "miss",
                          "not_used"
                        ]
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "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))$"
                  },
                  "purchaseEligible": {
                    "type": "boolean",
                    "const": false
                  },
                  "tld": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "calculationFormula": {
                    "type": "string",
                    "const": "registration_price_plus_annual_renewal_price"
                  },
                  "currency": {
                    "type": "string",
                    "const": "CNY"
                  },
                  "markupConfigured": {
                    "type": "boolean",
                    "const": true
                  },
                  "minimumRegistrationYears": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10
                  },
                  "oneYearTotalFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "priceClass": {
                    "type": "string",
                    "const": "standard"
                  },
                  "registrationPriceFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "renewalPriceFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "snapshotRef": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                  },
                  "threeYearTotalFen": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "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))$"
                  },
                  "purchaseBlockCode": {
                    "type": "string",
                    "const": "PRICE_STALE"
                  },
                  "status": {
                    "type": "string",
                    "const": "stale"
                  }
                },
                "required": [
                  "cache",
                  "dataSource",
                  "observedAt",
                  "purchaseEligible",
                  "tld",
                  "calculationFormula",
                  "currency",
                  "markupConfigured",
                  "minimumRegistrationYears",
                  "priceClass",
                  "registrationPriceFen",
                  "snapshotRef",
                  "lastSuccessfulAt",
                  "purchaseBlockCode",
                  "status"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "providerNotices": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "icp_filing_unavailable",
                        "local_presence_required",
                        "premium_unsupported",
                        "purchase_unavailable"
                      ]
                    }
                  },
                  "cache": {
                    "type": "object",
                    "properties": {
                      "expiresAt": {
                        "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))$"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "hit",
                          "miss",
                          "not_used"
                        ]
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "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))$"
                  },
                  "purchaseEligible": {
                    "type": "boolean",
                    "const": false
                  },
                  "tld": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "markupConfigured": {
                    "type": "boolean",
                    "const": false
                  },
                  "purchaseBlockCode": {
                    "type": "string",
                    "const": "PRICE_RULE_UNCONFIGURED"
                  },
                  "status": {
                    "type": "string",
                    "const": "unconfigured"
                  }
                },
                "required": [
                  "cache",
                  "dataSource",
                  "observedAt",
                  "purchaseEligible",
                  "tld",
                  "markupConfigured",
                  "purchaseBlockCode",
                  "status"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "providerNotices": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "icp_filing_unavailable",
                        "local_presence_required",
                        "premium_unsupported",
                        "purchase_unavailable"
                      ]
                    }
                  },
                  "cache": {
                    "type": "object",
                    "properties": {
                      "expiresAt": {
                        "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))$"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "hit",
                          "miss",
                          "not_used"
                        ]
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "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))$"
                  },
                  "purchaseEligible": {
                    "type": "boolean",
                    "const": false
                  },
                  "tld": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "purchaseBlockCode": {
                    "type": "string",
                    "enum": [
                      "TLD_UNSUPPORTED",
                      "PRICE_NOT_OFFERED"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "const": "unsupported"
                  }
                },
                "required": [
                  "cache",
                  "dataSource",
                  "observedAt",
                  "purchaseEligible",
                  "tld",
                  "purchaseBlockCode",
                  "status"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "providerNotices": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "icp_filing_unavailable",
                        "local_presence_required",
                        "premium_unsupported",
                        "purchase_unavailable"
                      ]
                    }
                  },
                  "cache": {
                    "type": "object",
                    "properties": {
                      "expiresAt": {
                        "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))$"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "hit",
                          "miss",
                          "not_used"
                        ]
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "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))$"
                  },
                  "purchaseEligible": {
                    "type": "boolean",
                    "const": false
                  },
                  "tld": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 253
                  },
                  "problem": {
                    "type": "object",
                    "properties": {
                      "action": {
                        "type": "string",
                        "minLength": 1
                      },
                      "code": {
                        "type": "string",
                        "pattern": "^[A-Z][A-Z0-9_]*$"
                      },
                      "dataSource": {
                        "type": "string",
                        "minLength": 1
                      },
                      "detail": {
                        "type": "string",
                        "minLength": 1
                      },
                      "disabledReason": {
                        "type": "string",
                        "minLength": 1
                      },
                      "field": {
                        "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))$"
                      },
                      "message": {
                        "type": "string",
                        "minLength": 1
                      },
                      "operationStatus": {
                        "type": "string",
                        "enum": [
                          "failed",
                          "unknown",
                          "submitted",
                          "prepared"
                        ]
                      },
                      "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))$"
                      },
                      "retryable": {
                        "type": "boolean"
                      },
                      "retryAfterSeconds": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      "status": {
                        "type": "integer",
                        "minimum": 400,
                        "maximum": 599
                      },
                      "title": {
                        "type": "string",
                        "minLength": 1
                      },
                      "traceId": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9._:-]{8,128}$"
                      },
                      "type": {
                        "type": "string",
                        "pattern": "^urn:wanmi:problem:[A-Z][A-Z0-9_]*$"
                      }
                    },
                    "required": [
                      "action",
                      "code",
                      "detail",
                      "message",
                      "retryable",
                      "status",
                      "title",
                      "traceId",
                      "type"
                    ],
                    "additionalProperties": false
                  },
                  "purchaseBlockCode": {
                    "type": "string",
                    "const": "PRICE_QUERY_FAILED"
                  },
                  "status": {
                    "type": "string",
                    "const": "query_failed"
                  }
                },
                "required": [
                  "cache",
                  "dataSource",
                  "observedAt",
                  "purchaseEligible",
                  "tld",
                  "problem",
                  "purchaseBlockCode",
                  "status"
                ],
                "additionalProperties": false
              }
            ]
          }
        },
        "priceClass": {
          "type": "string",
          "const": "standard"
        },
        "tlds": {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 253
          }
        }
      },
      "required": [
        "items",
        "priceClass",
        "tlds"
      ],
      "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 联系支持。