网盘链接有效性检测 API

接口地址

📖 完整使用文档

一份 Markdown 格式的完整 API 使用文档（认证 · 9 种网盘 · 端点详解 · SSE · 结果字段 · 错误码 · 最佳实践 · 每个网盘注意事项 · 环境变量 · FAQ）。 点下方按钮即可 一键复制 到剪贴板，随处粘贴。

加载中…

🔑 API 密钥

输入一次，下方 3 个“在这里试一下”都会自动带上它。勾选“记住 30 天”会存在 localStorage，仅本浏览器可见，不会发送给第三方。 没密钥？🔐 去密钥管理创建。

快速开始

1 · 提交检测任务

curl -X POST $BASE/jobs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $YOUR_API_KEY" \
  -d '{
    "items": [
      {"url": "https://pan.quark.cn/s/xxxx"},
      {"url": "https://pan.baidu.com/s/yyyy?pwd=8888"},
      {"url": "https://www.alipan.com/s/zzzz"}
    ]
  }'

2 · 订阅结果流（SSE）

curl -N $BASE/jobs/$JOB_ID/events \
  -H "X-API-Key: $YOUR_API_KEY"

3 · 加急（批量 URL 插队）

curl -X POST $BASE/jobs/$JOB_ID/urgent \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $YOUR_API_KEY" \
  -d '{"urls": ["https://pan.quark.cn/s/xxxx", "https://www.alipan.com/s/zzzz"]}'

端点清单 · 本服务提供两个公开 API

① 检测 API （需密钥）

② 处理池查询 API （公开，无需密钥）

只返回计数与静态元数据，不暴露任何 URL / 用户数据，可安全给仪表盘 / Prometheus / 告警脚本用。

元信息与管理

代码示例

# 一次性跑完：创建 job → 订阅流
JOB=$(curl -sX POST $BASE/jobs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $YOUR_API_KEY" \
  -d '{"items":[{"url":"https://pan.quark.cn/s/xxx"}]}' | python -c "import sys,json;print(json.load(sys.stdin)['job_id'])")

curl -N $BASE/jobs/$JOB/events \
  -H "X-API-Key: $YOUR_API_KEY"

import asyncio, httpx, json

BASE = "$BASE"
KEY  = "$YOUR_API_KEY"

async def main():
    async with httpx.AsyncClient(headers={"X-API-Key": KEY}, timeout=None) as cli:
        # 1. 提交
        r = await cli.post(f"{BASE}/jobs", json={"items": [
            {"url": "https://pan.quark.cn/s/xxxx"},
            {"url": "https://pan.baidu.com/s/yyyy?pwd=8888"},
        ]})
        job = r.json()
        print("job_id:", job["job_id"])

        # 2. 订阅 SSE
        async with cli.stream("GET", f"{BASE}{job['stream_url']}") as resp:
            async for line in resp.aiter_lines():
                if line.startswith("data:"):
                    print(json.loads(line[5:].strip()))

        # 3. （可选）中途加急
        # await cli.post(f"{BASE}/jobs/{job['job_id']}/urgent",
        #                json={"urls": ["https://pan.quark.cn/s/xxxx"]})

asyncio.run(main())

// Node 18+（原生 fetch + ReadableStream）
const BASE = "$BASE";
const KEY  = "$YOUR_API_KEY";

const r = await fetch(`${BASE}/jobs`, {
  method: "POST",
  headers: {"Content-Type": "application/json", "X-API-Key": KEY},
  body: JSON.stringify({items: [{url: "https://pan.quark.cn/s/xxxx"}]}),
});
const job = await r.json();
console.log("job_id:", job.job_id);

const sse = await fetch(`${BASE}${job.stream_url}`, {
  headers: {"X-API-Key": KEY},
});
const reader = sse.body.getReader();
const decoder = new TextDecoder();
let buf = "";
while (true) {
  const {value, done} = await reader.read();
  if (done) break;
  buf += decoder.decode(value, {stream: true});
  let idx;
  while ((idx = buf.indexOf("\n\n")) >= 0) {
    const frame = buf.slice(0, idx); buf = buf.slice(idx + 2);
    const data = frame.split("\n").find(l => l.startsWith("data:"));
    if (data) console.log(JSON.parse(data.slice(5).trim()));
  }
}

<?php
$base = "$BASE";
$key  = "$YOUR_API_KEY";

$ch = curl_init("$base/jobs");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-API-Key: $key"],
  CURLOPT_POSTFIELDS => json_encode(["items" => [
    ["url" => "https://pan.quark.cn/s/xxxx"]
  ]]),
  CURLOPT_RETURNTRANSFER => true,
]);
$job = json_decode(curl_exec($ch), true);
curl_close($ch);

$ch = curl_init("$base{$job['stream_url']}");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ["X-API-Key: $key"],
  CURLOPT_WRITEFUNCTION => function ($ch, $data) { echo $data; return strlen($data); },
]);
curl_exec($ch);

结果字段速查

系统状态