网络查询
查询域名 RDAP
GET
/rdap/domain公开访问
按 IANA dns.json 的最长域名后缀选择注册局，查询域名 RDAP。只使用 HTTPS，不查询 WHOIS。 访问类别：匿名 API，可携带 Token 使用独立额度
请求参数
namequery必填- ASCII 域名，最长 253 字符。忽略一个结尾点，不区分大小写。国际化域名请使用 Punycode。
- string · ASCII 域名，最长 253 字符。忽略一个结尾点，不区分大小写。国际化域名请使用 Punycode。 · 最短：1 字符 · 最长：253 字符 · 格式：^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)*[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.?$
rawquery- true 时在 raw 返回注册局原始 RDAP JSON
- string · true 时在 raw 返回注册局原始 RDAP JSON · 默认值："false" · 可选：true、false
响应
200 域名注册数据。成功结果缓存 300 秒。
application/json
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"domain",
"ip",
"asn"
]
},
"query": {
"type": "string"
},
"service": {
"type": "string",
"description": "命中的 IANA 引导项，例如 com、8.0.0.0/8 或 13312-15359"
},
"registry": {
"type": "string",
"description": "选中的 HTTPS RDAP 基址"
},
"objectClass": {
"type": "string"
},
"handle": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"status": {
"type": "array",
"items": {
"type": "string"
}
},
"dates": {
"type": "object",
"properties": {
"registration": {
"type": [
"string",
"null"
]
},
"expiration": {
"type": [
"string",
"null"
]
},
"lastChanged": {
"type": [
"string",
"null"
]
},
"lastUpdateOfRdap": {
"type": [
"string",
"null"
]
}
},
"required": [
"registration",
"expiration",
"lastChanged",
"lastUpdateOfRdap"
],
"description": "保留注册局返回的时间原文；缺失为 null"
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"action": {
"type": "string"
},
"date": {
"type": "string"
}
},
"required": [
"action",
"date"
]
}
},
"entities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"handle": {
"type": [
"string",
"null"
]
},
"roles": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": [
"string",
"null"
]
},
"kind": {
"type": [
"string",
"null"
]
}
},
"required": [
"handle",
"roles",
"name",
"kind"
]
}
},
"nameservers": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"ipv4": {
"type": "array",
"items": {
"type": "string"
}
},
"ipv6": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"ipv4",
"ipv6"
]
},
"description": "仅域名对象提供；IP 与 ASN 为 null"
},
"network": {
"type": [
"object",
"null"
],
"properties": {
"startAddress": {
"type": "string"
},
"endAddress": {
"type": "string"
},
"ipVersion": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"parentHandle": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
}
},
"required": [
"startAddress",
"endAddress",
"ipVersion",
"name",
"type",
"parentHandle",
"country"
]
},
"asn": {
"type": [
"object",
"null"
],
"properties": {
"start": {
"type": "integer"
},
"end": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
}
},
"required": [
"start",
"end",
"name",
"type",
"country"
]
},
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rel": {
"type": [
"string",
"null"
]
},
"href": {
"type": "string"
},
"type": {
"type": [
"string",
"null"
]
}
},
"required": [
"rel",
"href",
"type"
]
}
},
"raw": {
"description": "raw=true 时为注册局返回的 RDAP JSON；默认省略"
}
},
"required": [
"type",
"query",
"service",
"registry",
"objectClass",
"handle",
"name",
"status",
"dates",
"events",
"entities",
"nameservers",
"network",
"asn",
"links"
]
}400 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}401 凭据无效、停用、过期或缺少所需 Token
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}403 需要管理员 Token
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}404 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}413 请求体过大
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}415 请求内容类型无效
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}422 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}429 请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}500 内部执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}502 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}504 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}响应示例
运行命令前，将环境变量 BASE_URL 设置为站点地址。
成功响应
curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/rdap/domain?name=example.com&raw=false'
HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: public, max-age=300
{
"type": "domain",
"query": "example.com",
"service": "com",
"registry": "https://rdap.verisign.com/com/v1/",
"objectClass": "domain",
"handle": "2336799_DOMAIN_COM-VRSN",
"name": "EXAMPLE.COM",
"status": [
"client delete prohibited",
"client transfer prohibited",
"client update prohibited"
],
"dates": {
"registration": "1995-08-14T04:00:00Z",
"expiration": "2027-08-13T04:00:00Z",
"lastChanged": "2026-08-14T08:01:43Z",
"lastUpdateOfRdap": "2026-11-11T00:29:15Z"
},
"events": [
{
"action": "registration",
"date": "1995-08-14T04:00:00Z"
},
{
"action": "expiration",
"date": "2027-08-13T04:00:00Z"
},
{
"action": "last changed",
"date": "2026-08-14T08:01:43Z"
},
{
"action": "last update of RDAP database",
"date": "2026-11-11T00:29:15Z"
}
],
"entities": [
{
"handle": "376",
"roles": [
"registrar"
],
"name": "RESERVED-Internet Assigned Numbers Authority",
"kind": null
},
{
"handle": null,
"roles": [
"abuse"
],
"name": null,
"kind": null
}
],
"nameservers": [
{
"name": "ELLIOTT.NS.CLOUDFLARE.COM",
"ipv4": [],
"ipv6": []
},
{
"name": "HERA.NS.CLOUDFLARE.COM",
"ipv4": [],
"ipv6": []
}
],
"network": null,
"asn": null,
"links": [
{
"rel": "self",
"href": "https://rdap.verisign.com/com/v1/domain/example.com",
"type": "application/rdap+json"
}
]
}错误示例
curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/rdap/domain?name=invalid+value&raw=false'
HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store
{
"error": {
"code": "INVALID_INPUT",
"message": "参数无效",
"issues": [
{
"location": "query",
"field": "name",
"code": "invalid_format",
"message": "格式要求：/^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)*[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.?$/"
}
]
}
}在线调试
调用示例
curl -X GET 'https://oit.sh/rdap/domain?name=example.com'
响应
等待发送请求
配置上方请求参数后点击「发送请求」查看实时响应
快捷键：Ctrl / ⌘ + Enter