Fractall CMMS

API de Gestão de Manutenção Industrial em Tempo Real

Autenticação

Acesso Especial

Utilize a chave mestre abaixo no Header de todas as suas requisições:

Header: X-API-Key
fra_live_72389145269018c642b7e0d3f1a

Pronto para copiar (cURL):

curl -X GET https://apifractal.codekid.ao/api/assets \
     -H "X-API-Key: fra_live_72389145269018c642b7e0d3f1a" \
     -H "Accept: application/json"

Endpoints da API

Método Endpoint Descrição
GET /api/locations Listar todas as localizações industriais.
GET /api/assets Listar o inventário de ativos (máquinas, caldeiras).
POST /api/assets Cadastrar novo ativo (Completo).
Ver Payload Completo 
{
  "location_id": 1,
  "nome": "Câmara Fria B",
  "codigo": "CAM-002",
  "numero_serie": "SN-99283",
  "modelo": "X-Freeze 500",
  "fabricante": "Industrial Cool Tech",
  "data_compra": "2024-01-15",
  "data_instalacao": "2024-02-01",
  "nivel_criticidade": "alto",
  "status": "operacional",
  "horas_operacao": 1250.5
}
PUT /api/assets/{id} Atualizar ativo.
Ver Payload 
{
  "nome": "Câmara Fria B - Atualizada",
  "status": "em_manutencao",
  "horas_operacao": 1300.2
}
POST /api/asset-failures Registrar falha/quebra.
Ver Payload Completo 
{
  "asset_id": 1,
  "data_falha": "2025-05-20 10:00:00",
  "descricao": "Vazamento de óleo no motor",
  "causa_provavel": "Desgaste da junta",
  "severidade": "critica",
  "status": "aberta"
}
GET /api/asset-failures Listar falhas (Filtros: ?asset_id=1&status=aberta).
GET /api/assets/{id}/history Ver histórico operacional do ativo.
POST /api/maintenance-plans Criar Plano de Manutenção.
Ver Payload Completo 
{
  "asset_id": 1,
  "titulo": "Revisão Trimestral",
  "descricao": "Inspeção completa",
  "tipo_manutencao": "preventiva",
  "checklist": ["Limpeza", "Aperto de parafusos", "Lubrificação"],
  "duracao_estimada_minutos": 120,
  "prioridade_padrao": "alta",
  "status": "ativo"
}
GET /api/maintenance-schedules Gestão de cronogramas.
POST /api/maintenance-schedules Criar Agendamento (Completo).
Ver Payload Completo 
{
  "maintenance_plan_id": 1,
  "tipo_gatilho": "tempo",
  "tipo_intervalo": "simestral",
  "valor_intervalo": 1,
  "unidade_intervalo": "Semestre",
  "horas_limite": null,
  "proxima_execucao": "2025-08-01",
  "gerar_automaticamente": true,
  "status": "ativo"
}
PUT /api/maintenance-schedules/{id} Atualizar agendamento/calendário.
Ver Payload 
{
  "proxima_execucao": "2025-07-01",
  "status": "ativo",
  "gerar_automaticamente": true,
  "unidade_intervalo": "Dias"
}
GET /api/work-orders Listar Ordens de Trabalho (OTs).
POST /api/work-orders Gerar OT manual.
Ver Payload Completo 
{
  "asset_id": 1,
  "maintenance_plan_id": null,
  "tecnico_id": 2,
  "codigo": "OT-MAN-001",
  "titulo": "Limpeza Química",
  "descricao": "Usar solvente X-9",
  "tipo": "corretiva",
  "prioridade": "alta",
  "status": "aberta",
  "data_agendada": "2025-06-15",
  "custo_estimado": 500.00
}
PUT /api/work-orders/{id} Atualizar/Encerrar OT.
Ver Payload de Fecho 
{
  "status": "concluida",
  "tecnico_id": 2,
  "data_inicio": "2025-06-15 08:00:00",
  "data_conclusao": "2025-06-15 10:30:00",
  "custo_real": 540.25
}

Como se Conectar

1. Base URL

Endereço oficial da API:

https://apifractal.codekid.ao

2. Formato

A API utiliza JSON para todas as comunicações.

Accept: application/json