API de Eventos de Notificações (Aberturas e Movimentos)

Este documento descreve os endpoints definidos em `notifications/views.py`

Este documento descreve os endpoints definidos em notifications/views.py responsáveis por:

• Registrar movimentos de câmera (eventos externos) via CameraView.

• Registrar aberturas de porta (controle facial) via ActivityView.

Sumário de Endpoints

Método	Caminho	Função
POST	/api/notifications/camera	Registrar movimento de câmera (evento Monuv / externo)
POST	/api/notifications/activity	Registrar abertura por reconhecimento facial (face_control)

---

1. Registrar Movimento de Câmera — CameraView (POST)

Callback simples para registrar um movimento relacionado a uma câmera existente.

Payload esperado (JSON)

{
  "camera_id": "<monuv_id>",
  "event_at": "YYYY-MM-DD HH:MM:SS"  // horário base do evento
}

Respostas

Código	Corpo
201	"Movimento registrado com sucesso"
400	"Erro ao registrar movimento: "

Exemplo cURL

curl -X POST -H "Content-Type: application/json" \
  -d '{"camera_id": "MONUV123", "event_at": "2025-11-18 15:42:10"}' \
  https://audit.preddita.com.br/notifications/camera

---

2. Registrar Abertura (Face Control) — ActivityView (POST)

Endpoint que recebe eventos de abertura por reconhecimento facial. Apenas processa se type == "face_control".

Formatos suportados

• application/json

• application/x-www-form-urlencoded

Payload mínimo esperado (exemplos de estrutura)

Para application/json:

{
  "type": "face_control",
  "qrcode": ["12345"],
  "actor_name": ["Maria Silva"]
}

Para application/x-www-form-urlencoded (chaves repetidas podem virar listas):

type=face_control&qrcode=12345&actor_name=Maria%20Silva

Possíveis Respostas

Código	Corpo
201	{"message": "Abertura criada com sucesso"}
400	{"error": "actor_name é obrigatório"}
404	{"error": "Dispositivo não encontrado"}
406	{"message": "Tipo não suportado"}
500	{"error": "Erro ao criar abertura"}

Exemplo cURL

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "face_control",
    "qrcode": ["78901"],
    "actor_name": ["Joao Souza"]
  }' \
  https://audit.preddita.com.br/notifications/activity