防护目录列表

最近更新时间: 2026-09-17 00:02:50

1. 接口描述

接口请求域名： cwp.api3.fincloud.tencent.cn。

网页防篡改防护目录列表

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

接口更新时间：2022-05-20 15:13:13。

接口既验签名又鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeProtectDirList
Version	是	否	String	公共参数，本接口取值：2018-02-28
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
By	否	否	String	排序字段 ProtectServerNum, NoProtectServerNum, LatestProtectTime, RelatedServerNum 示例值： ProtectServerNum
Filters	否	否	Array of AssetFilters	DirName 网站名称 DirPath 网站防护目录地址示例值：查看
Limit	是	否	Uint64	分页条数最大100条示例值： 10
Offset	是	否	Uint64	偏移量示例值： 1
Order	否	否	String	asc：升序/desc：降序示例值： asc

3. 输出参数

参数名称	类型	描述
List	Array of ProtectDirInfo	防护目录列表信息示例值：查看
TotalCount	Uint64	总数示例值： 1
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码	描述
InternalError	内部错误。
InvalidParameter.MissingParameter	参数缺失。
InvalidParameter.InvalidFormat	参数格式错误。
MissingParameter	缺少参数错误。
InvalidParameter.IllegalRequest	非法请求。
InvalidParameter	参数错误。
InvalidParameterValue	参数取值错误。

5. 示例

示例1 查询网页防篡改防护目录列表

输入示例

POST / HTTP/1.1
Host: cwp.api3.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: DescribeProtectDirList
<Public request parameters>

{
    "Limit": 1,
    "Offset": 1
}

输出示例

{
    "Response": {
        "TotalCount": 1,
        "List": [
            {
                "DirName": "sdfdsf",
                "DirPath": "/home/te****",
                "RelatedServerNum": 1,
                "ProtectServerNum": 1,
                "NoProtectServerNum": 1,
                "Id": "/home/te****",
                "ProtectStatus": 1,
                "ProtectException": 1,
                "AutoRestoreSwitchStatus": 1,
                "FirstProtectTime": "2020-11-21 15:16:00",
                "LatestProtectTime": "2020-11-21 15:16:00",
                "ProtectFileType": ".php;.js",
                "ProtectFilesCount": 0
            }
        ],
        "RequestId": "2eedad67-5a4c-4746-82d2-52a8e5d91c6a"
    }
}