一、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 | 获取列表异常 |