登录
目录
当前位置： 首页 > 文档资料 > 百度网盘开放平台 开发者文档 >

设备注册

优质
小牛编辑
125浏览
2023-12-01

接口说明

用于设备注册，当第三方应用安装时调用。

接口地址

https://pan.baidu.com/rest/2.0/xpan/device?method=register

请求方式

GET

请求参数

参数类型必需示例值描述
device_typestring是2020073115900228875设备类型，具体值需要线下提供，联系邮箱：netdisk-union@baidu.com
device_addrstring是3c0cbaa96p20436982261cebe1fefd8f设备地址(设备的唯一标识)，可以是MAC地址或者产品序列号, 建议第三方对设备地址进行加密，即device_addr=MD5(MAC地址/产品序列号)

响应参数

参数类型示例值描述
device_idstring91119331626125597v设备ID

请求示例

curl请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/device?method=register&device_type=2020073115900228875&device_addr=3c0cbaa96p20436982261cebe1fefd8f" -H "User-Agent: pan.baidu.com"

python请求示例

import requests
  
  
url = "https://pan.baidu.com/rest/2.0/xpan/device?method=register&device_type=2020073115900228875&device_addr=3c0cbaa96p20436982261cebe1fefd8f"

  
payload = {}
  headers = {
    'Cookie': 'BAIDUID=56BE0870011A115CFA43E19EA4CE92C2:FG=1; BIDUPSID=56BE0870011A115CFA43E19EA4CE92C2; PSTM=1535714267'
  }

  
response = requests.request("GET", url, headers=headers, data = payload)

  
print(response.text.encode('utf8'))

响应示例

{
      "device_id": "104771607rs1607808",
       "errno": 0,
      "errmsg": "",
      "request_id": "4101763753974075996"
  }

错误码说明

错误码描述
42100设备类型不存在

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

设备绑定

接口说明

将设备和百度账号进行绑定

接口地址

https://pan.baidu.com/rest/2.0/xpan/device?method=bind

请求方式

GET

请求参数

参数类型必需示例值描述
access_tokenstring是1.a6b7dbd428f731035f771b8d15063f61.86400.8124328百度授权凭证
device_idstring是104771607rs1607808设备ID，设备注册接口下发

响应参数

参数类型描述
last_userstring上一个绑定用户的账号，errno=42103时有效

请求示例

curl请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/device?method=bind&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&device_id=104771607rs1607808" -H "User-Agent: pan.baidu.com"

python请求示例

import requests
  
  
url = "https://pan.baidu.com/rest/2.0/xpan/device?method=bind&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&device_id=104771607rs1607808"

  
payload = {}
  headers = {
    'Cookie': 'BAIDUID=56BE0870011A115CFA43E19EA4CE92C2:FG=1; BIDUPSID=56BE0870011A115CFA43E19EA4CE92C2; PSTM=1535714267'
  }

  
response = requests.request("GET", url, headers=headers, data = payload)

  
print(response.text.encode('utf8'))

响应示例

# 正确示例
  {
      "errmsg": "",
      "errno": 0,
      "request_id": "1480287893669784379"
  }
  # 错误示例
  {
      "errmsg": "exceed max bind count per device",
      "errno": 42103,
      "last_user": "北极***g狼",
      "request_id": "1352489237847401603"
  }

错误码说明

错误码描述
42101设备未注册
42102超过每个用户能绑定的最大设备个数限制
42103超过每个设备能绑定的最大用户个数限制

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

设备解绑

接口说明

将设备和百度账号解绑

接口地址

https://pan.baidu.com/rest/2.0/xpan/device?method=unbind

请求方式

GET

请求参数

参数类型必需示例值描述
access_tokenstring是1.a6b7dbd428f731035f771b8d15063f61.86400.8124328授权凭证
device_idstring是104771607rs1607808设备ID，设备注册接口下发

请求示例

curl请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/device?method=unbind&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&device_id=104771607rs1607808" -H "User-Agent: pan.baidu.com"

python请求示例

import requests
  
  
url = "https://pan.baidu.com/rest/2.0/xpan/device?method=unbind&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&device_id=104771607rs1607808"

  
payload = {}
  headers = {
    'Cookie': 'BAIDUID=56BE0870011A115CFA43E19EA4CE92C2:FG=1; BIDUPSID=56BE0870011A115CFA43E19EA4CE92C2; PSTM=1535714267'
  }

  
