Cadastrar aluno

Descrição

Endpoint para criar um novo aluno no sistema.

📋 Detalhes da Requisição

URL

POST https://seudominio.com/api/students

Headers Obrigatórios

Corpo da Requisição (JSON)

{
  "nome": "João",
  "sobrenome": "Silva",
  "email": "joao@email.com",
  "usuario": "joaosilva",
  "senha": "minhasenha123",
  "nascimento": "1990-05-15",
  "sexo": "M",
  "cpf": "123.456.789-00",
  "rg": "123.456.789-00",
  "telefone": "99999999999",
  "endereco": "Rua das Flores, 123",
  "cidade": "São Paulo",
  "estado": "SP",
  "pais": "Brasil",
  "cep": "01234-567",
  "tipo": "presencial",
  "nome_responsavel": "Maria Silva",
  "sobrenome_responsavel": "Santos",
  "sexo_responsavel": "F",
  "cpf_responsavel": "987.654.321-00",
  "rg_responsavel": "987.654.321-00",
  "email_responsavel": "maria@email.com",
  "nascimento_responsavel": "1970-03-20",
  "endereco_responsavel": "Rua das Flores, 123",
  "cidade_responsavel": "São Paulo",
  "estado_responsavel": "SP",
  "pais_responsavel": "Brasil",
  "cep_responsavel": "01234-567",
  "contato_responsavel": "99999999999"
}

📤 Respostas da API

✅ Sucesso (201 Created)

{
  "success": true,
  "message": "Aluno criado com sucesso",
  "data": {
    "id": 123,
    "nome": "João",
    "sobrenome": "Silva",
    "tipo": "presencial",
    "nascimento": "1990-05-15",
    "...": "..."
  }
}

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

{
  "success": false,
  "message": "Data de nascimento não informada",
  "error": "Bad Request"
}

❌ Erro - Email Duplicado (409 Conflict)

{
  "success": false,
  "message": "Email do aluno já está sendo utilizado por outro usuário",
  "error": "Conflict"
}

🔍 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	"[email_protected]"
`usuario`	string	✅ Sim	Nome de usuário para login	"joaosilva"
`senha`	string	✅ Sim	Senha (mínimo 7 caracteres)	"minhasenha123"
`nascimento`	string	✅ Sim	Data de nascimento (YYYY-MM-DD)	"1990-05-15"
`sexo`	string	✅ Sim	Sexo (M/F)	"M"
`tipo`	string	✅ Sim	Tipo de aluno (ead/presencial)	"ead"
`telefone`	string	❌ Não	Telefone (DDD+Tel)	"99999999999"
`endereco`	string	❌ Não	Endereço	"Rua das Flores, 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áximo 15 caracteres)	"123.456.789-00"
`rg`	string	❌ Não	RG (máximo 15 caracteres)	"123.456.789-00"

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"

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`201`	Created	Aluno criado 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

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": null,
        "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": null,
        "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#

Corpo da Requisição (JSON)#

📤 Respostas da API#

✅ Sucesso (201 Created)#

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

❌ Erro - Email Duplicado (409 Conflict)#

🔍 Campos da Requisição#

Dados Pessoais do Aluno#

Dados do Responsável#

⚠️ Códigos de Status HTTP#

🔍 Principais regras de Validação#

Requisição

Exemplos de Requisição

Respostas