文件分享

分享能力接入说明

文件分享能力目前只对企业开发者开放，不对个人开发者开放。若您的企业需要接入文件分享能力，请按照以下邮件格式发送申请邮件到邮箱：netdisk-union@baidu.com”

邮件格式

标题：企业名称+申请接入文件分享能力

一、企业信息：

1. 企业名称

2. 企业营业执照

二、产品信息：

1. 产品名称

2. 产品用户规模

3. 产品DAU

4. 文件分享能力在产品内的主要应用场景

5. 产品内分享传播的主要文件类型

6. 接入文件分享能力后网盘外链的日均创建量（预估）

三、对接人信息：

1. 姓名

2. 电话号码

3. 联系邮箱

合作须知

若你的产品接入文件分享能力后，产品中高频出现借助文件分享能力分享违规文件的行为，我们将立刻终止为你的产品提供文件分享能力服务。

创建附件

接口概述

接口功能

本文档主要针对需要集成http api的技术工程师。
将网盘文件以链接形式分享给其他人。
通过该接口可以将登录用户的文件以指定规则分享出去。

使用条件

频控限制：有
接口鉴权：有
接入流程：https://www.xnip.cn/shouce/629/47115.html

依赖说明

access_token:参照 https://openauth.baidu.com/doc/appendix.html
csign：请求签名，依赖独立的secret，请与商务联系或者通过邮箱(netdisk-union@baidu.com)申请secret,third_type

其他说明

1.不支持创建包含文件夹、压缩包的附件
2.私密链接的提取码由接口返回
3.签名字段计算方式：md5签名。$secret在第三方接入时线下分配。
Php示例: csign = md5($_POST['third_type'].$_POST['fid_list'].$_POST['schannel'].$secret) 。

参数说明

请求方式: POST

接口地址:

https://pan.baidu.com/rest/2.0/xpan/share/set

query参数

body参数

响应参数

示例说明

假设示例请求数据如下。

curl示例:

curl -X POST \
  'https://pan.baidu.com/rest/2.0/xpan/share/set?access_token=12.54c41f1104a818b4b0f046343cf599d9.YluFWG7w5zHEdp5JgRAGmcVTXI7MECEn8oiYKqn.xfzyNw' \
  -H 'Postman-Token: 099a1462-f171-43ab-81ad-6fbbe3d4c8a7' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -F 'fid_list=[391137377352125]' \
  -F period=7 \
  -F third_type=2001 \
  -F description= \
  -F csign=44915d74e265fc7d508bccf5a195b4eb \
  -F schannel=4

python示例:

import requests

url = "https://pan.baidu.com/rest/2.0/xpan/share/set"
querystring = {"access_token":"12.54c41f1104a818b4b0f046343cf599d9.YluFWG7w5zHEdp5JgRAGmcVTXI7MECEn8oiYKqn.xfzyNw"}
payload = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="fid_list"\r\n\r\n[391137377352125]\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="period"\r\n\r\n7\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="third_type"\r\n\r\n2001\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="description"\r\n\r\n\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="csign"\r\n\r\n44915d74e265fc7d508bccf5a195b4eb\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="schannel"\r\n\r\n4\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"
headers = {
    'content-type': "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW",
    'cache-control': "no-cache",
    'Postman-Token': "07a95393-bc0d-45dc-87cb-b7e607761be1"
    }
response = requests.request("POST", url, data=payload, headers=headers, params=querystring)
print(response.text)

响应示例

{
    "errno": 0,
    "request_id": 4891294274629272105,
    "shareid": 2192088175,
    "link": "https://pan.baidu.com/link/zh/7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G==",
    "shorturl": "https://pan.baidu.com/link/zh/7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G==",
    "ctime": 1596029492,
    "expiredType": 7,
    "premis": false,
    "pwd": "emy5",
    "uk": 3809279679
}

错误码说明

更多错误码，参考 https://www.xnip.cn/shouce/629/47126.html

附件密码验证

接口概述

接口功能

