V1到V2怎么迁移

简述

• V1迁移到V2主要需要完成OAuth1.0到OAuth2.0的过度及完成V1原有接口与V2中新接口的对应替换。

迁移时需要完成的工作

• 1、授权方式的迁移，OAuth1.0升级到OAuth2.0；
• 2、阅读迁移注意事项及常见问题解决建议；
• 3、新旧接口的迁移，接口调用地址、调用方式、参数、返回值、错误信息处理的代码改造。

OAuth1.0升级到OAuth2.0

• 1、OAuth2.0简述
  • OAuth2.0是较OAuth1.0更简单更安全的授权方式，同时支持Web，桌面和移动应用。是未来新浪微博开放平台最主要的用户身份验证和授权方式。

• 2、迁移前准备
  • 请先阅读OAuth2.0开发指南。
  • OAuth2.0授权方式与OAuth1.0相比，引入授权回调页与绑定域名，简化了授权流程，同时也提升了授权的安全性。

• • 在实现OAuth2.0授权方式前，针对不同的应用我们需要设置应用的授权回调页或进行域名的绑定，用于获得授权成功后返回的code，再通过code获取access_token。

• • 使用开发者帐号登录http://open.weibo.com，进入“我的应用”控制台需要迁移的应用进行设置：
  • a）网站接入类
    • 点击控制台导航“网站信息”，在网站基本信息中查看网站域名。如果您的网站应用还未验证所有权，会提示您进行所有权验证，点击进入验证页面完成所有权验证。Web应用请参考：Web应用迁移指引 。

• • • 注意：验证时填写的网站域名即为您的应用的绑定域名。

• • b）站内应用
    • 站内应用已经是OAuth2.0授权方式，无需做改动。

• • c）客户端应用 & 其他应用
    • 点击控制台导航“应用信息”—> “高级信息”，进行授权回调页或域名的绑定。设置回调页不需要二审，方便您进行测试开发。绑定域名需要进行二审，二审时线上应用不受影响，绑定域名增加应用的安全性，同时该域名下的所有页面都可作为授权回调页。

• • • 注意：客户端也需要设置授权回调页或绑定域名，在程序中以webview的方式进行调用授权页面返回code，具体实现可
      • • 以参考：移动应用迁移指引 。 其他客户端可以参考相应SDK：http://open.weibo.com/wiki/SDK 。

• 3、OAuth2.0授权实现
  • 主要流程（请先阅读OAuth2.0开发指南）：

• • a）引导需要授权的用户访问如下地址

• • • https://api.weibo.com/oauth2/authorize?client_id=YOUR_APP_KEY&response_type=code&redirect_uri=YOUR_REGISTERED_REDIRECT_URI ；

• • • 注意：redirect_uri必须为绑定域名下网页或设置的回调地址。

• • b）如果用户同意授权,页面跳转至 YOUR_REGISTERED_REDIRECT_URI/?code=CODE

• • • 注意：每次返回的code值都是不一样的且在换取access_token后失效。

• • c）使用code换取access_token

• • • https://api.weibo.com/oauth2/access_token?client_id=YOUR_APP_KEY&client_secret=YOUR_APP_SECRET&grant_type=authorization_code&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&code=CODE ；

• • • 注意：必须使用POST方式提交，其中client_id=YOUR_APP_KEY&client_secret=YOUR_APP_SECRET可以使用
      • • basic方式加入header中。

• • d）返回值
    • {"access_token":"SlAV32hkKG","remind_in":"3600","expires_in":3600,"uid":"1902538057"}
    • 注意：OAuth2.0的access_token较OAuth1.0具有一定的有效期，当access_token过期时需要引导用户重新授权。应用
      • • 的授权有效期可以访问接口访问权限说明或在应用控制台查看。

• • e）使用获得的OAuth2.0 Access Token调用API
    • 读取接口一般使用GET方式提交，如：
    • 接口：statuses/home_timeline
    • 调用：https://api.weibo.com/2/statuses/home_timeline.json?access_token=SlAV32hkKG&count=20 ；

• • • 写入接口必须使用POST方式提交，如：
    • 接口：statuses/upload
    • 调用：https://upload.api.weibo.com/2/statuses/upload.json

• • • 注意：参数信息放入header及body中，除access_token外，其他参数必须放入body中请求。
    • upload请求消息体举例：

• • • • => Send header, 301 bytes (0x12d)
      • POST /2/statuses/upload.json HTTP/1.1
      • User-Agent: curl/7.19.4 (i586-pc-mingw32msvc) libcurl/7.19.4 Ope
      • nSSL/0.9.8g zlib/1.2.3
      • Host: upload.api.weibo.com
      • Accept: */*
      • Content-Length: 38694
      • Expect: 100-continue
      • Content-Type: multipart/form-data; boundary=--------------------
      • --------8933e7b00565

• • • • <= Recv header, 23 bytes (0x17)
      • HTTP/1.1 100 Continue
      • => Send data, 370 bytes (0x172)
      • ------------------------------8933e7b00565
      • Content-Disposition: form-data; name="access_token"

• • • • 2.00RQs9XCmlEQDD4fb4b0bfe3Be7ZQE
      • ------------------------------8933e7b00565
      • Content-Disposition: form-data; name="status"

• • • • Test02
      • ------------------------------8933e7b00565
      • Content-Disposition: form-data; name="pic"; filename="psu.jpg"
      • Content-Type: image/jpeg

V1接口迁移到V2接口

• 在实现OAuth2.0授权后，接下来需要将应用使用的V1版接口对应迁移到V2版接口。此时需要根据新接口的调用地址、调用方式、参数、返回值、错误信息处理来进行代码的改造。

• 以下是V2版接口与V1版接口的对应列表，部分旧版接口由于用户投诉或性能等原因已不再提供，同时新版接口提供丰富的高级接口开放优质应用申请，您可以直接在应用控制台中提交高级接口申请。

• 此外，SCOPE授权功能、好友分组接口、邀请接口、社交化等接口已经在平台开放计划中，我们将在保证功能、性能及稳定性后适时开放，详细的开放日期请您关注@微博API。
• 如果现有接口未能满足您的需求，欢迎@微博API进行反馈，我们将根据开发者需求强度及微博用户利益权衡适度开放。