🚀 aBook v7 API Tester

Test all API endpoints directly in your browser

API Base URL:

User ID: 2

Book ID: 2

Auth Token: Not set

ID Token:

🔑 Firebase Auth

POST

Firebase Auth → abook-auth

authDomain = abook-auth.firebaseapp.com, projectId = abook-auth

Firebase apiKey:

Email:

Password:

⚠️ Note: POST, PUT, and DELETE requests require JSON payloads. Edit the JSON in the text areas before testing.

🏥 Health Check

API Health Check

GET

GET {API_BASE}/

Check if API is running and get version info

📎 Attachments (Stage 1.2)

Signed Upload Flow: signed-url → PUT → confirm → read-url

POST

POST /attachments/signed-url
PUT {upload_url}
POST /attachments/confirm
GET /attachments/read-url?scope=...&owner_id=...&media_file=...

This tests the Stage 1.2 canonical attachment contract:
• signed-url returns media_file (filename only) + upload_url
• browser does a PUT to GCS signed URL
• confirm checks object exists
• read-url returns a signed GET URL for preview/download

Signed-url JSON payload:

Select file to upload:

Use file.type for Content-Type:

Last media_file: (none)

Last upload_url: (none)

Last read_url: (none)

👤 User Endpoints

Get User Summary

GET

GET /user/2/summary

Get user profile info, clubs[], families[], and users_app map

Get User Inbox

GET

GET /user/2/inbox

Get all messages for user

Send Message to User

POST

POST /user/2/inbox

Send a new message to user inbox

JSON Payload:

Mark Messages as Read

PUT

PUT /user/2/inbox/read

Mark specific messages as read

JSON Payload (message IDs):

Delete Messages

DELETE

DELETE /user/2/inbox

Delete specific messages from inbox

JSON Payload (message IDs):

📚 Library Endpoints

Get User Library

GET

GET /user/2/library

Get all books in user's library

Get Book Details

GET

GET /books/2/details

Get DB-hydrated book details

📝 Annotation Endpoints

Create Annotation

POST

POST /annotations

Create a new annotation for a book. User ID derived from auth token.

JSON Payload: