查詢域名配置信息詳情
更新時間 2025-08-06 10:47:06
最近更新時間: 2025-08-06 10:47:06
分享文章
接口描述:調用本接口查詢某域名配置信息
請求方式:get
請求路徑:/domain/query-domain-detail
使用說明:單個用戶一分鐘限制調用10000次,并發不超過100
請求參數說明:
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| product_code | string | 否 | 產品類型 | 產品類型,“006”(全站加速),不傳代表全部產品 |
| 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加速),“006”(全站加速) |
| 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 | 否 | 源站信息 |
| origin[*].origin | string | 否 | 源站ip或域名 |
| origin[*].port | int | 否 | 源站端口 |
| origin[*].weight | int | 否 | 權重 |
| origin[*].role | string | 否 | 源站角色 |
| origin[*].protocol | string | 否 | 源站類型 |
| black_referer | dict | 否 | referer黑名單 |
| black_referer.allow_list | list | 否 | referer黑名單列表 |
| black_referer.allow_empty | string | 否 | 是否允許為空,“on”(允許為空); “off”(不允許為空) |
| white_referer | dict | 否 | referer白名單 |
| white_referer.allow_list | list | 否 | referer白名單列表 |
| white_referer.allow_empty | string | 否 | 是否允許為空,“on”(允許為空); “off”(不允許為空) |
| filetype_ttl | list | 否 | 文件過期時間設置 |
| 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 | 否 | 自定義回源請求頭 |
| req_headers[*].key | string | 否 | 自定義回源請求頭名稱 |
| req_headers[*].value | string | 否 | 自定義回源請求頭值 |
| resp_headers | list | 否 | 自定義響應頭 |
| resp_headers[*].key | string | 否 | 自定義響應頭名稱 |
| resp_headers[*].value | string | 否 | 自定義響應頭值 |
| basic_conf | dict | 否 | http配置基礎信息 |
| basic_conf.follow302 | int | 否 | 是否拉取跳轉后文件,0(否);1(是) |
| basic_conf.use_http2 | int | 否 | 是否開啟http2,0(不開啟);1(開啟),該字段只有在證書開啟狀態下才會有效 |
| error_code | list | 否 | 錯誤碼緩存配置 |
| error_code[*].code | string | 否 | 錯誤狀態碼 |
| error_code[*].ttl | int | 否 | 緩存時間,單位秒 |
| user_agent | dict | 否 | user_agent黑白名單配置 |
| user_agent.type | int | 否 | 類型,0:(黑名單); 1( 白名單) |
| user_agent.ua | list | 否 | user_agent列表 |
| https_status | string | 否 | 是否開啟https,on、off |
| cert_name | string | 否 | 國際證書備注名 |
| cert_name_gm | string | 否 | 國密證書備注名 |
| https_basic | dict | 否 | 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 | dict | 否 | 壓縮功能 |
| gzip.min_length | string | 否 | 壓縮文件大小 |
| gzip.file_type | string | 否 | 壓縮文件類型 |
| gzip.type | int | 否 | 壓縮類型,0(gzip);1(brotli) |
| ip_black_list | string | 否 | ip黑名單 |
| ip_white_list | string | 否 | ip白名單 |
| req_host | string | 否 | 回源host |
| shared_host | string | 否 | 共享緩存域名 |
| live_conf | dict | 否 | 直播加速信息,當前為空 |
| 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 | dict | 否 | 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 | dict | 否 | limit_speed_const的condition配置 |
| backorigin_arg_rewrite | dict | 否 | 回源參數改寫 |
| backorigin_uri_rewrite_condition | dict | 否 | 回源uri改寫condition配置 |
| backorigin_arg_rewrite_condition | dict | 否 | 回源參數改寫condition配置 |
| md5_secure_time | list<object> | 否 | md5時間戳防盜鏈 |
| md5_secure_time[*].delim_time_char | string | 否 | md5加密方式分隔符 |
| md5_secure_time[*].element | list<dict> | 否 | 加密元素設置 |
| 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 | dict | 否 | 加密元素condition設置 |
| cachekey_args_condition | dict | 否 | 緩存參數的condition配置 |
| ignore_backorigin_args | int | 否 | 是否忽略回源參數 |
| gzip_condition | dict | 否 | 文件壓縮condition配置 |
| ip_deny_mode | int | 否 | ip黑白名單匹配方式 |
| cachekey_args | list<object> | 否 | 緩存參數 |
| cachekey_args[*].args | string | 否 | 匹配方式為0時配置的參數 |
| cachekey_args[*].id | string | 否 | 基于緩存參數唯一標識 |
| cachekey_args[*].ignore | int | 否 | 去參數緩存開關 |
| cachekey_args[*].ignore_args | string | 否 | 忽略特定參數緩存 |
| cachekey_args[*].is_with_args | int | 否 | 帶特定參數緩存 |
| cachekey_args[*].mode | int | 否 | 匹配方式 |
| cachekey_args[*].pattern | string | 否 | 匹配方式為1時配置,目前沒用 |
| cachekey_args[*].priority | int | 否 | 優先級 |
| cachekey_args[*].replace | string | 否 | 匹配方式為1時配置,目前沒用 |
| cachekey_args[*].subject | string | 否 | 匹配方式為1時配置,目前沒用 |
| content_check_switch | int | 否 | 內容審核開關 |
| xff_header | str | 否 | 傳遞客戶端ip頭部設置 |
| etag_lm_check | int | 否 | 分片Etag和LM檢查開關 |
| complex_resp_header | dict | 否 | 復雜模式響應頭 |
| referer_illegal_code | int | 否 | 非法請求狀態碼referer |
| backorigin_uri_rewrite | dict | 否 | 回源uri改寫 |
| follow302_is_valid | int | 否 | follow302后是否有效 |
| path_ttl | list<object> | 否 | 路徑配置 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/domain/query-domain-detail
請求://cdnapi-global.ctapi.daliqc.cn/domain/query-domain-detail?domain=aaa.daliqc.cn&product_code=006
返回結果:
{
"code": 100000,
"message": "success",
"domain": "aaa.daliqc.cn",
"product_code": "006",
"area_scope": 1,
"origin": [
{
"protocol": "http",
"role": "master",
"port": 80,
"origin": "1.1.1.1",
"weight": 10
}
],
"black_referer": {},
"white_referer": {},
"filetype_ttl": [
{
"mode": 0,
"file_type": "php,ashx,aspx,asp,jsp,do",
"cache_type": 3,
"priority": 10,
"ttl": 0,
"cache_with_args": 0
},
{
"mode": 0,
"file_type": "js,css,xml,htm,html",
"cache_type": 3,
"priority": 10,
"ttl": 1800,
"cache_with_args": 0
},
{
"mode": 0,
"file_type": "swf,jpg,gif,png,bmp,ico,ts",
"cache_type": 3,
"priority": 10,
"ttl": 86400,
"cache_with_args": 0
},
{
"mode": 0,
"file_type": "wmv,mp3,wma,ogg,flv,mp4,avi,mpg,mpeg,f4v,hlv,rmvb,rm,3gp,img,bin,zip,rar,ipa,apk,jar,sis,xap,msi,exe,cab,7z,pdf,doc,docx,xls,xlsx,ppt,pptx,txt",
"cache_type": 3,
"priority": 10,
"ttl": 31536000,
"cache_with_args": 0
}
],
"req_headers": [],
"resp_headers": [],
"live_conf": {},
"basic_conf": {
"follow302": 0,
"use_http2": 0
},
"error_code": [],
"user_agent": {},
"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": "daliqc.cn.ctdns.cn.",
"status": 4,
"ipv6_enable": 2,
"origin_host_type": 0,
"gzip": {},
"ip_black_list": "",
"ip_white_list": "",
"req_host": "",
"shared_host": "",
"origin_protocol": "http"
}錯誤碼請參考:參數code和message含義