蓝奏云取直连

接口说明

将蓝奏云分享链接解析为可直接访问的文件直连地址，适合需要在自有页面或程序里引用蓝奏云文件的开发者使用。传入分享链接与可选密码即可取回文件名与直连地址，本接口免费调用、无需密钥。

调用地址

https://mini10.top/api/lanzouy.php

请求方式

POST。请求体为 JSON 格式，需包含分享链接 url（必填）与分享密码 passwd（选填）。

鉴权说明

本接口无需密钥，可直接调用，不产生费用。

请求参数

请求体为 JSON 格式，参数如下：

参数取值说明：

• url：填写分享链接原文，例如 https://pan.lanzoul.com/xxxxx，无需自行拼接或转码。
• passwd：仅在分享设置了提取密码时填写，按分享页提示的密码原样传入；未设置密码时留空或不传该字段。

成功响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "name": "apt.exe",
    "url": "https://developer4.lanrar.com/file/?xxxxx",
    "source_url": "https://pan.lanzoul.com/xxxxx"
  }
}

响应字段说明

错误响应示例

当请求未通过校验或执行失败时，接口统一返回如下结构的 JSON：

{"code":0,"msg":"未提供调用密钥","errcode":11001}

参数校验失败示例：

{"code":0,"msg":"分享链接不能为空","errcode":11013}

限流触发示例：

{"code":0,"msg":"请求过于频繁（QPM 限制）","errcode":11005}

字段说明：code 固定为 0，msg 为可读的提示文本，errcode 为业务错误码，取值见下表。

业务错误码说明

本接口为免费接口，首选鉴权为无需密钥，正常调用不会返回 11001～11004、11011、11012、11023～11025 等与密钥和计费相关的错误码；当接口下线、地址配置异常或请求方式不正确时，可能返回 11006～11008、11013～11018。代理类接口在同样场景下会返回 11013、11014、11015、11016 与 11017。

调用示例

终端 curl（bash）

curl -X POST 'https://mini10.top/api/lanzouy.php' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://pan.lanzoul.com/xxxxx","passwd":"abcd"}'

分享无密码时可省略 passwd 字段：

curl -X POST 'https://mini10.top/api/lanzouy.php' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://pan.lanzoul.com/xxxxx"}'

返回示例：

{"code":0,"msg":"ok","data":{"name":"apt.exe","url":"https://developer4.lanrar.com/file/?xxxxx","source_url":"https://pan.lanzoul.com/xxxxx"}}

PHP

// PHP 示例：POST JSON 获取直连
$payload = json_encode([
    'url'    => 'https://pan.lanzoul.com/xxxxx',
    'passwd' => 'abcd',
]);

$ch = curl_init('https://mini10.top/api/lanzouy.php');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);

$response = curl_exec($ch);
if ($response === false) {
    echo 'request failed: ' . curl_error($ch);
} else {
    $result = json_decode($response, true);
    if (isset($result['code']) && $result['code'] === 0) {
        echo $result['data']['name'] . PHP_EOL;
        echo $result['data']['url'] . PHP_EOL;
    } else {
        echo $result['msg'] ?? 'unknown error';
    }
}

curl_close($ch);

注意事项

• 调用地址固定为 https://mini10.top/api/lanzouy.php，请求方法为 POST，请求体需为 JSON 格式，请勿以表单方式提交。
• 本接口无需密钥，属于免费接口，不要在请求中附加多余的鉴权参数；同时也意味着任何人均可调用，请勿在接口中传入涉及个人隐私或敏感信息的链接。
• url 为必填项，须传入完整的蓝奏云分享链接（含协议头）；passwd 仅在分享设置了提取密码时填写，无密码时留空或直接省略该字段，不要传入空字符串以外的占位内容。
• 分享链接需为有效的、未失效的蓝奏云分享页地址。若链接已被取消分享、过期或本身不是蓝奏云域名，将无法解析出直连。
• 返回结果中的 data.url 为带时效性的临时直连地址，可能随签名过期而失效，建议获取后尽快使用，不要长期缓存或对外二次分发。data.source_url 为原始分享链接，可用于结果核对。
• 请先判断返回的 code 字段：code 为 0 表示成功，非 0 时以 msg 描述为准，不要仅依据 HTTP 状态码判断业务结果。
• 解析过程依赖目标页面的实际响应，个别文件（如需要二次验证、限速或分片存储的类型）可能无法直接取得可用直连，调用方应对失败情况做兜底处理。
• 请通过 HTTPS 调用，避免在明文信道中传输分享链接与密码；passwd 若出现在日志或前端代码中应注意脱敏，不要打印完整请求体。
• 请控制调用频率，避免短时间内对同一链接重复请求；批量解析时建议加入适当间隔，防止触发目标站点的访问限制而导致解析失败。