本文档主要针对需要集成http api的技术工程师。
提供校验分享链接密码是否有效的能力。
通过该接口可以校验密码是否正确，校验成功后，才可以访问链接内容页。

使用条件

频控限制：有
接口鉴权：有
接入流程：https://www.xnip.cn/shouce/629/47115.html

依赖说明

access_token:参照 https://openauth.baidu.com/doc/appendix.html
csign：请求签名，依赖独立的secret，请与商务联系或者通过邮箱(netdisk-union@baidu.com)申请secret,third_type

其他说明

1.调用此接口必带header: Referer:pan.baidu.com
2.无需带access_token

参数说明

请求方式: POST

接口地址:

https://pan.baidu.com/rest/2.0/xpan/share?method=verify

header参数

query数

body参数

响应参数

示例说明

假设示例请求数据如下。

curl示例:

curl -X POST \
  'https://pan.baidu.com/rest/2.0/xpan/share?method=verify&shareid=2192088175&uk=3809279679&surl=7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G==' \
  -H 'Postman-Token: c7a1b91c-4425-4d92-ac6b-5efc144eb9c0' \
  -H 'Referer: pan.baidu.com' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -F pwd=emy5

python示例:

import requests

url = "https://pan.baidu.com/rest/2.0/xpan/share"
querystring = {"method":"verify","shareid":"2192088175","uk":"3809279679","surl":"7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G=="}
payload = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="pwd"\r\n\r\nemy5\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"
headers = {
    'content-type': "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW",
    'Referer': "pan.baidu.com",
    'cache-control': "no-cache",
    'Postman-Token': "68b9fce6-51dd-4935-b634-24b59743f6e5"
    }
response = requests.request("POST", url, data=payload, headers=headers, params=querystring)
print(response.text)

响应示例

{
    "errno": 0,
    "err_msg": "",
    "request_id": 297220488144243753,
    "randsk": "2CZ9rumLkLold9CVa3csKNCoVKuJsEtTL4n3m6SVsPc%3D"
}

错误码说明

更多错误码，参考 https://www.xnip.cn/shouce/629/47126.html

获取附件中的文件列表

接口概述

接口功能

本文档主要针对需要集成http api的技术工程师。
通过该接口可以获取分享链接内对应的文件信息。

使用条件

频控限制：有
接口鉴权：有
接入流程：https://www.xnip.cn/shouce/629/47115.html

依赖说明

access_token:参照 https://openauth.baidu.com/doc/appendix.html
csign：请求签名，依赖独立的secret，请与商务联系或者通过邮箱(netdisk-union@baidu.com)申请secret,third_type

其他说明

1.无需带access_token 2.shareid+uk和shorturl必须有一个

参数说明

请求方式: GET

接口地址:

https://pan.baidu.com/rest/2.0/xpan/share?method=list

query参数

响应参数

示例说明

假设示例请求数据如下。

curl示例:

curl -X GET \
  'https://pan.baidu.com/rest/2.0/xpan/share?method=list&shareid=2192088175&uk=3809279679&page=1&num=100&root=1&fid    =&sekey=2CZ9rumLkLold9CVa3csKNCoVKuJsEtTL4n3m6SVsPc%3D&fid%09=' \
  -H 'Postman-Token: 735a7f50-86e4-4c1e-9eb5-7aa43e4c5764' \
  -H 'cache-control: no-cache'

python示例:

import requests

url = "https://pan.baidu.com/rest/2.0/xpan/share"
querystring = {"method":"list","shareid":"2192088175","uk":"3809279679","page":"1","num":"100","root":"1","fid\t":"","sekey":"2CZ9rumLkLold9CVa3csKNCoVKuJsEtTL4n3m6SVsPc%3D","fid%09":""}
payload = ""
headers = {
    'cache-control': "no-cache",
    'Postman-Token': "8165fd5b-496d-4626-9b3f-36f22468213c"
    }
response = requests.request("GET", url, data=payload, headers=headers, params=querystring)
print(response.text)

响应示例

