CLIENTE

Limitações e Comportamentos Conhecidos

Validação de Data de Nascimento: Datas inválidas (ex: 1998-04-31) podem causar problemas. No POST, dados inválidos são ignorados silenciosamente. No PUT, um erro explícito é retornado.

Tamanho do Telefone: Telefones com mais de 20 caracteres podem causar erros na API. Recomendamos validar o tamanho antes de enviar.

Tipo do client_id: O campo client_id deve sempre ser enviado como string. Valores numéricos puros podem causar erros em alguns cenários.

Endpoints

Buscar clientes

GET /customer

Descrição: Retorna todos os clientes cadastrados, podendo filtrar por nome, email, telefone, CPF, id externo, entre outros.

GET /public/customer?token=YOUR_USER_TOKEN&name=Maria HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: YOUR_API_KEY
Accept: */*

Respostas:

• 200 OK: Retorna lista de clientes.
• 422 Unprocessable Entity: Parâmetros inválidos.

Criar cliente

POST /customer

Descrição: Cria um novo cliente.

POST /public/customer HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*

{
  "name": "Maria",
  "email": "[email protected]",
  "phone": "11999999999",
  "cpf": "12345678900"
}

Respostas:

• 200 OK: Cliente criado com sucesso.
• 400 Bad Request: Parâmetros inválidos.

Buscar cliente por id

GET /customer/{id}

Descrição: Retorna um cliente pelo id.

GET /public/customer/{id} HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: YOUR_API_KEY
Accept: */*

Respostas:

• 200 OK: Retorna o cliente.
• 404 Not Found: Cliente não encontrado.

Editar cliente

PUT /customer/{id}

Descrição: Edita um cliente existente.

PUT /public/customer/{id} HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*

{
  "name": "Novo Nome",
  "email": "[email protected]"
}

Respostas:

• 201 Success: Cliente editado com sucesso.
• 400 Bad Request: Parâmetros inválidos.