curl --request GET \
--url https://api.pictor.cloud/api/devices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pictor.cloud/api/devices"
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/devices', 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/devices",
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/devices"
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/devices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pictor.cloud/api/devices")
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": [
{
"capabilities": [
"live",
"recording"
],
"channel": 1,
"client_id": "2e3f4a51-6b7c-4d8e-9f01-1a2b3c4d5e6f",
"client_name": "Cond. Alvorada",
"codec": "h264",
"connection": {
"credentials_required": true,
"settings": {
"channel": 1,
"device_serial": null,
"remote_port": null
},
"type": "rtsp_direct"
},
"device_id": "G87232574",
"device_type": "ip_camera",
"device_uuid": "0b8f1c22-6d4e-4a17-9b02-3f5a7c8d9e10",
"dvr_id": "3a4b5c60-7d8e-4f01-a2b3-c4d5e6f70819",
"dvr_name": "DVR Portaria",
"dvr_total_channels": 16,
"image_state": "with_frame",
"last_frame_at": "2026-09-03T18:42:11Z",
"last_seen": "2026-09-03T18:42:11Z",
"live": "online",
"live_status_available": true,
"location": {
"name": "Portaria",
"zone": "Perímetro"
},
"manufacturer": "Intelbras",
"model": "VIP 1230 B",
"monitored_site_id": "1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
"monitored_site_name": "Cond. Alvorada - Portaria",
"name": "Guarita - entrada",
"owner_client_id": "2e3f4a51-6b7c-4d8e-9f01-1a2b3c4d5e6f",
"owner_client_name": "Cond. Alvorada",
"sowil_registro": "4021",
"sowil_site_id": "4021",
"status": "online",
"tax_id": "12.345.678/0001-90",
"thumbnail_url": "/api/thumbs/G87232574",
"transmitting": "yes"
}
],
"limit": 100,
"offset": 0,
"total": 128,
"transmitting_window_seconds": 900,
"transmitting_witness_fresh": true,
"transmitting_witness_last_success_at": "2026-09-03T18:41:03Z"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Listar câmeras
As câmeras que esta chave enxerga, paginadas, cada uma com o local monitorado e o cliente-dono já resolvidos — é a rota que casa o seu cadastro com o nosso.
Dois eixos, e eles discordam de propósito. status é CADASTRO: o que
sabemos da câmera desde a última vez que alguém a configurou ou testou.
transmitting é IMAGEM: se um quadro chegou dentro da janela. Uma câmera
active que não transmite existe, e é o caso mais comum de reclamação de
morador. Para “quais câmeras estão sem imagem agora”, filtre
transmitting=no — uma chamada por conta responde pela frota inteira, e é
muito mais barato que diagnosticar câmera por câmera.
transmitting_witness_fresh no envelope diz se a medição de imagem está viva.
Quando vier false, “0 câmeras transmitindo” significa não deu para medir,
não “todas caídas” — tratar os dois como a mesma coisa gera alarme falso em
massa.
A armadilha do identificador. device_id é o identificador do
equipamento e é único dentro da conta, não entre contas. Se você atende
várias contas, a sua chave primária tem de ser o par (conta, device_id) —
ou o device_uuid, que é único em qualquer lugar.
curl --request GET \
--url https://api.pictor.cloud/api/devices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.pictor.cloud/api/devices"
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/devices', 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/devices",
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/devices"
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/devices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pictor.cloud/api/devices")
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": [
{
"capabilities": [
"live",
"recording"
],
"channel": 1,
"client_id": "2e3f4a51-6b7c-4d8e-9f01-1a2b3c4d5e6f",
"client_name": "Cond. Alvorada",
"codec": "h264",
"connection": {
"credentials_required": true,
"settings": {
"channel": 1,
"device_serial": null,
"remote_port": null
},
"type": "rtsp_direct"
},
"device_id": "G87232574",
"device_type": "ip_camera",
"device_uuid": "0b8f1c22-6d4e-4a17-9b02-3f5a7c8d9e10",
"dvr_id": "3a4b5c60-7d8e-4f01-a2b3-c4d5e6f70819",
"dvr_name": "DVR Portaria",
"dvr_total_channels": 16,
"image_state": "with_frame",
"last_frame_at": "2026-09-03T18:42:11Z",
"last_seen": "2026-09-03T18:42:11Z",
"live": "online",
"live_status_available": true,
"location": {
"name": "Portaria",
"zone": "Perímetro"
},
"manufacturer": "Intelbras",
"model": "VIP 1230 B",
"monitored_site_id": "1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
"monitored_site_name": "Cond. Alvorada - Portaria",
"name": "Guarita - entrada",
"owner_client_id": "2e3f4a51-6b7c-4d8e-9f01-1a2b3c4d5e6f",
"owner_client_name": "Cond. Alvorada",
"sowil_registro": "4021",
"sowil_site_id": "4021",
"status": "online",
"tax_id": "12.345.678/0001-90",
"thumbnail_url": "/api/thumbs/G87232574",
"transmitting": "yes"
}
],
"limit": 100,
"offset": 0,
"total": 128,
"transmitting_window_seconds": 900,
"transmitting_witness_fresh": true,
"transmitting_witness_last_success_at": "2026-09-03T18:41:03Z"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}Authorizations
Chave de API da conta, no formato pct_<prefixo>_<segredo>.
Query Parameters
1 <= x <= 500x >= 0Busca por nome da câmera, external_id, rótulo do local, DVR, nome do Local Monitorado ou do cliente-dono
Filtro server-side: online | offline
Eixo de IMAGEM (testemunha de quadro), independente de status: yes = chegou quadro dentro da janela; no = já chegou quadro, mas fora da janela; unknown = nunca chegou quadro desta câmera
^(yes|no|unknown)$Recorte exato por cliente-dono (UUID)
Recorte exato por Local Monitorado (UUID)
Hidratação por external_id (CSV, máx 16) — a rota do mural, que exibe no máximo 16 câmeras
Inclui diagnostico_resumo (rollup de causa sobre o recorte inteiro). DESLIGADO por padrão: é uma agregação sobre todas as câmeras do recorte, e no maior tenant custa ~30 ms — caro demais para a abertura normal da grade, que não desenha o resumo.
imagem (default) = câmeras que estão entregando quadro primeiro, depois por recência do último quadro; recentes = ordem de cadastro (comportamento anterior). Com a testemunha de quadro parada, imagem cai para recentes.
^(imagem|recentes)$Response
Successful Response