开发者须知

开发者须知

简介

本部分主要介绍百度网盘开放平台的接入流程，主要包括申请appid和获取用户授权。获取授权后，即可根据开发需求，依照接口的使用规则进行相应的开发。

接入流程

1.成为开发者

step1：使用百度账号登录开放平台官网

请在官网首页右上角找到登录入口，使用百度账号进行登录。如果您还没有百度账号，请按照百度账号统一注册流程进行注册。

step2: 申请账号认证并接入

登录后，点击官网首页图中【立即申请】或个人中心【申请认证账号并接入】进入申请接入页面。

在使用平台服务之前，您需要同意《百度网盘开放平台开发者服务协议》

2.创建应用

按照指示完成认证后，可前往控制台创建应用。

step1:创建应用

选择应用类别，填写应用名称、描述后，即可创建应用。

step2：获取Appid、ak、sk和Signkey

应用创建成功后将获取对应的Appid、AppKey(AK)、SecretKey (SK)和Signkey。

点击接入能力，即可参照技术文档，调用接口进行接入。

step3：配置redirect_uri

应用创建成功后，可以进入【应用详情】页，右上角【安全设置】，进行授权回调地址，即第三步，获取授权时所需redirect_uri参数的配置。
授权回调地址支持配置多个，多个地址之间，通过英文逗号进行分隔。
授权回调详细说明请参考百度开发者中心帮助文档：http://developer.baidu.com/wiki/index.php?title=docs/oauth/redirect

3.获取授权

step1: 了解百度OAuth

a. OAuth2.0(开放授权): 是一个开放标准，用户授权后，第三方应用无需获取用户的用户名和密码就可以访问该用户在某一网站上存储的私密的资源（如照片，视频，联系人列表）

b. Access_token: 用户身份验证和授权的凭证。第三方应用在调用百度网盘开放API之前，首先需要获取Access Token。

c. 详情信息请参考： http://developer.baidu.com/wiki/index.php?title=docs/oauth

step2: 根据自身业务场景，选择合适的授权方式

server端获取授权模式：如果应用有自己的server端，推荐使用授权码模式(grant_type=authorization code)获取授权。详情请参考一下步骤。

2.1引导用户到如下地址授权。

GET http://openapi.baidu.com/oauth/2.0/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&scope=basic,netdisk&display=tv&qrcode=1&force_login=1

参数说明

常见错误 https://openauth.baidu.com/doc/appendix.html

2.2：如果用户同意授权，页面跳转至

YOUR_REGISTERED_REDIRECT_URI/?code=CODE

2.3 ：用CODE换取Access_token

GET https://openapi.baidu.com/oauth/2.0/token?grant_type=authorization_code&code=CODE&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&redirect_uri=YOUR_REGISTERED_REDIRECT_URI

code说明：code作为换取access_token的票据，每次用户授权带上的code将不一样，code只能使用一次，10分钟未被使用自动过期。

参数说明

返回值说明

常见错误 https://openauth.baidu.com/doc/appendix.html

2.4 ：刷新Access_token

GET https://openapi.baidu.com/oauth/2.0/token?grant_type=refresh_token&refresh_token=REFRESH_TOKEN&client_id=API_KEY&client_secret=SECRET_KEY

参数说明

返回值说明

常见错误

https://openauth.baidu.com/doc/appendix.html

移动端获取授权模式：如果应用没有自己的server端，推荐使用简化模式(implicit grant),跳过授权码步骤，直接获取access_token。

3.1: 引导用户到如下地址授权。

http://openapi.baidu.com/oauth/2.0/authorize?response_type=token&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&scope=basic,netdisk&display=popup&state=xxx

参数说明

3.2：如果用户同意授权,页面跳转至 YOUR_REGISTERED_REDIRECT_URI 在Fragment中追加如下参数。

YOUR_REGISTERED_REDIRECT_URI#access_token=1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328&expires_in=86400&scope=basic%20netdisk&session_key=ANXxSNjwQDugf8615OnqeikRMu2bKaXCdlLxn&session_secret=248APxvxjCZ0VEC43EYrvxqaK4oZExMB&state=xxx

常见错误 https://openauth.baidu.com/doc/appendix.html

4.授权说明

4.1 授权回调地址

a. 对于有server的应用： 开发者必须在开发者中心预先注册应用所在的域名或URL，用以 OAuth2.0检验授权请求中的“redirect_uri”参数。以便保证OAuth2.0在回调过程中，会回调到安全域名。

b. 对于无server的应用 : 可传redirect_uri=oob。回调后会返回一个平台提供默认回调地址(http://openapi.baidu.com/oauth/2.0/login_success )

4.2 授权展示方式

4.3 其他注意事项

a. 在引导用户授权时，注意：scope参数固定传 basic,netdisk

b. 对于硬件厂商，需要在请求http://openapi.baidu.com/oauth/2.0/authorize?response_type=code时，多增加一个参数device_id，该device_id为设备注册接口返回的device_id。(参考开放平台设备管理接口文档)

c. 参考文档 https://openauth.baidu.com/doc/

通用错误码

错误码列表

账号错误码

授权&登录相关错误码参考:
https://openauth.baidu.com/doc/appendix.html