该技能面向使用 Appwrite Ruby SDK 构建服务端 Ruby 应用的场景,适用于 Rails、Sinatra 等框架集成。安装命令为 gem install appwrite。初始化时通过 Client.new 设置 endpoint、project 与 API key,客户端需 require 'appwrite' 并 include Appwrite。
主要能力覆盖:用户管理(创建、列表、获取、删除用户);数据库操作,其中新代码应使用 TablesDB 而非已废弃的 Databases 类,方法参数优先使用关键字参数;字符串列类型区分 varchar、text、mediumtext、longtext,各自有字符上限与索引、存储差异;提供 Query 过滤、排序、分页(含 cursor 分页)与逻辑组合;文件存储支持 InputFile.from_path 与 from_string;团队与成员管理支持基于角色的权限;函数执行与 Ruby runtime 处理程序编写;以及 SSR 认证,区分使用 API key 的 admin client 与按请求创建的 session client,登录 cookie 名须为 a_session_<PROJECT_ID>,并建议设置 httponly、secure、same_site: :strict,OAuth2 需先获取 token 再换取会话。
权限通过 Permission 与 Role 辅助方法构成字符串数组,未显式设置时默认无人可访问,需注意 Role.any 搭配写权限及敏感数据公开读取的风险,错误处理可用 Appwrite::Exception 获取 message、code、type 与 response。资料未提供收费、价格与性能表现等信息。