域名注册 购买二手域名

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

相关产品
域名注册 产品页,含版本规格、价格与购买入口。

一、1. 接口描述

接口用于预释放页面查询

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

二、2. 输入参数

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

参数名称 必选 类型 描述
Action 是 String 公共参数,本接口取值:DescribePreReleaseList。
Version 是 String 公共参数,本接口取值:2018-08-08。
Region 否 String 公共参数,本接口不需要传递此参数。
Keywords 否 String 单独使用Keywords:使用域名关键词进行搜索Keywords+DomainStart(true):使用域名开头关键词进行搜索Keywords+DomainEnd(true):使用域名结尾关键词进行搜索Keywords+DomainStart(true)+DomainEnd(true):使用域名开头或结尾关键词进行搜索示例值:tencent.com
DomainStart 否 Boolean 是否以域名开头关键词进行搜索true:是false:否示例值:true
DomainEnd 否 Boolean 是否以域名结尾关键词进行搜索true:是false:否示例值:true
Sort 否 Integer 不同排序规则:1: 价格升序2: 价格降序3: 域名升序4: 结束时间升序5: 店铺推荐升序6: 结束时间降序15: 创建时间升序其他:结束时间升序示例值:1
PriceStart 否 Float 起始价格示例值:100.00元
PriceEnd 否 Float 结束价格示例值:1000.00元
LengthStart 否 Integer 起始域名长度示例值:3
LengthEnd 否 Integer 结束域名长度示例值:4
PageNumber 否 Integer 页码(默认为1)示例值:1
PageSize 否 Integer 每页显示数(默认为20)示例值:20
Suffix.N 否 Array of Integer 后缀1="com"2="net"4="biz"6="info"7="co"9="cn"10="com.cn"11="wang"12="vip"13="cc"14="net.cn"15="org.cn"16="top"17="asia"18="tv"19="club"20="shop"21 ="中国"23="online"24="xyz"25="网店"26="网址"27="在线"28="ltd"29="fans"30="ren"31="icu"示例值:9
ClassOne 否 Integer 一级分类1:"纯数字"2:"单数字"3:"双数字"4:"三数字"5:"四数字"6:"五数字"7:"六数字"9:"单字母"10:"双字母"11:"三字母"12:"四字母"13:"五字母"14:"单拼"15:"双拼"16:"三拼"17:"杂米"18:"两杂"19:"三杂"20:"四杂"示例值:2
ClassTwo.N 否 Array of Integer 二级分类13:"0开或带4"14:"非0开不带4"15:"不带0,4"0:"非全声母"6:"全声母"16:"不带0,4"32:"全声母"5010:"CVCV"示例值:5
ClassThree.N 否 Array of Integer 三级分类111:"AAA"401:"3A及以上"402:"AA结尾"1122:"AABB"1123:"AABC"1212:"ABAB"1221:"ABBA"1233:"ABCC"501:"4A及以上"502:"3A及以上"503:"AAA开头"504:"AAA结尾"505:"AA开头"506:"AA结尾"507:"三顺子开头"508:"三顺子结尾"11223:"AABBC"12233:"ABBCC"601:"5A及以上"602:"4A及以上"603:"3A及以上"604:"4A开头"605:"4A结尾"606:"AAA开头"607:"AAA结尾"608:"AA开头"609:"AA结尾"610:"ABAB开头"611:"ABAB结尾"612:"AABB开头"613:"AABB结尾"614:"四顺子开头"615:"四顺子结尾"616:"三顺子开头"617:"三顺子结尾"121212:"ABABAB"112233:"AABBCC"123123:"ABCABC"211:"LNN"221:"LLN"121:"NLN"212:"LNL"122:"NLL"1112:"NNNL"2111:"LNNN"1212:"NLNL"2121:"LNLN"1222:"NLLL"2221:"LLLN"1122:"NNLL"2211:"LLNN"31:"W结尾"112:"AAB"122:"ABB"121:"ABA"41:"W结尾"1112:"AAAB"1222:"ABBB"1122:"AABB"1212:"ABAB"示例值:10
ClassFour.N 否 Array of Integer 四级分类1:"仅含2种数字"2:"仅含3种数字"4:"仅含1种字母"8:"仅含1种数字"示例值:6
FilterStart 否 Boolean 是否以域名开头排除关键词进行搜索示例值:true
FilterEnd 否 Boolean 是否以域名结尾排除关键词进行搜索示例值:true
FilterWords 否 String 域名排除关键词单独使用FilterWords:使用排除关键词进行搜索FilterWords+FilterStart(true):使用域名开头排除关键词进行搜索FilterWords+FilterEnd(true):使用域名结尾排除关键词进行搜索FilterWords+FilterStart(true)+FilterEnd(true):使用域名开头或结尾排除关键词进行搜索示例值:tencent
TransType 否 Integer 交易类型(目前只支持10)10: 预释放域名示例值:10
IsTop 否 Boolean 是否搜索白金域名(默认值为false)示例值:false
EndTimeSort 否 String 结束时间排序 desc:倒序 asc:正序示例值:desc
EndTime 否 String 结束时间(YYYY-MM-DD)示例值:2006-01-02

三、3. 输出参数

参数名称 类型 描述
TotalCount Integer 数量示例值:10
PreReleaseList Array of PreReleaseInfo 预释放列表示例值:[{"Domain":"pvpn.com","ReservationTime":"2025-04-25 16:38:51","RegTime":"2003-03-26 17:38:51","DelTime":"2025-05-26 16:38:51","CurrentPeople":8,"Price":198,"IsFollow":false,"IsAppoint":false,"BusinessId":"P0011744807158035431","IsDomainUser":false}]
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

四、示例1 请求成功示例

列表数据

五、输入示例

POST / HTTP/1.1
Host: domain.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribePreReleaseList
<公共请求参数>
{}

六、输出示例

{
"Response": {
"PreReleaseList": [
{
"BusinessId": "P0011703064185349649",
"CurrentPeople": 1,
"DelTime": "2024-01-16 00:00:00",
"Domain": "099hq.net",
"IsAppoint": false,
"IsFollow": false,
"Price": 102,
"RegTime": "2020-01-01 00:00:00",
"ReservationTime": "2023-12-31 07:32:05"
},
{
"BusinessId": "P0011703067801554141",
"CurrentPeople": 1,
"DelTime": "2024-01-16 00:00:00",
"Domain": "095hq.net",
"IsAppoint": false,
"IsFollow": false,
"Price": 102,
"RegTime": "2020-01-01 00:00:00",
"ReservationTime": "2023-12-31 07:32:05"
},
{
"BusinessId": "P0011702284530637838",
"CurrentPeople": 2,
"DelTime": "2024-01-16 00:00:00",
"Domain": "091hq.net",
"IsAppoint": false,
"IsFollow": false,
"Price": 102,
"RegTime": "2020-01-01 00:00:00",
"ReservationTime": "2023-12-31 07:32:05"
}
],
"RequestId": "543393c3-28c3-4de0-8535-1256fe004410",
"TotalCount": 3
}
}

七、腾讯云 API 平台

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

八、API Inspector

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

九、SDK

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

·Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

十、命令行工具

·Tencent Cloud CLI 3.0

十一、6. 错误码

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

错误码 描述
FailedOperation.DescribePreReleaseList 获取列表异常
赞 (0)
上一篇 5天前
下一篇 5天前