appwrite-go

用途：面向使用 Go 构建服务端应用（含 SSR 框架如 net/http、Gin、Echo、Chi）的开发者，提供 Appwrite Go SDK 的使用指引。安装：go get github.com/appwrite/sdk-for-go。客户端通过 client.New 配合 WithEndpoint、WithProject、WithKey 初始化。主要能力：用户管理（users 服务的创建、列表、获取、删除）；数据库/表 CRUD，新代码应使用 tablesdb 而非已弃用的 Databases，字符串列类型推荐显式 varchar、text、mediumtext、longtext，其中 varchar 存于行内并计入 64 KB 行限制，其余为页外存储；查询方法由 query 包提供，含比较、范围、空值、前缀/后缀/包含、搜索、排序、分页（Limit 默认 25、最大 100，推荐 CursorAfter 游标分页）及 Or/And 逻辑；文件存储用 storage 服务，配合 file.NewInputFile 等工厂方法；teams 服务支持团队与成员管理，权限用 role.Team；functions 服务可执行函数，Go 运行时入口为 handler.Main，通过 openruntimes.Context 访问请求。SSR 认证区分管理员客户端（API Key，可复用）与会话客户端（每请求创建，不共享），会话 Cookie 名称须为 a_session_<PROJECT_ID>，并设置 HttpOnly、Secure、SameSiteStrictMode；支持邮箱密码登录与 OAuth2 流程。错误处理使用 apperr.AppwriteException 读取 Message、Code、Type，常见错误码包括 401、403、404、409、429。权限通过 permission 与 role 辅助函数构造，未显式设置权限时默认无人可访问；应避免对敏感数据使用 role.Any() 读权限或对写操作使用 role.Any()。限制：详细内容以资料为准，未提供的功能、价格与平台信息暂未提供。