Clientes

curl -X POST "https://alpa-sistema-api.onrender.com/api/v1/clients" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João Silva",
    "email": "joao.silva@email.com",
    "phone": "11987654321",
    "document": "12345678900"
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "João Silva",
    "email": "joao.silva@email.com",
    "phone": "11987654321",
    "document": "12345678900",
    "documentType": "CPF",
    "createdAt": "2025-12-30T00:00:00.000Z",
    "updatedAt": "2025-12-30T00:00:00.000Z"
  }
}

{
  "address": {
    "street": "Avenida Paulista",
    "number": "1578",
    "complement": "Andar 5",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "zipCode": "01310200"
  }
}

const response = await fetch('https://alpa-sistema-api.onrender.com/api/v1/clients', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Maria Santos',
    email: 'maria.santos@email.com',
    phone: '21987654321',
    document: '12345678900',
    address: {
      street: 'Rua das Flores',
      number: '123',
      complement: 'Apto 45',
      neighborhood: 'Centro',
      city: 'Rio de Janeiro',
      state: 'RJ',
      zipCode: '20010020'
    }
  })
});

const response = await fetch('https://alpa-sistema-api.onrender.com/api/v1/clients', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Empresa XYZ Ltda',
    email: 'contato@empresaxyz.com.br',
    phone: '1133334444',
    document: '12345678000190', // CNPJ
    address: {
      street: 'Avenida Brigadeiro Faria Lima',
      number: '3477',
      neighborhood: 'Itaim Bibi',
      city: 'São Paulo',
      state: 'SP',
      zipCode: '04538133'
    }
  })
});

const response = await fetch('https://alpa-sistema-api.onrender.com/api/v1/clients', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Pedro Oliveira',
    email: 'pedro.oliveira@email.com'
  })
});

curl -X GET "https://alpa-sistema-api.onrender.com/api/v1/clients?page=1&limit=20" \
  -H "Authorization: Bearer SUA_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "João Silva",
      "email": "joao.silva@email.com",
      "phone": "11987654321",
      "document": "12345678900",
      "documentType": "CPF",
      "createdAt": "2025-12-30T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

curl -X GET "https://alpa-sistema-api.onrender.com/api/v1/clients/{id}" \
  -H "Authorization: Bearer SUA_API_KEY"

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "João Silva",
    "email": "joao.silva@email.com",
    "phone": "11987654321",
    "document": "12345678900",
    "documentType": "CPF",
    "address": {
      "street": "Avenida Paulista",
      "number": "1578",
      "complement": "Andar 5",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "zipCode": "01310200"
    },
    "createdAt": "2025-12-30T00:00:00.000Z",
    "updatedAt": "2025-12-30T00:00:00.000Z"
  }
}

{
  "success": false,
  "error": {
    "code": "DUPLICATE_EMAIL",
    "message": "Email já cadastrado no sistema"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_DOCUMENT",
    "message": "CPF/CNPJ inválido"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Nome e email são obrigatórios"
  }
}