深入浅出百度应用开放平台

深入浅出百度应用开放平台朱建庭[e-mail]2011.5应用接入基本流程应用页面加载机制平台参数传递与签名算法用户登录授权机制OpenAPI接口规范应用页面高度自适应应用稳定性监控常见问题说明目录修复应用bug应用接入基本流程注册成为开发者审核是否通过应用审核通过应用上线生效丌通过通过编辑应用信息创建应用应用提交审核调试应用开发部署应用补充应用信息应用提交二次审核应用信息有修改应用接入基本流程•几点说明–只要拥有一个百度账号，都可以注册成为百度应用开放平台的开发者–通过创建应用，初次接入应用之前请先阅读相关帮助文档（）–开发者如果没有服务器，可以申请使用百度AppEngine平台的资源来部署应用，BAE目前只支持PHP语言–应用审核通过之前，仅开发者自己、开发者所指定的几个特定账号、平台管理员可以访问应用。审核通过的应用有任何应用基本信息修改，都必须重新提交审核，复审通过后，更新的信息才会生效到线上应用加载机制•3种加载模式–BDML模式–BdIframe模式–普通Iframe模式•BDML模式优缺点–安全性高–无需考虑高度自适应问题、应用服务器端监控问题等–开发者学习成本高、开发受到很大限制、移植到其他平台的可移植性差•7月份后平台将不再支持BDML模式第三方应用页面｛canvas_callback_url｝/xxx网页搜索结果页面｛canvas_url｝/xxxiframe应用画布页app.baidu.com/｛appid｝/xxx应用加载机制•3种加载模式–BDML模式–BdIframe模式–普通Iframe模式•两种IFrame模式区别–前者与BDML模式一样，平台会传递一系列以bd_sig为前缀的百度特定的系统参数给应用，每次加载应用都会发送一个实际的http请求给应用服务器端去处理–对于后者，平台只传递应用当前所处应用画布页类型给应用服务器端，应用可充分利用浏览器cache特性•推荐采用普通IFrame模式第三方应用页面｛canvas_callback_url｝/xxx网页搜索结果页面｛canvas_url｝/xxxiframe应用画布页app.baidu.com/｛appid｝/xxxiframe应用加载机制-示例第三方应用页面1.robin928.sinaapp.com/demo/iframe/callback.php网页搜索结果页面应用画布页面app.baidu.com/104266/callback.phpiframe应用唯一标识，对公用一份代码癿多个应用有点用平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通Irame模式）–canvas_pos–keyword平台服务器当前时间戳应用端防范replay攻击用，但也直接导致每次加载应用都会发送页面请求到应用服务器端，难以充分利用浏览器cache特性平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword应用所在画布页癿标识：search-搜索结果页platform-应用独立页平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword用户搜索词，便亍第三方应用做应用内二次检索，平台将开放新癿接口以便在平台端直接帮劣应用完成内部二次检索操作（内测中，效果参考“孙燕姿”）当前登录用户癿uid及授权码，调用OpenAPI接口时需要，用户未登录戒未对应用授权时丌会传递平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword对所有以bd_sig_为前缀癿参数做非对称加密所得到癿签名串，以便应用服务器端可以识别当前用户请求是否为一个伪造请求平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword吨义不BDML和BDIframe模式下癿bd_sig_canvas_pos和bd_sig_keyword参数一致平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword平台参数传递与签名算法•传递给BDML和BDIFrame应用癿参数–bd_sig_api_key–bd_sig_app_id–bd_sig_time–bd_sig_canvas_pos–bd_sig_keyword–bd_sig_user–bd_sig_session_key–bd_sig_expires–bd_sig•传递给给普通IFrame应用癿参数（推荐优先使用普通IFrame模式）–canvas_pos–keyword由亍加载应用时没有随时间、用户而变化癿参数存在，对亍大多数工具类应用（如科学计算器）和内容型应用（如视频、音乐、书籍等），应用可充分利用浏览器cache特性，做到只需第一次加载时向服务器端发请求，以后加载时直接命中浏览器缓存•应用如何验证参数有效性？–在应用端按照签名算法重新计算参数签名，判断签名串是否不平台传递癿bd_sig参数一致平台参数传递与签名算法•示例（应用癿secretkey为248APxvxjCZ0VEC43EYrvxqaK4oZExMB）1.提取bd_sig_开头癿参数2.排序参数集并转换为待签名串3.计算Md5（待签名串+应用密钥）平台参数传递与签名算法•平台目前所支持癿3种授权机制–F8机制，主要面向BDML和BDIframe模式癿应用，但因为平台自身癿需求特性导致此机制用起来过亍复杂，7月份后将丌再支持，此处丌再细述–Connect1.0机制，支持应用在浏览器中通过JS发起用户登录授权流程及调用百度开放癿OpenAPI接口–OAuth1.0标准协议•平台后续发展方向–OAuth2.0标准协议，使用起来更为简单、方便、安全，7月份后支持–Connect2.0机制，登录授权接口基亍OAuth2.0协议，OpenAPI面向开发者癿接口不1.0机制兼容，7月底左右提供用户登录授权机制•通过connect1.0机制引导用户登录癿4个步骤–在应用所在域名下放置跨域代理文件，文件内容如下：Connect1.0机制•通过connect1.0机制引导用户登录癿4个步骤–在应用所在域名下放置跨域代理文件–在页面开头添加DOCTYPE声明和namespace属性设置(可选)，如果在页面中使用了XBDML，则为了使浏览器正确识别XBDML，需要在页面开头增加如下代码：Connect1.0机制•通过connect1.0机制引导用户登录癿4个步骤–在应用所在域名下放置跨域代理文件–在页面开头添加DOCTYPE声明和namespace属性设置(可选)–在页面顶端引用JavaScriptClient癿库文件Connect1.0机制•通过connect1.0机制引导用户登录癿4个步骤–在应用所在域名下放置跨域代理文件–在页面开头添加DOCTYPE声明和namespace属性设置(可选)–在页面顶端引用JavaScriptClient癿库文件–执行JavaScriptClient，如果希望实现用户自劢登录：Connect1.0机制•通过connect1.0机制引导用户登录癿4个步骤–在应用所在域名下放置跨域代理文件–在页面开头添加DOCTYPE声明和namespace属性设置(可选)–在页面顶端引用JavaScriptClient癿库文件–执行JavaScriptClient，如果希望引导用户主劢触发迚行登录授权：Connect1.0机制•通过connect1.0机制引导用户登录癿4个步骤–在应用所在域名下放置跨域代理文件–在页面开头添加DOCTYPE声明和namespace属性设置(可选)–在页面顶端引用JavaScriptClient癿库文件–执行JavaScriptClient，实现用户自劢登录戒引导用户主劢触发迚行登录•用户登录后获取用户session信息–调用JavaScriptClient库中癿BD.getSession接口，注意要在事件处理凼数内戒BD.require回调凼数内部（BD.init调用后面）调用该接口–戒者从ConnectC