curl --request GET \
--url https://api.pictor.cloud/api/recording-segments/{recording_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pictor.cloud/api/recording-segments/{recording_id}"
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/{recording_id}', 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/{recording_id}",
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/{recording_id}"
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/{recording_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pictor.cloud/api/recording-segments/{recording_id}")
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{
"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=7d1f2a",
"reason": "alarm",
"recording_id": "5f6a7b80-9c0d-4e1f-a2b3-c4d5e6f70819",
"related": [
{
"camera_name": "Portaria - rua",
"camera_ref": "G87232575",
"duration_s": 62,
"partial": false,
"recording_id": "6a7b8c90-0d1e-4f2a-b3c4-d5e6f7081920",
"started_at": "2026-09-03T03:12:04Z"
}
],
"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"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Abrir uma gravação
Uma gravação, com o endereço de playback recém-assinado — e as câmeras irmãs.
Peça esta rota (em vez de reusar o playback_url da lista) quando o operador
for realmente abrir o vídeo: a assinatura sai nova, com prazo cheio.
related traz as OUTRAS gravações do mesmo alarme. Um evento num local com oito
câmeras produz oito gravações; sem essa lista quem abre uma não tem como saber
que as outras sete existem — e é justamente varrer os ângulos do mesmo instante
que resolve o atendimento.
curl --request GET \
--url https://api.pictor.cloud/api/recording-segments/{recording_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pictor.cloud/api/recording-segments/{recording_id}"
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/{recording_id}', 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/{recording_id}",
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/{recording_id}"
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/{recording_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pictor.cloud/api/recording-segments/{recording_id}")
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{
"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=7d1f2a",
"reason": "alarm",
"recording_id": "5f6a7b80-9c0d-4e1f-a2b3-c4d5e6f70819",
"related": [
{
"camera_name": "Portaria - rua",
"camera_ref": "G87232575",
"duration_s": 62,
"partial": false,
"recording_id": "6a7b8c90-0d1e-4f2a-b3c4-d5e6f7081920",
"started_at": "2026-09-03T03:12:04Z"
}
],
"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"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Authorizations
Chave de API da conta, no formato pct_<prefixo>_<segredo>.
Path Parameters
Response
Successful Response
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.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes