Atualizar aluno

Descrição

Endpoint para atualizar dados de um aluno existente.

📋 Detalhes da Requisição

URL

PUT https://seudominio.com/api/students/{id}

Headers Obrigatórios

Parâmetros de Rota

id (int, obrigatório): ID do aluno.

Corpo (JSON) - Exemplos de campos aceitos

Você pode enviar qualquer combinação dos campos abaixo:

{
  "nome": "João",
  "sobrenome": "Silva",
  "email": "joao@silva.com",
  "usuario": "joaosilva",
  "senha": "novaSenha123",
  "telefone": "11999999999",
  "cpf": "123.456.789-00",
  "rg": "12.345.678-9",
  "nascimento": "1990-05-15",
  "sexo": "M",
  "endereco": "Rua das Flores, 123",
  "cidade": "São Paulo",
  "estado": "SP",
  "pais": "Brasil",
  "cep": "01234-567",
  "tipo": "ead",
  "anotacao": "Observação",
  "id_grupo": 1,
  "nome_responsavel": "Maria",
  "sobrenome_responsavel": "Santos",
  "sexo_responsavel": "F",
  "cpf_responsavel": "987.654.321-00",
  "rg_responsavel": "98.765.432-1",
  "email_responsavel": "maria@santos.com",
  "nascimento_responsavel": "1970-03-20",
  "endereco_responsavel": "Rua X",
  "cidade_responsavel": "São Paulo",
  "estado_responsavel": "SP",
  "pais_responsavel": "Brasil",
  "cep_responsavel": "01234-567",
  "contato_responsavel": "11888888888"
}

🔍 Campos da Requisição

Dados Pessoais do Aluno

Campo	Tipo	Obrigatório	Descrição	Exemplo
`nome`	string	✅ Sim	Nome do aluno	"João"
`sobrenome`	string	✅ Sim	Sobrenome do aluno	"Silva"
`email`	string	✅ Sim	Email do aluno (formato válido)	"[email_protected]"
`usuario`	string	✅ Sim	Nome de usuário para login	"joaosilva"
`tipo`	string	✅ Sim	Tipo de aluno (ead/presencial)	"ead"
`nascimento`	string	✅ Sim	Data de nascimento (YYYY-MM-DD)	"1990-05-15"
`sexo`	string	✅ Sim	Sexo (M/F)	"M"
`telefone`	string	❌ Não	Telefone (DDD+Tel)	"11999999999"
`endereco`	string	❌ Não	Endereço	"Rua X, 123"
`cidade`	string	❌ Não	Cidade	"São Paulo"
`estado`	string	❌ Não	Estado (UF)	"SP"
`pais`	string	❌ Não	País	"Brasil"
`cep`	string	❌ Não	CEP	"01234-567"
`cpf`	string	❌ Não	CPF (máx. 15 chars)	"123.456.789-00"
`rg`	string	❌ Não	RG (máx. 15 chars)	"12.345.678-9"
`senha`	string	❌ Não	Nova senha (mínimo 7 caracteres, se enviada)	"novaSenha123"
`anotacao`	string	❌ Não	Observações internas	"Observação"
`id_grupo`	int	❌ Não	ID de grupo do aluno	1

Dados do Responsável

Campo	Tipo	Obrigatório	Descrição	Exemplo
`nome_responsavel`	string	❌ Não	Nome do responsável	"Maria Silva"
`sobrenome_responsavel`	string	❌ Não	Sobrenome do responsável	"Santos"
`sexo_responsavel`	string	❌ Não	Sexo do responsável (M/F)	"F"
`cpf_responsavel`	string	❌ Não	CPF do responsável	"987.654.321-00"
`rg_responsavel`	string	❌ Não	RG do responsável	"987.654.321-00"
`email_responsavel`	string	❌ Não	Email do responsável	"[email_protected]"
`nascimento_responsavel`	string	❌ Não	Data de nascimento do responsável	"1970-03-20"
`endereco_responsavel`	string	❌ Não	Endereço do responsável	"Rua das Flores, 123"
`cidade_responsavel`	string	❌ Não	Cidade do responsável	"São Paulo"
`estado_responsavel`	string	❌ Não	Estado do responsável (UF)	"SP"
`pais_responsavel`	string	❌ Não	País do responsável	"Brasil"
`cep_responsavel`	string	❌ Não	CEP do responsável	"01234-567"
`contato_responsavel`	string	❌ Não	Telefone do responsável (DDD+tel)	"88888888888"

📤 Respostas da API

✅ Sucesso (200 Updated)

{
  "success": true,
  "message": "Aluno atualizado com sucesso",
  "data": {
    /* dados atualizados do aluno */
  },
  "...": "..."
}

❌ Erro - Dados Inválidos (400 Bad Request)

{
  "success": false,
  "message": "O tipo de aluno deve ser ead ou presencial",
  "...": "..."
}

❌ Erro - 404 Not Found

{
  "success": false,
  "message": "Aluno não encontrado",
  "...": "..."
}

❌ Erro - Usuário duplicado (409 Conflict)

{
  "success": false,
  "message": "Nome de usuário já cadastrado",
  "...": "..."
}

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	Updated	Aluno atualizado com sucesso
`400`	Bad Request	Dados inválidos ou campos obrigatórios faltando
`401`	Unauthorized	Token inválido ou não fornecido
`409`	Conflict	Email ou usuário já cadastrado
`500`	Internal Server Error	Erro interno do servidor

🔍 Principais regras de Validação

email, email_responsavel: formato válido

senha: mínimo 7 caracteres (apenas se enviada)

rg, rg_responsavel: máximo 15 caracteres

cpf, cpf_responsavel: máximo 15 caracteres

nascimento: deve ser válido (YYYY-MM-DD)

tipo: deve ser "ead" ou "presencial"

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

application/json

Body

Exemplo

{
    "success": true,
    "message": "string",
    "data": {
        "id": 0,
        "nome": "string",
        "sobrenome": "string",
        "tipo": "string",
        "nascimento": "string",
        "anotacao": "string",
        "usuario": "string",
        "email": "string",
        "cpf": "string",
        "telefone": "string",
        "endereco": "string",
        "cidade": "string",
        "estado": "string",
        "pais": "string",
        "dataCriado": "string",
        "cep": "string",
        "sexo": "string",
        "rg": "string",
        "nome_responsavel": "string",
        "sobrenome_responsavel": "string",
        "rg_responsavel": "string",
        "grupo": 0,
        "cpf_responsavel": "string",
        "sexo_responsavel": "string",
        "nascimento_responsavel": "string",
        "endereco_responsavel": "string",
        "cidade_responsavel": "string",
        "estado_responsavel": "string",
        "pais_responsavel": "string",
        "cep_responsavel": "string",
        "contato_responsavel": "string",
        "email_responsavel": "string"
    },
    "timestamp": "string",
    "status_code": 0
}

Descrição#

📋 Detalhes da Requisição#

URL#

Headers Obrigatórios#

Parâmetros de Rota#

Corpo (JSON) - Exemplos de campos aceitos#

🔍 Campos da Requisição#

Dados Pessoais do Aluno#

Dados do Responsável#

📤 Respostas da API#

✅ Sucesso (200 Updated)#

❌ Erro - Dados Inválidos (400 Bad Request)#

❌ Erro - 404 Not Found#

❌ Erro - Usuário duplicado (409 Conflict)#

⚠️ Códigos de Status HTTP#

🔍 Principais regras de Validação#

Requisição

Exemplos de Requisição

Respostas