API文档

完整的API接口文档，帮助开发者快速集成磁力狗服务

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"
  }
}

身份认证

所有API请求都需要在请求头中包含有效的API密钥：

Authorization: Bearer YOUR_API_KEY

获取API密钥：申请密钥

错误码说明

200 成功 请求成功
400 错误 请求参数错误
401 错误 未授权，检查API密钥
429 错误 请求过于频繁
500 错误 服务器内部错误
🐍

Python SDK

官方Python开发包，支持异步调用

下载
☕

Java SDK

企业级Java SDK，适合大型项目

下载
📘

Node.js SDK

轻量级Node.js封装，易于集成

下载