curl --request GET \
--url https://api.pictor.cloud/api/recording-segments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pictor.cloud/api/recording-segments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pictor.cloud/api/recording-segments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pictor.cloud/api/recording-segments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pictor.cloud/api/recording-segments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pictor.cloud/api/recording-segments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pictor.cloud/api/recording-segments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"alarm": {
"account": "4021",
"alarm_id": "9f52a3b1-0c4d-4e6f-8a90-1b2c3d4e5f60",
"event_group": "Alarme",
"event_label": "Abertura de porta",
"occurred_at": "2026-09-03T03:12:02Z"
},
"appliance_id": null,
"camera_channel": 1,
"camera_id": "G87232574",
"camera_manufacturer": "Intelbras",
"camera_model": "VIP 1230 B",
"camera_name": "Guarita - entrada",
"camera_ref": "G87232574",
"client_name": "Cond. Alvorada",
"duration_s": 62,
"ended_at": "2026-09-03T03:13:06Z",
"file": "031204.mp4",
"partial": false,
"playback_url": "https://app.pictor.cloud/api/storage/recordings/5f6a7b80.mp4?exp=1788500000&t=4b2e9c",
"reason": "alarm",
"recording_id": "5f6a7b80-9c0d-4e1f-a2b3-c4d5e6f70819",
"related": [],
"session": null,
"site_address": "Rua das Acácias, 100",
"site_contact_name": null,
"site_contact_phone": null,
"site_external_ref": "4021",
"site_id": "1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
"site_name": "Cond. Alvorada - Portaria",
"size_bytes": 8412336,
"started_at": "2026-09-03T03:12:04Z",
"storage_backend": "s3",
"storage_bucket": "pictor-recordings",
"storage_key": "2026/09/03/G87232574/031204.mp4",
"tenant_id": "7c9e1f04-2b1a-4d3e-9f88-0a1b2c3d4e5f"
}
],
"limit": 50,
"offset": 0,
"total": 1
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Listar gravações
O que um alarme (ou uma ronda, ou alguém) mandou guardar — o acervo de gravações intencionais da conta, paginado e pesquisável.
Cada linha já vem tocável. playback_url é um endereço assinado e
temporário para o arquivo daquela gravação: quem lista pode tocar, sem uma
segunda chamada e sem conhecer nada do armazenamento. Ele vence — guarde os
bytes se precisa arquivar, nunca o link.
Quando a gravação nasceu de um evento, o bloco alarm diz qual evento: o
código, a descrição, a conta e a hora. Gravação manual ou agendada não tem esse
bloco, e a ausência é a informação (não inventamos uma origem para a linha não
ficar vazia).
Filtre por janela (from/to), por câmera, ou por texto livre em q — que
alcança nome de câmera, local, cliente, descrição do evento e conta.
camera_ref pode vir vazio, e isso é de propósito: ele promete o
identificador que casa com o seu lado, e quando a câmera foi apagada do cadastro
não existe esse identificador. camera_id sempre vem, mas pode cair no
identificador único interno nesse caso.
curl --request GET \
--url https://api.pictor.cloud/api/recording-segments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pictor.cloud/api/recording-segments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pictor.cloud/api/recording-segments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pictor.cloud/api/recording-segments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.pictor.cloud/api/recording-segments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.pictor.cloud/api/recording-segments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pictor.cloud/api/recording-segments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"alarm": {
"account": "4021",
"alarm_id": "9f52a3b1-0c4d-4e6f-8a90-1b2c3d4e5f60",
"event_group": "Alarme",
"event_label": "Abertura de porta",
"occurred_at": "2026-09-03T03:12:02Z"
},
"appliance_id": null,
"camera_channel": 1,
"camera_id": "G87232574",
"camera_manufacturer": "Intelbras",
"camera_model": "VIP 1230 B",
"camera_name": "Guarita - entrada",
"camera_ref": "G87232574",
"client_name": "Cond. Alvorada",
"duration_s": 62,
"ended_at": "2026-09-03T03:13:06Z",
"file": "031204.mp4",
"partial": false,
"playback_url": "https://app.pictor.cloud/api/storage/recordings/5f6a7b80.mp4?exp=1788500000&t=4b2e9c",
"reason": "alarm",
"recording_id": "5f6a7b80-9c0d-4e1f-a2b3-c4d5e6f70819",
"related": [],
"session": null,
"site_address": "Rua das Acácias, 100",
"site_contact_name": null,
"site_contact_phone": null,
"site_external_ref": "4021",
"site_id": "1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
"site_name": "Cond. Alvorada - Portaria",
"size_bytes": 8412336,
"started_at": "2026-09-03T03:12:04Z",
"storage_backend": "s3",
"storage_bucket": "pictor-recordings",
"storage_key": "2026/09/03/G87232574/031204.mp4",
"tenant_id": "7c9e1f04-2b1a-4d3e-9f88-0a1b2c3d4e5f"
}
],
"limit": 50,
"offset": 0,
"total": 1
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Authorizations
Chave de API da conta, no formato pct_<prefixo>_<segredo>.
Query Parameters
busca textual (câmera/sessão/id) — base p/ busca semântica
1 <= x <= 500x >= 0