设置自定义错误码页面
更新时间:2025-03-24
当网站访问出现错误时,浏览器会显示相应的错误页面,本接口可用于自定义错误页面。
Method | Path | 说明 |
---|---|---|
PUT | /v2/domain/{domain}/config?errorPage | 自定义错误页面 |
domain:CDN加速域名
请求体(Request Body)
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
errorPage | 必选 | list类型,元素类型为ErrorPage | 自定义错误跳转页面的详细配置 |
ErrorPage:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
code | 必选 | int | 特定的状态码,要求必须为HTTP的标准错误码,且不能是408、444、499等客户端异常/提前断开这类特殊状态码 |
redirectCode | 可选 | int | 重定向状态码,当出现code错误码时,重定向的类型。支持301和302,默认302 |
url | 必选 | string | 重定向目标地址,当出现code错误码是,重定向到这个用户自定义的 url。 当 url 为外链时,其 Host 只能是域名(不能是 IP),且已经完成域名备案。 |
响应码 (Http Status Code)
HTTP Status Code | 说明 |
---|---|
200 | 成功 |
400 | 更新失败,参数错误等 |
请求示例
PUT /v2/domain/myself.baidu.com/config?errorPage HTTP/1.1
Host: cdn.baidubce.com
Content-Type: application/json
{
"errorPage": [
{
"code": 404,
"redirectCode": 302,
"url": "/customer_404.html"
},
{
"code": 403,
"url": "https://baidu.com/custom_403.html"
}
]
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"status":"RUNNING"
}