Skip to main content
Esta API põe o vídeo do Pictor dentro do seu sistema: a câmera ao vivo na ocorrência que o operador já está atendendo, o motivo de uma câmera não abrir, a gravação que o alarme guardou, os eventos de IA e o relatório de ronda. O operador não troca de janela.

​
O que dá para fazer

Mostrar o vídeo

Uma URL assinada e com prazo, ao vivo. Sem nome de fluxo, sem senha de câmera, sem conhecer o plano de mídia.

Saber por que não abre

Qual elo da cadeia falhou, e qual é a próxima ação. Sem abrir chamado.

Rever o que aconteceu

O clipe que o alarme guardou, e a linha do tempo para voltar a qualquer horário.

Entregar a ronda

Ronda periódica com veredito por câmera, e o relatório que o cliente final recebe.
Comece por Mostrar a câmera ao vivo: duas chamadas e o vídeo toca. Os Endpoints são a referência, gerada do próprio código.

​
Onde ela para

É uma API de leitura: não cadastra, não edita, não apaga. E o Pictor é o vídeo da operação, não a operação inteira: interfonia, controle de acesso e acionamento de portão são do seu sistema ou de outro fornecedor. Se a sua integração precisa escrever, fale com a gente antes de construir em cima da suposição. A superfície começa pequena de propósito, porque é mais fácil abrir depois do que fechar depois.

​
Três decisões antes do primeiro código

​
1. Uma chave é uma conta

Uma chave pertence a uma conta e nunca enxerga outra. Se você atende vários clientes do Pictor, recebe uma chave por conta.
Isso decide o seu multi-tenant. Guarde qual chave é de qual conta desde o primeiro dia, e faça a sua chave de câmera ser o par (conta, identificador): o identificador do equipamento só é único dentro de uma conta. Ver Casar o cadastro.
A chave também pode ser recortada dentro da conta, a um cliente ou a um mural. Uma chave scope=client não vê nada dos vizinhos: nem inventário, nem vídeo, nem gravação, nem evento.

​
2. O que é tempo real, e o que não é

O eixo de imagem é uma medição periódica, não um sinal ao vivo. Ele diz se chegou imagem dentro de uma janela de minutos. Tratar isso como prova de “a câmera caiu agora” gera alarme falso.

​
3. Você pergunta; nós não avisamos

Não existe webhook de saída hoje. O Pictor não faz POST no seu endereço quando uma câmera cai, um evento entra ou uma ronda fecha.
Isso não significa varrer câmera por câmera, que estoura o teto por desenho. Significa usar as duas rotas que respondem pela conta inteira de uma vez:
Com essas duas, uma integração que atende dezenas de contas fica muito abaixo do teto. O orçamento por rota está em Limites. Quando o webhook existir, o seu desenho não muda: este laço vira a rede de segurança.