Guias
Quickstart de Integração
Autentique, liste câmeras, calibre uma IA e leia eventos — do zero em minutos.
Quickstart de Integração
Neste guia você vai:
- Autenticar e obter um token.
- Listar as câmeras disponíveis.
- Criar uma câmera e calibrar uma IA.
- Ler eventos detectados.
Pré-requisitos
- Uma conta no Argos (
login+senha). curl(ouhttpx/fetchpara código).- Acesso à API:
https://argos.automatizase.com.br
Passo 1 — Autenticar
O endpoint /api/v1/auth/login aceita application/x-www-form-urlencoded com os campos
username e password (padrão OAuth2 Password Form). Retorna { "access_token": "...", "token_type": "bearer" }.
curl
TOKEN=$(curl -s -X POST https://argos.automatizase.com.br/api/v1/auth/login \
-d 'username=voce@empresa.com&password=SUA_SENHA' \
| jq -r '.access_token')
echo $TOKENJavaScript
const body = new URLSearchParams({ username: 'voce@empresa.com', password: 'SUA_SENHA' });
const resp = await fetch('https://argos.automatizase.com.br/api/v1/auth/login', {
method: 'POST',
body,
});
const { access_token: token } = await resp.json();Python
import httpx
r = httpx.post(
'https://argos.automatizase.com.br/api/v1/auth/login',
data={'username': 'voce@empresa.com', 'password': 'SUA_SENHA'},
)
token = r.json()['access_token']
headers = {'Authorization': f'Bearer {token}'}Passo 2 — Listar câmeras
curl
curl https://argos.automatizase.com.br/api/v1/cameras \
-H "Authorization: Bearer $TOKEN"Resposta:
[
{
"id": 1,
"nome": "Portaria Principal",
"rtsp_url": "rtsp://...",
"empresa_id": 7,
"ativa": true,
"ias_habilitadas": ["fogo", "invasao"]
}
]JavaScript
const cameras = await fetch('https://argos.automatizase.com.br/api/v1/cameras', {
headers: { Authorization: `Bearer ${token}` },
}).then(r => r.json());Python
cameras = httpx.get(
'https://argos.automatizase.com.br/api/v1/cameras',
headers=headers,
).json()Passo 3 — Criar uma câmera
Este passo requer o papel de administrador da conta.
curl
curl -X POST https://argos.automatizase.com.br/api/v1/cameras \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"nome": "Câmera Galpão",
"rtsp_url": "rtsp://192.168.0.50:554/stream",
"empresa_id": 7,
"ias_habilitadas": ["fogo", "epi"]
}'Resposta: { "id": 42, ... }
Passo 4 — Calibrar a IA de Fogo
A Calibração ajusta os limiares de uma IA por câmera via PATCH /api/v1/cameras/{id}
passando o campo config_ia.
curl
curl -X PATCH https://argos.automatizase.com.br/api/v1/cameras/42 \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"config_ia": {
"fogo": { "conf": 0.65 }
}
}'Parâmetro em config_ia | Descrição | Padrão |
|---|---|---|
fogo.conf | Confiança mínima da detecção (0–1) | 0.60 |
Passo 5 — Ler eventos
Eventos são as detecções persistidas. Filtre por câmera, tipo de IA ou veredito.
curl
# Últimos 20 eventos da câmera 42, apenas confirmados
curl "https://argos.automatizase.com.br/api/v1/events?camera_id=42&veredito=confirmado&limit=20" \
-H "Authorization: Bearer $TOKEN"JavaScript
const eventos = await fetch(
'https://argos.automatizase.com.br/api/v1/events?camera_id=42&veredito=confirmado&limit=20',
{ headers: { Authorization: `Bearer ${token}` } }
).then(r => r.json());Python
eventos = httpx.get(
'https://argos.automatizase.com.br/api/v1/events',
params={'camera_id': 42, 'veredito': 'confirmado', 'limit': 20},
headers=headers,
).json()Cada evento contém:
{
"id": 1001,
"tipo": "fogo",
"gravidade": "alta",
"criado_em": "2026-06-17T14:32:00Z",
"veredito": {
"resultado": "confirmado",
"confianca": 0.92,
"motivo": "Chama visível no canto inferior direito do frame."
},
"frame_url": "https://..."
}Próximos passos
- Autenticação — Bearer e OAuth/MCP em detalhe.
- Plugar câmeras — conectar câmeras diretamente ou via Gravador/DVR.
- Notificações — receber eventos via webhook/WhatsApp/email.
- Usando com agentes de IA — operação via Cursor/Claude Code.
- Referência da API — todos os endpoints.