QMail Two-Client GET Test Calls

GET

Clickable GET calls for testing the QMail send and receive lifecycle with Client1 listening on port 8081 and Client2 listening on port 8082. Every link opens in a new window and has a copy button.

Client1 Sender SN 55076
@chariot.pyramid.byte
Client2 Receiver SN 55077
@chariot.harbor.byte
Flow Upload first, Tell second, then PEEK/PING and download.

How To Use These Links

Prepared for Local Two-Client Testing

These links assume core.exe is already running for Client1 and Client2. Use the status and identity links first. For deterministic manual PING/PEEK testing, stop Client2's background beacon before sending a test mail.

Replace Placeholder Values

Links containing REPLACE_WITH_FILE_GUID, REPLACE_WITH_TASK_ID, or REPLACE_WITH_ATTACHMENT_ID must be edited after a previous call returns the real value.

Client Readiness

Use these first to confirm both local rest_core clients are running and using the expected Mail wallet identity.

Client1 local status GET

Sender on port 8081.

http://localhost:8081/api/qmail/local/status
Client2 local status GET

Receiver on port 8082.

http://localhost:8082/api/qmail/local/status
Client1 identity GET

Expected SN 55076, address @chariot.pyramid.byte.

http://localhost:8081/api/qmail/local/identity/whoami
Client2 identity GET

Expected SN 55077, address @chariot.harbor.byte.

http://localhost:8082/api/qmail/local/identity/whoami

Receiver Beacon Control

Stop Client2 background beacon polling before deterministic manual PING/PEEK tests, then start it again when finished.

Client2 beacon status GET
http://localhost:8082/api/qmail/local/beacon/control?action=status
Client2 stop background beacon GET
http://localhost:8082/api/qmail/local/beacon/control?action=stop
Client2 start background beacon GET
http://localhost:8082/api/qmail/local/beacon/control?action=start

Beacon PEEK and PING

PEEK returns quickly. PING long-polls until a Tell arrives or the timeout expires.

Client2 PEEK all waiting tells GET
http://localhost:8082/api/qmail/net/beacon/peek?since=0
Client2 PING long-poll GET
http://localhost:8082/api/qmail/net/beacon/ping?timeout=120

Split Upload then Tell

This is the main troubleshooting flow: upload first, inspect task/receipt state, then tell the receiver beacon.

Client1 upload body only GET

Returns task_id and file_guid. Poll the task and receipt before calling Tell.

http://localhost:8081/api/qmail/net/messages/upload?body=Hello%20from%20a%20clickable%20QMail%20GET%20test.&to=%40chariot.harbor.byte&subject=QMail%20GET%20docs%20test&duration=4
Client1 upload body with attachment GET

Create this local file first if you want the attachment upload to succeed: E:\Client1\qmail_test_attachment.txt

http://localhost:8081/api/qmail/net/messages/upload?body=Hello%20from%20a%20clickable%20QMail%20GET%20test.&to=%40chariot.harbor.byte&subject=QMail%20GET%20docs%20test%20with%20attachment&duration=4&attachment_file_path=E%3A%5CClient1%5Cqmail_test_attachment.txt
Client1 tell after upload GET

Replace the placeholder with the file_guid returned by upload.

http://localhost:8081/api/qmail/net/messages/tell?file_guid=REPLACE_WITH_FILE_GUID

Convenience Upload and Tell

Use this when the caller wants the API to run upload and Tell back-to-back as one async task.

Client1 upload_and_tell GET
http://localhost:8081/api/qmail/net/messages/upload_and_tell?body=Hello%20from%20a%20clickable%20QMail%20GET%20test.&to=%40chariot.harbor.byte&subject=QMail%20GET%20docs%20test%20combined&duration=4

Observe and Download

After upload/tell, use task status and receipts on Client1, then PEEK/download on Client2.

Client1 read receipt GET

Replace guid with the returned file_guid.

http://localhost:8081/api/qmail/receipts?guid=REPLACE_WITH_FILE_GUID
Client1 task status GET

Replace id with the returned task_id.

http://localhost:8081/api/system/tasks?id=REPLACE_WITH_TASK_ID
Client2 download by GUID and sender SN GET

sender_sn can also come from the PEEK/PING notification.

http://localhost:8082/api/qmail/net/messages/download?file_guid=REPLACE_WITH_FILE_GUID&sender_sn=55076
Client2 list downloaded attachments GET
http://localhost:8082/api/qmail/db/attachments/list?email_id=REPLACE_WITH_FILE_GUID
Client2 attachment metadata GET
http://localhost:8082/api/qmail/db/attachments/get?email_id=REPLACE_WITH_FILE_GUID&attachment_id=REPLACE_WITH_ATTACHMENT_ID&info=1