最后更新：2025-10-10
链接检查接口：用于验证百度网盘分享链接的有效性，可快速检查链接状态，也可获取详细的文件列表和统计信息。适合批量验证链接或预览分享内容。
快速检查：基础模式仅验证链接有效性，响应速度极快
详细信息：可选返回完整文件列表和统计数据
智能识别：自动识别链接状态（有效、失效、需要密码等）
树形结构：文件列表以清晰的层级结构显示
批量验证：快速检查大量分享链接的有效性
内容预览：获取分享内容的详细信息和文件列表
状态监控：定期检查重要链接的状态变化
下载前检查：在下载前确认文件完整性和可用性
接口地址：https://api.ccnccn.cn/baidu_check?
请求方式：GET
返回格式：JSON
调用频率：1/1S
接口状态：已上线
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 用户调用接口token，在用户中心-个人信息获取 |
| cookie | 是 | int | 值为cookie管理中的ID，请注意对应关系，填写百度的cookie ID |
| url | 是 | string | 百度网盘分享链接，例如：https://pan.baidu.com/s/abc123 |
| list | 否 | string | 是否返回文件列表和统计信息，true或false，默认false |
| limit | 否 | int | 限制返回的文件数量，0表示不限制，默认0 |
| max | 否 | int | 限制文件夹层级深度，0表示不限制，默认0 |
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200表示成功 |
| message | string | 提示信息 |
| data | object | 返回数据 |
| data.valid | boolean | 链接是否有效 |
| data.url | string | 原始分享链接 |
| data.status | string | 链接状态：valid=有效, invalid=无效, expired=已过期, password_required=需要密码, no_permission=无权限, error=错误 |
| data.title | string | 分享标题 |
| data.file_count | int | 文件总数（仅list=true时返回） |
| data.size | string | 总大小，格式：XX MB（仅list=true时返回） |
| data.files | array | 文件列表，树形结构（仅list=true时返回） |
| data.files[].file_name | string | 文件名 |
| data.files[].size | string | 文件大小，格式：XX MB |
| data.files[].file_type | string | 文件类型：pdf、mp4、jpg、folder等 |
| data.files[].is_dir | boolean | 是否为文件夹 |
| data.files[].children | array | 子文件夹内容（如果是文件夹） |
基础检查（快速模式）
https://api.ccnccn.cn/baidu_check?token=your_token&cookie=1&url=https://pan.baidu.com/s/abc123详细检查（获取文件列表）
https://api.ccnccn.cn/baidu_check?token=your_token&cookie=1&url=https://pan.baidu.com/s/abc123&list=true限制返回文件数量（返回前5个文件）
https://api.ccnccn.cn/baidu_check?token=your_token&cookie=1&url=https://pan.baidu.com/s/abc123&list=true&limit=5限制文件夹层级深度（只显示2层目录）
https://api.ccnccn.cn/baidu_check?token=your_token&cookie=1&url=https://pan.baidu.com/s/abc123&list=true&max=2组合使用（限制4个文件，最多2层深度）
https://api.ccnccn.cn/baidu_check?token=your_token&cookie=1&url=https://pan.baidu.com/s/abc123&list=true&limit=4&max=2基础检查成功
{
"code": 200,
"message": "检查完成",
"data": {
"valid": true,
"url": "https://pan.baidu.com/s/1abcdefg",
"status": "valid",
"title": "编程学习资料合集"
}
}
详细检查成功（带文件列表）
{
"code": 200,
"message": "检查完成",
"data": {
"valid": true,
"url": "https://pan.baidu.com/s/1abcdefg",
"status": "valid",
"title": "编程学习资料合集",
"file_count": 25,
"size": "2560.50 MB",
"files": [
{
"file_name": "Python教程",
"size": "0 MB",
"file_type": "folder",
"is_dir": true,
"children": [
{
"file_name": "Python基础.pdf",
"size": "45.30 MB",
"file_type": "pdf",
"is_dir": false
},
{
"file_name": "Python进阶.mp4",
"size": "189.45 MB",
"file_type": "mp4",
"is_dir": false
}
]
},
{
"file_name": "Java教程.zip",
"size": "125.80 MB",
"file_type": "zip",
"is_dir": false
}
]
}
}
链接无效
{
"code": 200,
"message": "检查完成",
"data": {
"valid": false,
"url": "https://pan.baidu.com/s/invalid",
"status": "invalid",
"title": "",
"message": "分享链接无效或已失效"
}
}
需要提取码
{
"code": 200,
"message": "检查完成",
"data": {
"valid": false,
"url": "https://pan.baidu.com/s/abc123",
"status": "password_required",
"title": "",
"message": "需要提取码"
}
}
调用接口报错
{
"success": false,
"message": "错误信息"
}
| status值 | 说明 | valid值 |
|---|---|---|
| valid | 链接有效，可正常访问 | true |
| invalid | 链接无效或已失效 | false |
| expired | 链接已过期 | false |
| password_required | 需要提取码才能访问 | false |
| no_permission | 无访问权限 | false |
| not_found | 分享链接不存在 | false |
| error | 检查过程中出现错误 | false |
| 错误信息 | 说明 | 解决方案 |
|---|---|---|
| 缺少token参数 | 未提供用户token | 在用户中心获取token |
| 参数错误: 缺少cookie参数 | 未提供Cookie ID | 指定要使用的Cookie ID |
| 参数错误: 缺少url参数 | 未提供分享链接 | 检查url参数是否正确传递 |
| Token无效或账号已被封禁 | token错误或账号状态异常 | 检查token是否有效，或联系站长 |
| 调用次数已用完或已过期 | 超出调用限制或已过期 | 联系站长加次数和时间 |
| ID为X的百度网盘Cookie不存在 | Cookie不存在或已删除 | 需要在Cookie管理中添加百度Cookie |
| ID为X的百度网盘Cookie已失效 | Cookie已失效 | 需要在Cookie管理中重新设置Cookie |
| 无效的分享链接格式 | 分享链接格式错误 | 检查分享链接是否正确 |
| 链接检查失败 | 检查过程中出现异常 | 重试或联系客服 |
| 百度网盘服务器繁忙，请求超时 | 百度服务器响应超时 | 稍后重试 |
请确保Cookie有效，检测状态正常，否则可能导致调用失败。
基础检查模式（list=false）响应速度更快，适合批量验证。
详细检查模式（list=true）会获取完整文件列表，耗时较长但信息完整。
文件列表采用树形结构，可清晰显示文件夹层级关系。
使用浏览器调用时，请勿给参数里带#（浏览器会忽略#后面的所有参数）
每个账号有调用次数和有效期限制，可购买套餐。
如遇到BUG或问题，请联系QQ：77931214
2025-09-30：优化文件列表显示，支持树形结构展示
2025-09-29：增加智能错误识别，提供精确的状态判断
2025-09-28：接口上线，支持快速检查和详细列表两种模式