response = requests.request("GET", url, headers=headers, data = payload)

  
print(response.text.encode('utf8'))

错误码说明

错误码描述
42101设备未注册

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

检查设备绑定关系

接口说明

检查设备和百度账号是否已绑定

请求地址

https://pan.baidu.com/rest/2.0/xpan/device?method=checkbind

请求方式

GET

请求参数

参数类型必需示例值描述
access_tokenstring是1.a6b7dbd428f731035f771b8d15063f61.86400.8124328授权凭证
device_idstring是104771607rs1607808设备ID，设备注册接口下发

响应参数

参数类型描述
statusint是否绑定，1 是、0 否

请求示例

curl请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/device?method=checkbind&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&device_id=104771607rs1607808" -H "User-Agent: pan.baidu.com"

python请求示例

import requests
  
  
url = "https://pan.baidu.com/rest/2.0/xpan/device?method=checkbind&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&device_id=104771607rs1607808"

  
payload = {}
  headers = {
    'Cookie': 'BAIDUID=56BE0870011A115CFA43E19EA4CE92C2:FG=1; BIDUPSID=56BE0870011A115CFA43E19EA4CE92C2; PSTM=1535714267'
  }

  
response = requests.request("GET", url, headers=headers, data = payload)

  
print(response.text.encode('utf8'))

响应示例

{
    "errmsg": "",
    "errno": 0,
    "request_id": "1253926140339337558",
    "status": 1
  }

错误码说明

错误码描述
42101设备未注册

设备列表diff

接口说明

获取某个用户的设备列表的变化情况。
注意：该接口不是用于直接获取设备列表的，需要获取设备列表请使用获取列表接口

接口地址

https://pan.baidu.com/rest/2.0/xpan/device?method=diff

请求方式

POST

请求参数

query参数

参数类型必需示例描述
access_tokenstring是1.a6b7dbd428f731035f771b8d15063f61.86400.8124328授权凭证

body参数

参数类型必需示例值描述
paramstring是{"cursor": "", "category_list": [1, 2, 3]}参数，json str，json里有cursor和category_list两个参数，cursor为diff起点，首次为null字符串或空字符串；category_list为设备分类列表，json str, 1 音箱，2 电视，3 nas 。

响应参数

参数类型示例值描述
cursorstringMTU0Mjg2MzgxMiMxNTQ0NjcyMDQ5下一次diff的起点
has_moreint1是否还有更多数据，0 没有，1 有
device_listjson array设备列表
device_list[0]["device_id"]string104771607rs1607808设备ID
device_list[0]["device_type"]int2020073115900228875设备类型
device_list[0]["status"]int1设备状态，0 未绑定，1 绑定
device_list[0]["device_category"]int1设备分类
device_list[0]["ability"]string设备能力，英文逗号分隔
device_list[0]["device_provider"]string华为设备厂商
device_list[0]["device_brand"]string华为路由器设备品牌名称
device_list[0]["device_name"]stringMY HUWEI WIFI设备自定义名称
device_list[0]["device_logourl"]stringhttps://issuecdn.baidupcs.com/issue/netdisk/tu/rongyao/rongyao.png设备icon url
device_list[0]["guide_desc"]string设备引导页文案
device_list[0]["guide_imgurl "]string设备引导页
device_list[0]["extra_info "]string设备其他信息，对应json string

请求示例

curl请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/device?method=diff&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328" -d 'param={"cursor": "", "category_list": [1, 2, 3]}' -H "User-Agent: pan.baidu.com"

python请求示例

import requests
  
  
url = "https://pan.baidu.com/rest/2.0/xpan/device?method=diff&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328"

  
payload = {'param': '{"cursor": "", "category_list": [1, 2, 3]}'}
  files = [

  
]
  headers = {
    'Cookie': 'BAIDUID=56BE0870011A115CFA43E19EA4CE92C2:FG=1; BIDUPSID=56BE0870011A115CFA43E19EA4CE92C2; PSTM=1535714267'
  }

  
response = requests.request("POST", url, headers=headers, data = payload, files = files)

  
print(response.text.encode('utf8'))

