API文档
完整的API接口文档,帮助开发者快速集成磁力狗服务
磁力狗官方网站
磁力狗官网: clg2.clgapp1.xyz 点击跳转3
核心API接口
99.9%
服务可用性
24/7
技术支持
POST
搜索API
提供强大的磁力链接搜索功能,支持关键词搜索、分类筛选和高级搜索选项。
https://api.ciligou.com/v1/search
请求参数
keyword
string
搜索关键词
必需
category
string
文件分类(video/audio/document等)
可选
page
int
页码(默认1)
可选
limit
int
每页结果数(默认20)
可选
请求示例
curl -X POST https://api.ciligou.com/v1/search \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"keyword": "电影名称",
"category": "video",
"page": 1,
"limit": 20
}'
响应示例
{
"code": 200,
"message": "success",
"data": {
"total": 1523,
"page": 1,
"limit": 20,
"results": [
{
"id": "abc123",
"title": "电影名称 - 2024",
"magnet": "magnet:?xt=urn:btih:...",
"size": "1.5GB",
"seeds": 152,
"peers": 32,
"category": "video",
"created_at": "2024-01-01"
}
]
}
}
GET
下载任务API
获取和管理用户的下载任务列表,支持任务状态查询和详情获取。
https://api.ciligou.com/v1/downloads
请求参数
status
string
任务状态(active/completed/failed)
可选
page
int
页码(默认1)
可选
请求示例
curl -X GET https://api.ciligou.com/v1/downloads?status=active \
-H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
"code": 200,
"data": {
"tasks": [
{
"id": "task_123",
"title": "下载文件",
"status": "active",
"progress": 65,
"speed": "2.5 MB/s",
"size": "5.2GB",
"created_at": "2024-01-01T10:00:00Z"
}
]
}
}
GET
用户信息API
获取用户账户信息和统计数据。
https://api.ciligou.com/v1/user
请求示例
curl -X GET https://api.ciligou.com/v1/user \
-H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
"code": 200,
"data": {
"id": "user_123",
"username": "example",
"email": "user@example.com",
"premium": true,
"downloads_count": 1523,
"quota_remaining": "500GB"
}
}
错误码说明
200
成功
请求成功
400
错误
请求参数错误
401
错误
未授权,检查API密钥
429
错误
请求过于频繁
500
错误
服务器内部错误