有奖:语音产品征文挑战赛火热进行中> HOT

1. 接口描述

接口请求域名: dnspod.tencentcloudapi.com 。

获取域名Whois信息

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeDomainWhois。
Version String 公共参数,本接口取值:2021-03-23。
Region String 公共参数,本接口不需要传递此参数。
Domain String 域名
示例值:dnspod.cn

3. 输出参数

参数名称 类型 描述
Info WhoisInfo 域名Whois信息
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 获取域名Whois信息

获取域名Whois信息

输入示例

{
  "Domain": "dnspod.cn"
}

输出示例

{
    "Response": {
        "Info": {
            "Contacts": {
                "Admin": {
                    "City": "REDACTED FOR PRIVACY",
                    "Country": "REDACTED FOR PRIVACY",
                    "Email": "Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn",
                    "Fax": "REDACTED FOR PRIVACY",
                    "FaxExt": "REDACTED FOR PRIVACY",
                    "Handle": "REDACTED FOR PRIVACY",
                    "Name": "REDACTED FOR PRIVACY",
                    "Organization": "REDACTED FOR PRIVACY",
                    "Phone": "REDACTED FOR PRIVACY ext. REDACTED FOR PRIVACY",
                    "PostalCode": null,
                    "State": "REDACTED FOR PRIVACY",
                    "Street": "REDACTED FOR PRIVACY"
                },
                "Billing": {
                    "City": "REDACTED FOR PRIVACY",
                    "Country": "REDACTED FOR PRIVACY",
                    "Email": "Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn",
                    "Fax": null,
                    "FaxExt": null,
                    "Handle": "REDACTED FOR PRIVACY",
                    "Name": "REDACTED FOR PRIVACY",
                    "Organization": "REDACTED FOR PRIVACY",
                    "Phone": "REDACTED FOR PRIVACY",
                    "PostalCode": null,
                    "State": "REDACTED FOR PRIVACY",
                    "Street": "REDACTED FOR PRIVACY"
                },
                "Registrant": {
                    "City": "REDACTED FOR PRIVACY",
                    "Country": "CN",
                    "Email": "Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn",
                    "Fax": "REDACTED FOR PRIVACY",
                    "FaxExt": "REDACTED FOR PRIVACY",
                    "Handle": "REDACTED FOR PRIVACY",
                    "Name": "REDACTED FOR PRIVACY",
                    "Organization": "REDACTED FOR PRIVACY",
                    "Phone": "REDACTED FOR PRIVACY ext. REDACTED FOR PRIVACY",
                    "PostalCode": null,
                    "State": null,
                    "Street": "REDACTED FOR PRIVACY"
                },
                "Tech": null
            },
            "CreationDate": "2020-04-12 13:30:07",
            "ExpirationDate": "2023-04-12 13:30:07",
            "IsQcloud": true,
            "IsQcloudOwner": true,
            "NameServers": [
                "hannah.dnspod.net",
                "perch.dnspod.net"
            ],
            "Raw": [
                "Domain Name: dnspod.cn\nRegistry Domain ID: 2513768290_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: whois.dnspod.com\nRegistrar URL: https://www.dnspod.com\nUpdated Date: 2022-04-01 14:44:21\nCreation Date: 2020-04-12 13:30:07\nRegistry Expiry Date: 2023-04-12 13:30:07\nRegistrar: DNSPod, Inc.\nRegistrar IANA ID: 1697\nRegistrar Abuse Contact Email: abuse@dnspod.com\nRegistrar Abuse Contact Phone: +86.95716\nDomain Status: ok https://www.icann.org/epp#ok\nRegistry Registrant ID: REDACTED FOR PRIVACY\nRegistrant Name: REDACTED FOR PRIVACY\nRegistrant Organization: REDACTED FOR PRIVACY\nRegistrant Street: REDACTED FOR PRIVACY\nRegistrant City: REDACTED FOR PRIVACY\nRegistrant State/Province: \nRegistrant Postal Code: REDACTED FOR PRIVACY\nRegistrant Country: CN\nRegistrant Phone: REDACTED FOR PRIVACY\nRegistrant Phone Ext: REDACTED FOR PRIVACY\nRegistrant Fax: REDACTED FOR PRIVACY\nRegistrant Fax Ext: REDACTED FOR PRIVACY\nRegistrant Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nRegistry Admin ID: REDACTED FOR PRIVACY\nAdmin Name: REDACTED FOR PRIVACY\nAdmin Organization: REDACTED FOR PRIVACY\nAdmin Street: REDACTED FOR PRIVACY\nAdmin City: REDACTED FOR PRIVACY\nAdmin State/Province: REDACTED FOR PRIVACY\nAdmin Postal Code: REDACTED FOR PRIVACY\nAdmin Country: REDACTED FOR PRIVACY\nAdmin Phone: REDACTED FOR PRIVACY\nAdmin Phone Ext: REDACTED FOR PRIVACY\nAdmin Fax: REDACTED FOR PRIVACY\nAdmin Fax Ext: REDACTED FOR PRIVACY\nAdmin Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nRegistry Tech ID: REDACTED FOR PRIVACY\nTech Name: REDACTED FOR PRIVACY\nTech Organization: REDACTED FOR PRIVACY\nTech Street: REDACTED FOR PRIVACY\nTech State/Province: REDACTED FOR PRIVACY\nTech Postal Code: REDACTED FOR PRIVACY\nTech Country: REDACTED FOR PRIVACY\nTech Phone: REDACTED FOR PRIVACY\nTech Phone Ext: REDACTED FOR PRIVACY\nTech Fax: REDACTED FOR PRIVACY\nTech Fax Ext: REDACTED FOR PRIVACY\nTech Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nRegistry Billing ID: REDACTED FOR PRIVACY\nBilling Name: REDACTED FOR PRIVACY\nBilling Organization: REDACTED FOR PRIVACY\nBilling Street: REDACTED FOR PRIVACY\nBilling City: REDACTED FOR PRIVACY\nBilling State/Province: REDACTED FOR PRIVACY\nBilling Postal Code: REDACTED FOR PRIVACY\nBilling Country: REDACTED FOR PRIVACY\nBilling Phone: REDACTED FOR PRIVACY\nBilling Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nName Server:hannah.dnspod.net\nName Server:perch.dnspod.net\nDNSSEC: unsigned\nURL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net\n>>>Last update of WHOIS database: 2023-02-09T19:00:00Z <<<\n\n\nFor more information on Whois status codes, please visit https://icann.org/epp\n\n\nThe data in this whois database is provided to you for information\npurposes only, that is, to assist you in obtaining information about or\nrelated to a domain name registration record. We make this information\navailable \"as is,\" and do not guarantee its accuracy. By submitting a\nwhois query, you agree that you will use this data only for lawful\npurposes and that, under no circumstances will you use this data to: (1)\nenable high volume, automated, electronic processes that stress or load\nthis whois database system providing you this information; or (2) allow,\nenable, or otherwise support the transmission of mass unsolicited,\ncommercial advertising or solicitations via direct mail, electronic\nmail, or by telephone. The compilation, repackaging, dissemination or\nother use of this data is expressly prohibited without prior written\nconsent from us.\n\n",
                "Domain Name: dnspod.cn\nRegistry Domain ID: 2513768290_DOMAIN_COM-VRSN\nRegistrar WHOIS Server: whois.dnspod.com\nRegistrar URL: https://www.dnspod.com\nUpdated Date: 2022-04-01 14:44:21\nCreation Date: 2020-04-12 13:30:07\nRegistry Expiry Date: 2023-04-12 13:30:07\nRegistrar: DNSPod, Inc.\nRegistrar IANA ID: 1697\nRegistrar Abuse Contact Email: abuse@dnspod.com\nRegistrar Abuse Contact Phone: +86.95716\nDomain Status: ok https://www.icann.org/epp#ok\nRegistry Registrant ID: REDACTED FOR PRIVACY\nRegistrant Name: REDACTED FOR PRIVACY\nRegistrant Organization: REDACTED FOR PRIVACY\nRegistrant Street: REDACTED FOR PRIVACY\nRegistrant City: REDACTED FOR PRIVACY\nRegistrant State/Province: \nRegistrant Postal Code: REDACTED FOR PRIVACY\nRegistrant Country: CN\nRegistrant Phone: REDACTED FOR PRIVACY\nRegistrant Phone Ext: REDACTED FOR PRIVACY\nRegistrant Fax: REDACTED FOR PRIVACY\nRegistrant Fax Ext: REDACTED FOR PRIVACY\nRegistrant Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nRegistry Admin ID: REDACTED FOR PRIVACY\nAdmin Name: REDACTED FOR PRIVACY\nAdmin Organization: REDACTED FOR PRIVACY\nAdmin Street: REDACTED FOR PRIVACY\nAdmin City: REDACTED FOR PRIVACY\nAdmin State/Province: REDACTED FOR PRIVACY\nAdmin Postal Code: REDACTED FOR PRIVACY\nAdmin Country: REDACTED FOR PRIVACY\nAdmin Phone: REDACTED FOR PRIVACY\nAdmin Phone Ext: REDACTED FOR PRIVACY\nAdmin Fax: REDACTED FOR PRIVACY\nAdmin Fax Ext: REDACTED FOR PRIVACY\nAdmin Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nRegistry Tech ID: REDACTED FOR PRIVACY\nTech Name: REDACTED FOR PRIVACY\nTech Organization: REDACTED FOR PRIVACY\nTech Street: REDACTED FOR PRIVACY\nTech State/Province: REDACTED FOR PRIVACY\nTech Postal Code: REDACTED FOR PRIVACY\nTech Country: REDACTED FOR PRIVACY\nTech Phone: REDACTED FOR PRIVACY\nTech Phone Ext: REDACTED FOR PRIVACY\nTech Fax: REDACTED FOR PRIVACY\nTech Fax Ext: REDACTED FOR PRIVACY\nTech Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nRegistry Billing ID: REDACTED FOR PRIVACY\nBilling Name: REDACTED FOR PRIVACY\nBilling Organization: REDACTED FOR PRIVACY\nBilling Street: REDACTED FOR PRIVACY\nBilling City: REDACTED FOR PRIVACY\nBilling State/Province: REDACTED FOR PRIVACY\nBilling Postal Code: REDACTED FOR PRIVACY\nBilling Country: REDACTED FOR PRIVACY\nBilling Phone: REDACTED FOR PRIVACY\nBilling Email: Select Contact Domain Holder link at https://whois.cloud.tencent.com/domain?domain=dnspod.cn\nName Server:hannah.dnspod.net\nName Server:perch.dnspod.net\nDNSSEC: unsigned\nURL of the ICANN WHOIS Data Problem Reporting System: http://wdprs.internic.net\n>>>Last update of WHOIS database: 2023-02-09T19:00:00Z <<<\n\n\nFor more information on Whois status codes, please visit https://icann.org/epp\n\n\nThe data in this whois database is provided to you for information\npurposes only, that is, to assist you in obtaining information about or\nrelated to a domain name registration record. We make this information\navailable \"as is,\" and do not guarantee its accuracy. By submitting a\nwhois query, you agree that you will use this data only for lawful\npurposes and that, under no circumstances will you use this data to: (1)\nenable high volume, automated, electronic processes that stress or load\nthis whois database system providing you this information; or (2) allow,\nenable, or otherwise support the transmission of mass unsolicited,\ncommercial advertising or solicitations via direct mail, electronic\nmail, or by telephone. The compilation, repackaging, dissemination or\nother use of this data is expressly prohibited without prior written\nconsent from us.\n\n",
                "   Domain Name: dnspod.cn\n   Registry Domain ID: 2513768290_DOMAIN_COM-VRSN\n   Registrar WHOIS Server: whois.dnspod.cn\n   Registrar URL: http://www.dnspod.cn\n   Updated Date: 2022-04-01T06:44:18Z\n   Creation Date: 2020-04-12T13:30:07Z\n   Registry Expiry Date: 2023-04-12T13:30:07Z\n   Registrar: DNSPod, Inc.\n   Registrar IANA ID: 1697\n   Registrar Abuse Contact Email: abuse@dnspod.com\n   Registrar Abuse Contact Phone: +86.4009100100\n   Domain Status: ok https://icann.org/epp#ok\n   Name Server: HANNAH.DNSPOD.NET\n   Name Server: PERCH.DNSPOD.NET\n   DNSSEC: unsigned\n   URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/\n>>> Last update of whois database: 2023-02-10T03:06:58Z <<<\n\nFor more information on Whois status codes, please visit https://icann.org/epp\n\nNOTICE: The expiration date displayed in this record is the date the\nregistrar's sponsorship of the domain name registration in the registry is\ncurrently set to expire. This date does not necessarily reflect the expiration\ndate of the domain name registrant's agreement with the sponsoring\nregistrar.  Users may consult the sponsoring registrar's Whois database to\nview the registrar's reported date of expiration for this registration.\n\nTERMS OF USE: You are not authorized to access or query our Whois\ndatabase through the use of electronic processes that are high-volume and\nautomated except as reasonably necessary to register domain names or\nmodify existing registrations; the Data in VeriSign Global Registry\nServices' (\"VeriSign\") Whois database is provided by VeriSign for\ninformation purposes only, and to assist persons in obtaining information\nabout or related to a domain name registration record. VeriSign does not\nguarantee its accuracy. By submitting a Whois query, you agree to abide\nby the following terms of use: You agree that you may use this Data only\nfor lawful purposes and that under no circumstances will you use this Data\nto: (1) allow, enable, or otherwise support the transmission of mass\nunsolicited, commercial advertising or solicitations via e-mail, telephone,\nor facsimile; or (2) enable high volume, automated, electronic processes\nthat apply to VeriSign (or its computer systems). The compilation,\nrepackaging, dissemination or other use of this Data is expressly\nprohibited without the prior written consent of VeriSign. You agree not to\nuse electronic processes that are automated and high-volume to access or\nquery the Whois database except as reasonably necessary to register\ndomain names or modify existing registrations. VeriSign reserves the right\nto restrict your access to the Whois database in its sole discretion to ensure\noperational stability.  VeriSign may restrict or terminate your access to the\nWhois database for failure to abide by these terms of use. VeriSign\nreserves the right to modify these terms at any time.\n\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\nRegistrars.\n"
            ],
            "Registrar": [
                "DNSPod, Inc."
            ],
            "Status": [
                "ok https://icann.org/epp#ok"
            ],
            "UpdatedDate": "2022-04-01 14:44:21"
        },
        "RequestId": "f9f630a2-ef8d-42cf-9abb-5c63479464f3"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation 操作失败。
FailedOperation.UnknowError 操作未响应,请稍后重试。
InvalidParameter.DomainIdInvalid 域名编号不正确。
InvalidParameter.DomainInvalid 域名不正确,请输入主域名,如 dnspod.cn。
InvalidParameter.DomainIsAliaser 此域名是其它域名的别名。
InvalidParameterValue.DomainNotExists 当前域名有误,请返回重新操作。
OperationDenied.DomainOwnerAllowedOnly 仅域名所有者可进行此操作。
OperationDenied.NoPermissionToOperateDomain 当前域名无权限,请返回域名列表。