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{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}As câmeras da conta
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{
"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