Phone

Get the live view

Mint an opaque, expiring view-only viewer URL for a ready session: the same live video as the owner viewer, without input. This is what a watch link opens. The session owner may call it with a bearer credential; a watch link's holder passes its view grant as the token query parameter. Treat the URL as a secret and never log it. Embedding is restricted to the Phone Harness dashboard origin. Reconnection does not extend the phone deadline.

get/sessions/{sid}/viewer

Request

Base URL
https://api.phone-harness.com
Auth
- HTTP bearer
- or none

Path parameters

sidstring required

Session ID returned by POST /sessions.

Query parameters

tokenstring

The session's view grant from its watch_url. Used instead of a bearer credential by watch link holders.

Response

View-only viewer capability; private, no-store.

urlstring uri required

Opaque sensitive viewer capability. Current embedding is restricted to the configured Phone Harness dashboard origin.

expires_atnumber required

Viewer expiry; no later than the session expiry. Unix time in seconds.

Changes

No recorded changes to this operation across all 1 revision of this API.