Python examples

These examples use direct HTTP calls with Python 3.10+ and requests. For the Python SDK (pip install revdoku), see the Python SDK guide.

python3 -m venv .venv
. .venv/bin/activate
pip install requests

Set REVDOKU_API_KEY in your secret manager or local environment, then run:

python python/create-bucket.py
export REVDOKU_BUCKET_ID=bkt_RETURNED_ID
python python/read-tickets.py
python python/download-attachment.py tkt_RETURNED_ID eml_RETURNED_ID df_RETURNED_ID attachment.pdf

Run from examples/. Set REVDOKU_ACCOUNT_ID to select another granted account.
Omit the name to generate one. To choose a name, pass it as the argument;
EMAIL_ALREADY_EXISTS means it is unavailable. If a creation response is lost,
list your buckets before deciding whether to create another one.

Creation prints the bucket ID and its support email address. Reading prints JSON
metadata with ticket and attachment IDs, then updated_after; --show-body also prints body text.
Save the printed updated_after and set REVDOKU_UPDATED_AFTER for the next run.
A ticket comes back when it gets a new message, so deduplicate downstream effects by message ID. GET requests leave
shared read status unchanged. Attachment download prints the saved byte count.

Errors include the API’s code and message. For 429 request rate limits, respect Retry-After; monthly
allowances require waiting until reset or changing the plan. Never retry a write
blindly. Temporary attachment links expire after 15 minutes and take no API key.
Use the JavaScript/TypeScript examples for file uploads and a
bounded retry recipe. The ticket events section of the shared guide covers
webhook-receiver.py.