Documentação da API

Autenticação

Todas as requisições à API devem incluir o header X-API-Key com a sua chave de API.

POST /api/v1/auth.php

Obter API Key através de login.

                    curl -X POST https://crm360.changeip.ao/api/v1/auth.php \

                      -H "Content-Type: application/json" \

                      -d '{"email": "seu@email.com", "senha": "sua-senha"}'

                // Exemplo de header para todas as requisições

                X-API-Key: sua-api-key-aqui

Clientes

GET /api/v1/clientes.php

Listar todos os clientes da empresa.

Parâmetros opcionais: ?pagina=1&limite=20

                    curl https://crm360.changeip.ao/api/v1/clientes.php \

                      -H "X-API-Key: sua-api-key"

GET /api/v1/clientes.php/{id}

Obter um cliente específico por ID.

POST /api/v1/clientes.php

Criar um novo cliente.

                    {

                      "razao_social": "Nome da Empresa",

                      "email_principal": "email@exemplo.com",

                      "telefone_principal": "+244 9XX XXX XXX",

                      "nif": "5000000000",

                      "tipo": "lead"

                    }

Negócios

GET /api/v1/negocios.php

Listar negócios. Filtro opcional: ?status=aberto

POST /api/v1/negocios.php

Criar um novo negócio.

                    {

                      "nome": "Nome do Negócio",

                      "cliente_id": 123,

                      "pipeline_id": 1,

                      "estagio_id": 1,

                      "valor_estimado_aoa": 50000.00

                    }

Contratos

GET /api/v1/contratos.php

Listar contratos da empresa.

POST /api/v1/contratos.php

Criar um novo contrato.

                    {

                      "cliente_id": 123,

                      "titulo": "Serviço de Manutenção",

                      "valor_total_aoa": 120000.00,

                      "data_inicio": "2026-08-01",

                      "data_fim": "2027-07-31"

                    }

Notas de Cobrança

GET /api/v1/notas_cobranca.php

Listar notas de cobrança.

POST /api/v1/notas_cobranca.php

Criar uma nova nota de cobrança.

Tickets

GET /api/v1/tickets.php

Listar tickets de suporte.

GET /api/v1/tickets.php/{id}

Obter ticket com todas as mensagens.

POST /api/v1/tickets.php

Criar um novo ticket.

Health Check

GET /api/v1/index.php/ping

Verificar status da API (não requer autenticação).

curl https://crm360.changeip.ao/api/v1/index.php/ping

Códigos de Erro

Código	Descrição
`200`	Sucesso
`201`	Recurso criado com sucesso
`400`	Requisição inválida (dados faltando ou incorretos)
`401`	Não autenticado (API Key inválida ou ausente)
`403`	Não autorizado (empresa inativa)
`404`	Recurso não encontrado
`405`	Método HTTP não permitido
`500`	Erro interno do servidor

CRM 360 API