ringwire

A typed Python client for the Ring Partner API (the api.amazonvision.com API behind the Ring Appstore), including the parts most samples skip: sensors, the two-step media downloads, chime playback, webhook verification, and the account-linking nonce.

Built for Watermark and published on its own so other Ring Appstore developers do not have to re-read the docs I already read.

pip install ringwire

What it covers

Things the docs say that this library enforces

• The image and clip endpoints never trigger a capture. A 416 raises MediaNotFound so the caller can start a live session first.
• Sensor events have no history endpoint. Persist them on receipt.
• Webhook signatures are computed over the raw body bytes. Pass the bytes, not the parsed JSON.
• Refresh tokens are not Bearer tokens.

Example

from ringwire import RingClient, verify_and_parse

client = RingClient(access_token)
sensors = [d for d in client.list_devices() if client.status(d.id).flood_faulted is not None]

# In your webhook handler (raw bytes, before any JSON parsing):
event = verify_and_parse(raw_body, headers["X-Signature"], signing_key)
if event.type == "flood_detected":
    ...

Tests

pip install -e ".[dev]" && pytest

MIT. Not affiliated with Ring or Amazon.