🚀 aBook v7 API Tester

authDomain = abook-auth.firebaseapp.com, projectId = abook-auth, storageBucket = abook-auth.firebasestorage.app

Check if API is running and get version info

Get user profile information, clubs[], families[], and users_app map (user_id -> {username, avatar_file}).

Get all messages for user

Send a new message to user inbox

Mark specific messages as read

Delete specific messages from inbox

List book clubs where user is a member

List families where user is a member

Get club details and members list

Request membership in a club (self)

Approve membership (admin only)

Remove member from club (admin only)

Leave club as the authenticated user

Get family details and members list

Request membership in a family (self)

Approve membership (admin only)

Remove member from family (admin only)

Leave family as the authenticated user

Get all books in user's library

Enter an ISBN and click Lookup ISBN. This will:
1) call /scan/isbn and show the JSON response
2) poll until book_core.book_id exists (or max polls reached)
3) then fetch /books/{book_id}/details and show the DB response

Get all messages/comments for a book

Post a club message with optional photo/video attachment (images auto-convert to WebP; files saved under /API/booktalk/{book_id}/msg_{message_id}.ext)

Create a new annotation for a book. User ID is automatically derived from authentication token.

Update an existing annotation (replace {annotation_id} with actual ID)

Delete an annotation (replace {annotation_id} with actual ID)

Upload a photo or video for an existing annotation (stored under /API/users/{user_id}/annotations/note_{annotation_id}_{attachment_id}.ext)

Get ownership and borrowing history for a tag (UUID: 1-14 characters). Includes tag_context and user_book_history (ownership_current/borrower_current + history arrays). Use users_app from /user/{user_id}/summary to resolve username+avatar for any user_id.

Borrow a book tag from another user. Requires valid borrowPIN. Checks if already borrowed. Returns borrower_user_id, borrower_username, owner_user_id, owner_username. Error if already borrowed includes borrowed_by_user_id, borrowed_by_username, and due_date. Error 22 if borrowPIN is incorrect.

Return a borrowed tag. Only the owner (authenticated user) can return. Generates new borrowPIN. Error 24 if not owner, Error 19 if not borrowed.

Transfer/Buy tag ownership. Authenticated user is the buyer/receiver. Requires seller's ownerPIN. Generates new ownerPIN after successful transfer. Returns from_user_id (seller), to_user_id (buyer), new_ownerPIN. Error 23 if ownerPIN is incorrect.

Link a tag UUID to a book_id. Requires valid owner_pin for verification. Error 15 if owner_pin is incorrect.