{
    "errno": 0,
    "request_id": 299189621521418019,
    "server_time": 1596102437,
    "cfrom_id": 2001,
    "title": "/盘下来的资源/3月22日世界水日PPT模板/107812fa7t23f01bd05a8fd47562501a.pptx",
    "list": [
        {
            "category": "4",
            "fs_id": "391137377352125",
            "isdir": "0",
            "local_ctime": "1587609475",
            "local_mtime": "1587609475",
            "md5": "107812fa7t23f01bd05a8fd47562501a",
            "path": "/盘下来的资源/3月22日世界水日PPT模板/107812fa7t23f01bd05a8fd47562501a.pptx",
            "server_ctime": "1587609475",
            "server_filename": "107812fa7t23f01bd05a8fd47562501a.pptx",
            "server_mtime": "1593679688",
            "size": "18054683",
            "thumbs": {
                "url1": "https://thumbnail0.baidupcs.com/thumbnail/107812fa7t23f01bd05a8fd47562501a?fid=3809279679-250528-391137377352125&time=1596099600&rt=sh&sign=FDTAER-DCb740ccc5511e5e8fedcff06b081203-uq4x8TGEQXun%2FCvTuTD3La8Y7vE%3D&expires=8h&chkv=0&chkbd=0&chkpc=&dp-logid=299189621521418019&dp-callid=0&size=c140_u90&quality=100&vuk=-&ft=video",
                "url3": "https://thumbnail0.baidupcs.com/thumbnail/107812fa7t23f01bd05a8fd47562501a?fid=3809279679-250528-391137377352125&time=1596099600&rt=sh&sign=FDTAER-DCb740ccc5511e5e8fedcff06b081203-uq4x8TGEQXun%2FCvTuTD3La8Y7vE%3D&expires=8h&chkv=0&chkbd=0&chkpc=&dp-logid=299189621521418019&dp-callid=0&size=c850_u580&quality=100&vuk=-&ft=video"
            },
            "docpreview": "https://pcsdata.baidu.com/doc/107812fa7t23f01bd05a8fd47562501a?fid=3809279679-250528-391137377352125&time=1596102438&rt=sh&sign=FDTAER-DCb740ccc5511e5e8fedcff06b081203-9c7JZp1rHN47D%2Bz31INUtE%2FWv9E%3D&expires=8h&chkv=0&chkbd=0&chkpc=&dp-logid=299189621521418019&dp-callid=0"
        }
    ],
    "share_id": 2192088175,
    "uk": 3809279679
}

错误码说明

更多错误码，参考 https://www.xnip.cn/shouce/629/47126.html

查询附件链接信息

接口概述

接口功能

本文档主要针对需要集成http api的技术工程师。
提供查询分享链接查询链接基本信息的功能。
通过该接口可以查询指定分享链接的链接信息,包括用shorturl转换shareid,uk。

使用条件

频控限制：有
接口鉴权：有
接入流程：https://www.xnip.cn/shouce/629/47115.html

依赖说明

如果分享链接有密码，则需先请求verify接口获取请求成功后的randsk

其他说明

1. 只要接口正常返回数据就可以，无需关心errno。
2. 如果需要更多分享信息，请通过邮箱联系说明需要字段及用途。
3. 请求参数中linksource+shorturl 或者shareid+uk 这2组参数必须有一组

参数说明

请求方式: GET

接口地址:

https://pan.baidu.com/api/shorturlinfo

query参数

响应参数

示例说明

假设分享链接地址为：如：https://pan.baidu.com/link/zhihu/7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G==
示例请求数据如下。

curl示例:

curl -X GET \
  'https://pan.baidu.com/api/shorturlinfo?shorturl=7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G==&linksource=zhihu' \
  -H 'Postman-Token: abdc01bb-0a2c-424f-b428-7eba4837518b' \
  -H 'cache-control: no-cache'

python示例:

import requests

