抱歉,之前有在写 Ruby China 客户端的各位,由于最初的 API 设计考虑不周,存在隐患,后面我不得不将之前的 API 下掉了。
这次 V3 的 API 大致结构和之前的差别不是太大,只是增加了更细的规范,比如 OAuth 2 认证、要求注册 Application、统一的错误信息和返回格式等等。
这次还在 API 的性能上面做了改进(之前一直没关注,问题挺多了,还有 N+1 的情况...)
更新列表:
- 三方应用接入,必须注册 Application(个人设置 -> 管理应用程序 -> 创建);
- API 用 OAuth 2 的帐号认证机制,抛弃之前的 private_token 机制(此方式目前仍然用于浏览器 Push 通知);
- 新增一些必要的 API 接口(like, favorite, follow, block ...),同时完善性能和细节(估计 Notification 方面的还需要完善);
- ActiveModel::Serializer 代替 grape-entity,以便结构更符合 Rails 风格;
- API 内置 cancan 的权限机制,返回值里面也会告知当前用户对资源的权限情况;
- API 进化到 /api/v3;
- 更佳完善的 API 文档;
更多详细内容:https://github.com/ruby-china/ruby-china/pull/402