公告 API V3 上线,实现 OAuth 2 认证,以及完善之前一直欠缺的 API 接口

huacnlee · 2015年05月18日 · 最后由 lihuazhang 回复于 2015年10月30日 · 10028 次阅读

抱歉,之前有在写 Ruby China 客户端的各位,由于最初的 API 设计考虑不周,存在隐患,后面我不得不将之前的 API 下掉了。

这次 V3 的 API 大致结构和之前的差别不是太大,只是增加了更细的规范,比如 OAuth 2 认证、要求注册 Application、统一的错误信息和返回格式等等。

这次还在 API 的性能上面做了改进(之前一直没关注,问题挺多了,还有 N+1 的情况...)

更新列表:

  1. 三方应用接入,必须注册 Application(个人设置 -> 管理应用程序 -> 创建);
  2. API 用 OAuth 2 的帐号认证机制,抛弃之前的 private_token 机制(此方式目前仍然用于浏览器 Push 通知);
  3. 新增一些必要的 API 接口(like, favorite, follow, block ...),同时完善性能和细节(估计 Notification 方面的还需要完善);
  4. ActiveModel::Serializer 代替 grape-entity,以便结构更符合 Rails 风格;
  5. API 内置 cancan 的权限机制,返回值里面也会告知当前用户对资源的权限情况;
  6. API 进化到 /api/v3;
  7. 更佳完善的 API 文档;

更多详细内容:https://github.com/ruby-china/ruby-china/pull/402

赞,楼主辛苦了……

1024 个赞

赞!坐等新的客户端上线!

太棒了!

酷 :plus1:

通一的错误信息和返回格式等等。

API 范本 :plus1:

3 年时间,没有营销情况下,用户数不知不觉达到了 18864。

手工点赞!

手工点赞!

:plus1: :plus1: :plus1: 🏆

21 楼 已删除

对 20 楼,表示深沉地恶视,中间空了一行,仔细才看到原来是删除了

25 楼 已删除

@huacnlee api 这边是否会提供缓存?

需要 登录 后方可回复, 如果你还没有账号请 注册新账号