url = "https://pan.baidu.com/api/shorturlinfo"
querystring = {"shorturl":"7hhjzWuUhVi1VwkFF2XlZOpVRXbQVVaQU08G==","linksource":"zhihu"}
payload = ""
headers = {
    'cache-control': "no-cache",
    'Postman-Token': "c5baffc2-81a0-44fe-b24a-8f60964d1f91"
    }
response = requests.request("GET", url, data=payload, headers=headers, params=querystring)
print(response.text)

响应示例

{
    "shareid": 2192088175,
    "uk": 3809279679,
    "dir": "",
    "type": 0,
    "prod_type": "share",
    "page": 1,
    "root": 0,
    "third": 0,
    "longurl": "shareid=2192088175uk=3809279679",
    "fid": 0,
    "errno": -3,
    "expire_days": 7,
    "ctime": 1596029492,
    "expiredtype": 527864,
    "fcount": 1,
    "uk_str": "3809279679"
}

错误码说明

无特殊说明 更多错误码，参考 https://www.xnip.cn/shouce/629/47126.html

附件文件转存

接口概述

接口功能

本文档主要针对需要集成http api的技术工程师。
提供将分享链接的内容转存到当前用户指定目录下的功能。
通过该接口可以将访问的链接内容保存到当前登录用户指定目录下。

使用条件

频控限制：有
接口鉴权：有
接入流程：https://www.xnip.cn/shouce/629/47115.html

依赖说明

access_token:参照 https://openauth.baidu.com/doc/appendix.html

其他说明

1.转存数量限制：
a、普通用户单次最多转存500个文件
b、普通会员用户单次最多转存3000个文件
c、超级会员用户单次最多转存50000个文件
2.请求必须带Referer

参数说明

请求方式: POST

接口地址:

https://pan.baidu.com/rest/2.0/xpan/share?method=transfer

header参数

query参数

body参数

响应参数

示例说明

假设示例请求数据如下。

curl示例:

curl "https://pan.baidu.com/rest/2.0/xpan/share?method=transfer&access_token=123&shareid=3440411579&from=3389535607" -d 'sekey=S3l2qkR0bI3GUR2UXVVKyRXrm2760dC6mg2ExG0qbUM=&fsidlist=[689582071279227,523224362330193]&path=/baidu' -H "User-Agent: pan.baidu.com" -H "Referer:pan.baidu.com"

python示例:

import requests

url = "https://pan.baidu.com/rest/2.0/xpan/share"
querystring = {"method":"transfer","access_token":"123","shareid":"3440411579","from":"3389535607"}
payload = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="sekey"\r\n\r\nS3l2qkR0bI3GUR2UXVVKyRXrm2760dC6mg2ExG0qbUM=\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="fsidlist"\r\n\r\n[689582071279227,523224362330193]\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name="path"\r\n\r\n/baidu\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--"
headers = {
    'content-type': "multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW",
    'User-Agent': "pan.baidu.com",
    'Referer': "pan.baidu.com",
    'cache-control': "no-cache",
    'Postman-Token': "2756bf0a-adbe-46fe-a305-a84a706052b3"
    }
response = requests.request("POST", url, data=payload, headers=headers, params=querystring)
print(response.text)

响应示例

{"errno":0,"extra":{"list":[{"from":"/IMG_4500.JPG","from_fs_id":511854832260583,"to":"/测试/IMG_4500.JPG"},{"from":"/IMG_4496.JPG","from_fs_id":883280746409607,"to":"/测试/IMG_4496.JPG"},{"from":"/IMG_4489.JPG","from_fs_id":1082123250937975,"to":"/测试/IMG_4489.JPG"}]},"info":[{"errno":0,"fsid":511854832260583,"path":"/IMG_4500.JPG"},{"errno":0,"fsid":883280746409607,"path":"/IMG_4496.JPG"},{"errno":0,"fsid":1082123250937975,"path":"/IMG_4489.JPG"}],"newno":"","request_id":3883433737624734161,"show_msg":"","task_id":0}

错误码说明

更多错误码，参考 https://www.xnip.cn/shouce/629/47126.html