> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pictor.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> O que a API do Pictor Cloud entrega a um sistema parceiro.

A API do Pictor Cloud dá ao seu sistema, **em leitura**, o que a conta de um
cliente já tem no Pictor: o inventário de câmeras, o diagnóstico de cada uma, os
eventos de analítico, o histórico de ronda, e uma URL de vídeo ao vivo.

## O que dá para fazer hoje

<CardGroup cols={2}>
  <Card title="Casar o cadastro" icon="camera">
    Liste as câmeras da conta com nome, local monitorado e cliente-dono, e
    concilie com o seu cadastro pelo identificador que você já usa.
  </Card>

  <Card title="Saber o que quebrou" icon="stethoscope">
    O diagnóstico responde se a câmera abre, e quando não abre diz a causa —
    sem abrir chamado e sem esperar alguém olhar.
  </Card>

  <Card title="Ler os eventos" icon="bell">
    Eventos de analítico por janela de tempo e por câmera, com a taxa de falso
    positivo agregada.
  </Card>

  <Card title="Mostrar o vídeo" icon="video">
    Uma URL assinada e com prazo para o vídeo ao vivo, sem você precisar
    conhecer o plano de mídia por trás.
  </Card>
</CardGroup>

## O que a API não faz

Esta é uma API **de leitura**. Ela não cadastra, não edita e não apaga nada — nem
câmera, nem cliente, nem usuário. Se a sua integração precisa escrever, fale com
a gente antes de construir em cima de uma suposição.

## Fronteira de conta

Uma chave pertence a **uma conta** e nunca enxerga outra. Se você atende vários
clientes do Pictor, você recebe uma chave por conta — e é isso que mantém
separável, depois, o que cada integração acessou.

<Note>
  A chave também pode ser **recortada dentro** da conta, a um cliente ou a um mural
  específico. Quem emite escolhe o alcance no momento da criação.
</Note>