响应示例


  {
    "cursor": "MTU0Mjg2MzgxMiMxNTQ0NjcyMDQ5",
    "device_list": [
      {
        "ability": "4",
        "ctime": 1541405212,
        "device_brand": "华为路由器",
        "device_category": 3,
        "device_id": "104771607rs1607808",
        "device_logourl": "https://issuecdn.baidupcs.com/issue/netdisk/tu/rongyao/rongyao.png",
        "device_name": "weijiazhen",
        "device_provider": "华为",
        "device_type": 2,
        "extra_info": "",
        "guide_desc": "华为路由器",
        "guide_imgurl": "",
        "mtime": 1543990788,
        "status": 0
      },
      {
        "ability": "4",
        "ctime": 1542863812,
        "device_brand": "华为路由器",
        "device_category": 3,
        "device_id": "104771607rs1607809",
        "device_logourl": "https://issuecdn.baidupcs.com/issue/netdisk/tu/rongyao/rongyao.png",
        "device_name": "MY HUWEI WIFI",
        "device_provider": "华为",
        "device_type": 2,
        "extra_info": "",
        "guide_desc": "华为路由器",
        "guide_imgurl": "",
        "mtime": 1543990788,
        "status": 1
      },
      {
        "ability": "1,2,3",
        "ctime": 1541596125,
        "device_brand": "创维盒子",
        "device_category": 2,
        "device_id": "104771607rs1607810",
        "device_logourl": "https://issuecdn.baidupcs.com/issue/netdisk/tu/hezi.PNG",
        "device_name": "创维小湃盒子",
        "device_provider": "创维",
        "device_type": 1,
        "extra_info": "",
        "guide_desc": "更大屏幕，放大精彩",
        "guide_imgurl": "",
        "mtime": 1542441752,
        "status": 1
      },
    ],
    "errmsg": "",
    "errno": 0,
    "has_more": 0,
    "request_id": "74449114155359224"
  }

设备列表

接口说明

获取用户的设备列表

请求地址

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

请求方式

GET

请求参数

参数类型必需示例值描述
access_tokenstring是1.a6b7dbd428f731035f771b8d15063f61.86400.8124328授权凭证
categorystring是1,2,3设备分类列表，1 音箱、2 电视、3 NAS
多个分类用英文逗号分隔，如1,2,3

响应参数

参数类型示例值描述
device_idstring104771607rs1607808设备ID
device_typeint2020465723645设备类型
statusint1设备状态，0 未绑定，1 绑定
device_categoryint1设备分类
abilitystring4设备能力，英文逗号分隔
device_providerstring华为设备厂商
device_brandstring华为路由器设备品牌名称
device_namestringMY HUAWEI WIFI设备自定义名称
device_logourlstringhttps://issuecdn.baidupcs.com/issue/netdisk/tu/rongyao/rongyao.png设备icon url
guide_descstring设备引导页文案
guide_imgurlstring设备引导页
extra_infostring设备其他信息，对应json string

请求示例

curl请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/device?method=list&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&category=3" -H "User-Agent: pan.baidu.com"

python请求示例

import requests
  
  
url = "https://pan.baidu.com/rest/2.0/xpan/device?method=list&access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.8124328&category=3"

  
payload = {}
  headers = {
    'Cookie': 'BAIDUID=56BE0870011A115CFA43E19EA4CE92C2:FG=1; BIDUPSID=56BE0870011A115CFA43E19EA4CE92C2; PSTM=1535714267'
  }

  
response = requests.request("GET", url, headers=headers, data = payload)

  
print(response.text.encode('utf8'))

响应示例

{
    "list": [
      {
        "ability": "4",
        "ctime": 1541405212,
        "device_brand": "华为路由器",
        "device_category": 3,
        "device_id": "123",
        "device_logourl": "https://issuecdn.baidupcs.com/issue/netdisk/tu/rongyao/rongyao.png",
        "device_name": "weijiazhen",
        "device_provider": "华为",
        "device_type": 2,
        "extra_info": "",
        "guide_desc": "华为路由器",
        "guide_imgurl": "",
        "mtime": 1543990788,
        "status": 0
      },
    ],
    "errmsg": "",
    "errno": 0,
    "request_id": "74449114155359224"
  }
免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn