appwrite-go

Install github.com/appwrite/sdk-for-go, then call client.New with functional options: WithEndpoint, WithProject, and WithKey using your API key. Each service (users, tablesdb, storage) is constructed from that client via its own New function.

Use the tablesdb service, not the deprecated Databases class. Call CreateRow with a data map, and pass query helpers like query.Equal, query.Limit, or query.CursorAfter for filtering, sorting, and pagination.

Use TablesDB for all new code; the Databases class is deprecated. Only use Databases when maintaining an existing codebase that already depends on it or when explicitly required.

Use two clients: an admin client with an API key to create sessions, and a per-request session client that reads the a_session_<PROJECT_ID> cookie. Set the cookie with HttpOnly, Secure, and SameSiteStrict flags after login.

Appwrite grants no access by default; permissions must be set explicitly at the row/file level or inherited from table/bucket settings. Build them with helpers like permission.Read(role.User(id)) and avoid role.Any() with write permissions.

Use errors.As to unwrap the error into *apperr.AppwriteException, which exposes Message, HTTP Code, and Type fields. Common codes include 401 for invalid credentials, 404 for missing resources, and 429 for rate limits.