Skip to main content
GET
Uma gravação, pronta para tocar

Authorizations

Authorization
string
header
required

Chave de API da conta, no formato pct_<prefixo>_<segredo>.

Headers

X-Membership-ID
string | null
X-Tenant-ID
string | null

Path Parameters

recording_id
string
required

Response

Successful Response

camera_id
string
required
partial
boolean
required
recording_id
string
required
started_at
string<date-time>
required
storage_backend
string
required
storage_bucket
string
required
storage_key
string
required
tenant_id
string
required
alarm
RecordingAlarmOut · object | null

O alarme que mandou gravar — o "porquê" da gravação.

Só existe quando a gravação nasceu de um evento (pictor.alarm_event_log casado pelo alarm_id determinístico). Gravação manual/agendada não tem alarme e o campo vem None — não se inventa evento para preencher tela.

Os campos vêm de uma LISTA BRANCA de caminhos do payload do provedor. O dossiê cru carrega senha/contra_senha/coacao do local; nada disso pode vazar para uma tela de gravação, e a forma de garantir isso é nunca projetar o payload inteiro — só estes caminhos.

appliance_id
string | null
camera_channel
integer | null
camera_manufacturer
string | null
camera_model
string | null
camera_name
string | null
camera_ref
string | null
client_name
string | null
duration_s
number | null
ended_at
string<date-time> | null
file
string | null
playback_url
string | null

URL do vídeo pelo proxy do gateway (/api/storage/…), com TTL de 1h. NUNCA a URL crua do object storage. null significa SEM VÍDEO TOCÁVEL — quem consome deve falhar honesto e não cair no ao vivo.

reason
string | null
session
string | null
site_address
string | null
site_contact_name
string | null
site_contact_phone
string | null
site_external_ref
string | null
site_id
string | null
site_name
string | null
size_bytes
integer | null