查詢域名配置信息詳情
更新時間 2025-08-08 14:04:03
最近更新時間: 2025-08-08 14:04:03
分享文章
接口描述:調用本接口查詢某域名配置信息
請求方式:get
請求路徑:/domain/query-domain-detail
使用說明:單個用戶一分鐘限制調用10000次,并發不超過100
請求參數說明:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| product_code | string | 否 | 產品類型 | 產品類型,支持:“001”(靜態加速),“003”:(下載加速), “004”(視頻點播加速),“008”(CDN加速),“014”(下載加速閑時) |
| domain | string | 是 | 域名 | |
| function_names | string | 否 | 功能函數名稱 | 若該參數不傳,則默認返回的是該域名全部功能的配置參數,若傳該參數,則返回指定功能的配置信息,多個功能用英文逗號分割,若該參數未配置,可能返回為空,目前支持參數:black_referer(referer黑名單),white_referer(referer白名單),filetype_ttl(文件過期時間設置),ip_black_list(ip黑名單),ip_white_list(ip白名單),req_headers(自定義回源請求頭),resp_headers(自定義響應頭),req_host(回源host),error_code(錯誤碼緩存配置),shared_host(共享緩存域名) |
返回參數說明:
| 參數 | 類型 | 是否必填 | 名稱及描述 |
|---|---|---|---|
| code | int | 是 | 狀態碼,成功100000 |
| message | string | 是 | 描述信息,成功返回success,其他返回異常信息描述 |
| domain | string | 否 | 域名 |
| status | int | 否 | 域名狀態,4(已啟用);6(已停止)。域名詳情只返回域名的確定狀態,過程中的狀態不會返回。 |
| product_code | string | 否 | 產品類型,“001”(靜態加速),“003”:(下載加速), “004”(視頻點播加速),“008”(CDN加速),“014”(下載加速閑時) |
| area_scope | int | 否 | 加速范圍 |
| cname | string | 否 | cname |
| insert_date | string | 否 | 創建時間,單位毫秒 |
| status_date | string | 否 | 修改時間,單位毫秒 |
| ipv6_enable | int | 否 | ipv6啟用,1(啟用 );2(關閉) |
| record_num | string | 否 | 備案號 |
| record_status | string | 否 | 備案狀態,false(未備案);ture(已備案) |
| origin_host_type | int | 否 | 主備源攜帶不同的回源host是否開啟,0(關閉);1(開啟) |
| origin_protocol | string | 否 | 回源協議,http(用http協議回源);https(用https協議回源);follow_request(跟隨訪問協議進行回源) |
| origin | list< object> | 否 | 源站信息 |
| origin[*].origin | string | 否 | 源站ip或域名 |
| origin[*].port | int | 否 | 源站端口 |
| origin[*].weight | int | 否 | 權重 |
| origin[*].role | string | 否 | 源站角色 |
| origin[*].protocol | string | 否 | 源站類型 |
| xos_origin_is | int | 否 | 是否開啟云存儲XOS源站配置功能 |
| xos_origin | object | 否 | 云存儲XOS源站信息 |
| xos_origin[*].origin | string | 是 | 云存儲XOS源站 |
| xos_origin[*].ak | string | 否 | 云存儲XOS源站加密ak |
| xos_origin[*].sk | string | 否 | 云存儲XOS源站加密sk |
| black_referer | object | 否 | referer黑名單 |
| black_referer.allow_list | list< string> | 否 | referer黑名單列表 |
| black_referer.allow_empty | string | 否 | 是否允許為空,“on”(允許為空); “off”(不允許為空) |
| black_referer_condition | dict | 否 | referer黑名單condition |
| white_referer | object | 否 | referer白名單 |
| white_referer.allow_list | list< string> | 否 | referer白名單列表 |
| white_referer.allow_empty | string | 否 | 是否允許為空,“on”(允許為空); “off”(不允許為空) |
| white_referer_condition | dict | 否 | referer白名單condition |
| filetype_ttl | list< object> | 否 | 文件過期時間設置 |
| filetype_ttl[*].file_type | string | 否 | 緩存文件類型,多個以逗號隔開 |
| filetype_ttl[*].ttl | int | 否 | 緩存時間,單位秒 |
| filetype_ttl[*].cache_type | int | 否 | 緩存類型, 1(不緩存);2(優先遵循源站);3(強制緩存) |
| filetype_ttl[*].cache_with_args | int | 否 | 是否帶參數緩存,0(不帶參數緩存);1(帶參數緩存) |
| filetype_ttl[*].mode | int | 否 | 模式, 0(文件后綴);1(目錄);2(首頁); 3(全部文件);4(全路徑);5(正則),不傳默認0 |
| filetype_ttl[*].priority | int | 否 | 優先級 |
| req_headers | list< object> | 否 | 自定義回源請求頭 |
| req_headers[*].key | string | 否 | 自定義回源請求頭名稱 |
| req_headers[*].value | string | 否 | 自定義回源請求頭值 |
| resp_headers | list< object> | 否 | 自定義響應頭 |
| resp_headers[*].key | string | 否 | 自定義響應頭名稱 |
| resp_headers[*].value | string | 否 | 自定義響應頭值 |
| basic_conf | object | 否 | http配置基礎信息 |
| basic_conf.follow302 | int | 否 | 是否拉取跳轉后文件,0(否);1(是) |
| basic_conf.use_http2 | int | 否 | 是否開啟http2,0(不開啟);1(開啟),該字段只有在證書開啟狀態下才會有效 |
| basic_conf.http_origin_port | int | 否 | http請求回源端口 |
| error_code | list< object> | 否 | 錯誤碼緩存配置 |
| error_code[*].code | string | 否 | 錯誤狀態碼 |
| error_code[*].ttl | int | 否 | 緩存時間,單位秒 |
| user_agent | object | 否 | user_agent黑白名單配置 |
| user_agent.type | int | 否 | 類型,0:(黑名單); 1( 白名單) |
| user_agent.ua | list< string> | 否 | user_agent列表 |
| https_status | string | 否 | 是否開啟https,on、off |
| cert_name | string | 否 | 國際證書備注名 |
| cert_name_gm | string | 否 | 國密證書備注名 |
| https_basic | object | 否 | https基礎配置 |
| https_basic.https_force | string | 否 | https強制跳轉,“on”(跳轉);“off”(不跳轉) |
| https_basic.http_force | string | 否 | http強制跳轉,“on”(跳轉);“off”(不跳轉) |
| https_basic.force_status | string | 否 | 強制跳轉狀態碼 |
| https_basic.origin_protocol | string | 否 | https回源協議,http(用http協議回源);https(用https協議回源);follow_request(跟隨訪問協議進行回源) |
| gzip | object | 否 | 壓縮功能 |
| gzip.min_length | string | 否 | 壓縮文件大小 |
| gzip.file_type | string | 否 | 壓縮文件類型 |
| gzip.type | int | 否 | 壓縮類型,0(gzip);1(brotli) |
| remote_sync_auth | list< object> | 否 | 遠程同步鑒權客戶自助 |
| remote_sync_auth[*].id | string | 否 | 主鍵id |
| remote_sync_auth[*].priority | int | 否 | 優先級 |
| remote_sync_auth[*].auth_host | list< string> | 否 | 鑒權源站 |
| remote_sync_auth[*].try_next_remote_server_when | string | 否 | 鑒權源站重試狀態碼 |
| remote_sync_auth[*].subject | string | 否 | subject |
| remote_sync_auth[*].pattern | string | 否 | pattern |
| remote_sync_auth[*].replace | string | 否 | replace |
| remote_sync_auth[*].use_original_request_args | string | 否 | 是否使用原始請求參數 |
| remote_sync_auth[*].use_main_request_args_type | string | 否 | 使用原始請求參數類型 |
| remote_sync_auth[*].use_main_request_args | list< object> | 否 | 請求參數 |
| remote_sync_auth[*].use_main_request_args[].arg_name | string | 否 | 請求參數key |
| remote_sync_auth[*].use_main_request_args[].arg_value | string | 否 | 請求參數value |
| remote_sync_auth[*].use_original_request_headers | string | 否 | 是否使用原始請求頭 |
| remote_sync_auth[*].use_main_request_headers_type | string | 否 | 使用原始請求頭類型 |
| remote_sync_auth[*].use_main_request_headers | list< object> | 否 | 請求頭 |
| remote_sync_auth[*].use_main_request_headers[].arg_name | string | 否 | 請求頭key |
| remote_sync_auth[*].use_main_request_headers[].arg_value | string | 否 | 請求頭value |
| remote_sync_auth[*].auth_scheme | string | 否 | 請求協議 |
| remote_sync_auth[*].auth_port | int | 否 | 請求端口 |
| remote_sync_auth[*].auth_method | string | 否 | 請求方法 |
| remote_sync_auth[*].auth_body_data | string | 否 | 請求體 |
| remote_sync_auth[*].auth_timeout | float | 否 | 鑒權超時時間,單位秒 |
| remote_sync_auth[*].auth_connection_pool_size | int | 否 | 鑒權服務端連接池大小 |
| remote_sync_auth[*].auth_connection_idle_time | int | 否 | 連接空閑超時時間 |
| remote_sync_auth[*].auth_timeout_pass | string | 否 | 鑒權超時是否通過,取值:on:是,off:否 |
| remote_sync_auth[*].auth_error_pass | string | 否 | 鑒權出錯是否通過,取值:on:是,off |
| remote_sync_auth[*].auth_respond_action | string | 否 | 鑒權狀態碼黑白名單,白名單 “allow” 或 黑名單 “deny” |
| remote_sync_auth[*].auth_respond_status | list< int> | 否 | 狀態碼 |
| remote_sync_auth[*].forbidden_code_state | string | 否 | 鑒權不通過時狀態碼設置 |
| remote_sync_auth[*].forbidden_code | int | 否 | 固定狀態碼 |
| remote_sync_auth[*].response_json_to_var | object | 否 | 基于json鑒權 |
| remote_sync_auth[*].response_json_to_var.switch | int | 否 | 0關,1開 |
| remote_sync_auth[*].response_json_to_var.json_var_list | list< object> | 否 | json數據 |
| remote_sync_auth[*].response_json_to_var.json_var_list[].arg_name | string | 否 | 變量名 |
| remote_sync_auth[*].response_json_to_var.json_var_list[].arg_value | string | 否 | 變量值 |
| remote_sync_auth[*].response_json_to_var.forbidden_code | int | 否 | 鑒權不通過狀態碼 |
| remote_sync_auth_condition | object | 否 | 遠程同步鑒權condition,{“key”:[{“mode”:類型, “content”:“配置內容,多個以逗號間隔”}]}, mode取值:默認0, 0:文件后綴 1:目錄 2: 首頁 3: 全部文件 4: 全路徑 key為remote_sync_auth中的id |
| ip_black_list | string | 否 | ip黑名單 |
| ip_white_list | string | 否 | ip白名單 |
| req_host | string | 否 | 回源host |
| shared_host | string | 否 | 共享緩存域名 |
| limit_speed_uri | list< object> | 否 | 基于url參數限速 |
| limit_speed_uri[*].id | string | 否 | limit_speed_uri列表內唯一 |
| limit_speed_uri[*].unit | string | 否 | 單位 |
| limit_speed_uri[*].args | string | 否 | uri參數名 |
| limit_speed_uri[*].time_seg | string | 否 | 時段 |
| limit_speed_uri[*].weight | int | 否 | 優先級 |
| limit_speed_uri_condition | object | 否 | limit_speed_uri的condition配置 |
| limit_speed_const | list< object> | 否 | 基于固定值限速 |
| limit_speed_const[*].id | string | 否 | 基于固定值限速唯一標識,limit_speed_const列表內唯一 |
| limit_speed_const[*].rate | int | 否 | 限速值 |
| limit_speed_const[*].time_seg | string | 否 | 時段 |
| limit_speed_const[*].unit | string | 否 | 單位 |
| limit_speed_const[*].weight | int | 否 | 優先級 |
| limit_speed_const_condition | object | 否 | limit_speed_const的condition配置 |
| backorigin_uri_rewrite_condition | object | 否 | 回源uri改寫condition配置 |
| md5_secure_time | list< object> | 否 | md5時間戳防盜鏈 |
| md5_secure_time[*].delim_time_char | string | 否 | md5加密方式分隔符 |
| md5_secure_time[*].element | list< object> | 否 | 加密元素設置 |
| md5_secure_time[*].forbidden_code | int | 否 | 校驗不通過狀態碼,默認403 |
| md5_secure_time[*].id | string | 否 | 配置名,唯一標識 |
| md5_secure_time[*].md5_arg | string | 否 | md5校驗參數名稱 |
| md5_secure_time[*].md5_forbidden_code | int | 否 | md5校驗不通過狀態碼 |
| md5_secure_time[*].md5_path | int | 否 | md5校驗碼位置 |
| md5_secure_time[*].md5_path_custom | string | 否 | 自定義目錄 |
| md5_secure_time[*].md5_path_level | int | 否 | 目錄級別 |
| md5_secure_time[*].md5_pattern | string | 否 | md5模式名稱 |
| md5_secure_time[*].md5_replace | string | 否 | md5替代內容 |
| md5_secure_time[*].md5_switch | int | 否 | md5校驗開關 |
| md5_secure_time[*].priority | int | 否 | 權重 |
| md5_secure_time[*].time_arg | string | 否 | 參數名稱 |
| md5_secure_time[*].time_format | int | 否 | 時間戳格式 |
| md5_secure_time[*].time_lower_limit | int | 否 | 可訪問起始時長 |
| md5_secure_time[*].time_md5_length | int | 否 | md5校驗長度 |
| md5_secure_time[*].time_md5_start | int | 否 | md5校驗起始位置 |
| md5_secure_time[*].time_path | int | 否 | 時間戳位置 |
| md5_secure_time[*].time_path_custom | string | 否 | 自定義目錄 |
| md5_secure_time[*].time_path_level | int | 否 | 目錄級別 |
| md5_secure_time[*].time_pattern | string | 否 | time模式名稱 |
| md5_secure_time[*].time_replace | string | 否 | time替代內容 |
| md5_secure_time[*].time_switch | int | 否 | 時間戳校驗開關 |
| md5_secure_time[*].time_upper_limit | int | 否 | 時間戳有效期 |
| md5_secure_time_condition | object | 否 | 加密元素condition設置 |
| gzip_condition | object | 否 | 文件壓縮condition配置 |
| backorigin_uri_rewrite | object | 否 | 回源uri改寫 |
| ssl | string | 否 | ssl協議類型,支持TLSv1 、TLSv1.1 、TLSv1.2 、TLSv1.3 ,僅在https_status為on時才生效 |
| ssl_stapling | string | 否 | ocsp stapling開關,on(開啟),off(關閉),僅在https_status為on時才生效 |
| cus_gzip | list< object> | 否 | 文件壓縮 |
| cus_gzip[*].id | string | 否 | id |
| cus_gzip[*].min_length | string | 否 | 壓縮文件大小 |
| cus_gzip[*].file_type | string | 否 | 壓縮文件類型 |
| cus_gzip[*].type | int | 否 | 壓縮類型,取值:0(gzip),1(brotli) |
| cus_gzip[*].http_version | string | 否 | http_version,取值:1.1 ,1.0 |
| cus_gzip[*].vary | string | 否 | gzip_vary,取值:on(開啟),off(關閉) |
| cus_gzip[*].max_length | string | 否 | 最大文件大小 |
| cus_gzip_condition | dict | 否 | 文件壓縮condition配置,{“key”:[{“mode”:類型, “content”:“配置內容,多個以逗號間隔”}]}, mode取值:默認0, 0:文件后綴 1:目錄 2: 首頁 3: 全部文件 4: 全路徑。key為cus_gzip中的id |
| entry_limits | list< object> | 否 | 限頻自助參數 |
| entry_limits[*].id | string | 否 | 唯一id |
| entry_limits[*].limit_element | string | 否 | 限制參數 |
| entry_limits[*].frequency_threshold | int | 否 | 訪問次數限制閾值 |
| entry_limits[*].frequency_time_range | int | 否 | 統計周期 |
| entry_limits[*].forbidden_duration | int | 否 | 拒絕訪問時間 |
| entry_limits[*].forbidden_duration_unit | string | 否 | 拒絕訪問時間單位,取值范圍:[s,millis],默認s |
| entry_limits[*].forbidden_code | int | 否 | 封禁http訪問碼 |
| entry_limits[*].white_ip_control | list< string> | 否 | 不執行校驗的客戶端ip |
| entry_limits[*].priority | int | 否 | 優先級 |
| entry_limits_condition | dict | 否 | 限頻自助參condition配置,,{“key”:[{“mode”:類型, “content”:“配置內容,多個以逗號間隔”}]}, mode取值:默認0, 0:文件后綴 1:目錄 2: 首頁 3: 全部文件 4: 全路徑。key為entry_limits中的id |
| cachekey_args | list< object> | 否 | 緩存參數 |
| cachekey_args[*].id | string | 是 | 基于緩存參數唯一標識 |
| cachekey_args[*].ignore | int | 否 | 去參數緩存開關。取值:0:否,1 是 |
| cachekey_args[*].is_with_args | int | 否 | 帶特定參數緩存。取值:0:否,1 是 |
| cachekey_args[*].mode | int | 否 | 匹配方式。取值:0:否,1 是 |
| cachekey_args[*].args | string | 否 | 匹配方式為0時配置的參數 |
| cachekey_args[*].subject | string | 否 | 匹配方式為1時配置,目前沒用 |
| cachekey_args[*].pattern | string | 否 | 匹配方式為1時配置,目前沒用 |
| cachekey_args[*].replace | string | 否 | 匹配方式為1時配置,目前沒用 |
| cachekey_args[*].priority | int | 否 | 優先級,取值范圍[1,100] |
| cachekey_args[*].ignore_args | string | 否 | 忽略特定參數緩存,多個參數中間用逗號分割 |
| cachekey_args_condition | dict | 否 | 緩存參數condition配置 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/domain/query-domain-detail
示例1:
請求://cdnapi-global.ctapi.daliqc.cn/domain/query-domain-detail?domain=test.daliqc.cn&product_code=001
返回結果:
{
"code": 100000,
"message": "success",
"domain": "aaa.daliqc.cn",
"product_code": "001",
"area_scope": 1,
"https_status": "off",
"https_basic": {
"https_force": "off",
"force_status": "302",
"origin_protocol": "http",
"http_force": "off"
},
"record_num": "京ICP證030173號-1",
"record_status": "true",
"insert_date": "1657177732000",
"status_date": "0",
"cname": "aaa.daliqc.cn.ctdns.cn",
"status": 4,
"ipv6_enable": 2,
"origin_host_type": 0,
"basic_conf": {
"follow302": 0,
"use_http2": 0,
"http_origin_port": 80,
"https_origin_port": 8080
},
"filetype_ttl": [
{
"mode": 0,
"file_type": "php,ashx,aspx,asp,jsp,do",
"cache_type": 3,
"priority": 10,
"ttl": 0,
"cache_with_args": 0
}
],
"origin": [
{
"protocol": "http",
"role": "master",
"port": 80,
"origin": "1.1.1.1",
"weight": 10
},
{
"role": "master",
"port": 80,
"origin": "test.hnoss.xstore.daliqc.cn",
"weight": 10
}
],
"xos_origin_is": 1,
"xos_origin": {
"origin": "test.hnoss.xstore.daliqc.cn",
"ak": "akxxx",
"sk": "skxxx"
},
"entry_limits": [
{
"id": "123abc",
"limit_element": "entry_limits",
"frequency_threshold": 0,
"frequency_time_range": 3600,
"forbidden_duration": 1000,
"forbidden_duration_unit": "s",
"forbidden_code": 0,
"white_ip_control": [
"1.1.1.11",
"58.14.0.0/15",
"240e:94a:4001::3007"
],
"priority": 100
},
{
"id": "456abc",
"limit_element": "entry_limits",
"frequency_threshold": 1000,
"frequency_time_range": 3000,
"forbidden_duration": 1000,
"forbidden_duration_unit": "millis",
"forbidden_code": 123,
"white_ip_control": [
"192.168.1.1",
"58.14.0.0/15",
"240e:94a:4001::3007"
],
"priority": 1
}
],
"entry_limits_condition": {
"123abc": [
{
"mode": 1,
"content": "/test1,/test2"
}
],
"456abc": [
{
"mode": 4,
"content": "/test3$,/test4"
}
]
},
"gzip": {
"id": "gzip",
"min_length": "1K",
"file_type": "tar",
"type": 1
},
"gzip_condition": {
"gzip": [
{
"mode": 1,
"content": "?/test1,/test2"
}
]
},
"cus_gzip": [
{
"id": "123abc",
"min_length": "1K",
"file_type": "tar",
"type": 1,
"http_version": "1.1",
"vary": "on",
"max_length": "1M"
},
{
"id": "123abcd",
"min_length": "1M",
"file_type": "zip",
"type": 0,
"http_version": "1.0",
"vary": "off",
"max_length": "1000M"
}
],
"cus_gzip_condition": {
"123abc": [
{
"mode": 1,
"content": "/test1,/test2"
}
],
"123abcd": [
{
"mode": 4,
"content": "/test3,/test4"
}
]
},
"cachekey_args": [
{
"id": "cachekey_args1234561231",
"ignore": 0,
"is_with_args": 1,
"mode": 1,
"args": " ",
"priority": 10,
"ignore_args": "xxx",
"subject": "xxx",
"pattern": "xxx",
"replace": "xxx"
},
{
"id": "cachekey_args123456abd@12"
}
],
"cachekey_args_condition": {
"cachekey_args123456abd@12": [
{
"mode": 2,
"content": "/"
}
]
}
}
錯誤碼請參考:參數code和message含義