Listar aluno pelo ID

Descrição

Endpoint para buscar um aluno específico pelo seu ID único. Retorna todos os dados completos do aluno, incluindo informações pessoais e do responsável.

📋 Detalhes da Requisição

URL

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

Headers Obrigatórios

Parâmetros de Rota

Campo	Tipo	Obrigatório	Descrição
`id`	int	✅ Sim	ID único do aluno (mínimo: 1)

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Aluno encontrado com sucesso",
  "data": {
    "id": 123,
    "nome": "João",
    "sobrenome": "Silva",
    "email": "joao@email.com",
    "usuario": "joao.silva",
    "ativo": "s",
    "deletado": "n",
    "telefone": "(11) 99999-9999",
    "cpf": "123.456.789-00",
    "data_nascimento": "1990-05-15",
    "endereco": "Rua das Flores, 123",
    "cidade": "São Paulo",
    "estado": "SP",
    "cep": "01234-567",
    "..." : "..."
  }
}

❌ Erro - Aluno Não Encontrado (404 Not Found)

{
  "success": false,
  "message": "Aluno não encontrado",
  "error": "Not Found"
}

❌ Erro - ID Inválido (400 Bad Request)

{
  "success": false,
  "message": "ID inválido",
  "error": "Bad Request"
}

❌ Erro - Token Inválido (401 Unauthorized)

{
  "success": false,
  "message": "Unauthorized - Invalid or missing token",
  "error": "Unauthorized"
}

🔍 Campos Retornados

Dados do Aluno

Campo	Tipo	Descrição
`id`	int	ID único do aluno
`nome`	string	Nome do aluno
`sobrenome`	string	Sobrenome do aluno
`tipo`	string	Tipo de usuário (geralmente "Presencial")
`nascimento`	string	Data de nascimento (YYYY-MM-DD)
`anotacao`	string	Anotações sobre o aluno
`usuario`	string	Nome de usuário para login
`email`	string	Email do aluno
`cpf`	string	CPF do aluno
`telefone`	string	Telefone do aluno
`endereco`	string	Endereço completo
`cidade`	string	Cidade
`estado`	string	Estado (UF)
`pais`	string	País
`dataCriado`	string	Data de criação do registro
`cep`	string	CEP
`sexo`	string	Sexo (M/F)
`rg`	string	RG do aluno

Dados do Responsável

Campo	Tipo	Descrição
`nome_responsavel`	string	Nome do responsável
`sobrenome_responsavel`	string	Sobrenome do responsável
`rg_responsavel`	string	RG do responsável
`cpf_responsavel`	string	CPF do responsável
`sexo_responsavel`	string	Sexo do responsável (M/F)
`nascimento_responsavel`	string	Data de nascimento do responsável
`endereco_responsavel`	string	Endereço do responsável
`cidade_responsavel`	string	Cidade do responsável
`estado_responsavel`	string	Estado do responsável
`pais_responsavel`	string	País do responsável
`cep_responsavel`	string	CEP do responsável
`contato_responsavel`	string	Telefone do responsável
`email_responsavel`	string	Email do responsável

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	Success	Aluno encontrado com sucesso
`400`	Bad Request	ID inválido (menor que 1)
`401`	Unauthorized	Token inválido ou não fornecido
`404`	Not Found	Aluno não encontrado
`500`	Internal Server Error	Erro interno do servidor

🎯 Cenários de Uso

Perfil do Aluno - Exibir dados completos na página de perfil

Edição de Dados - Carregar dados para formulário de edição

Validação de Existência - Verificar se aluno existe antes de operações

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

Parâmetros de Rota#

📤 Respostas da API#

✅ Sucesso (200 OK)#

❌ Erro - Aluno Não Encontrado (404 Not Found)#

❌ Erro - ID Inválido (400 Bad Request)#

❌ Erro - Token Inválido (401 Unauthorized)#

🔍 Campos Retornados#

Dados do Aluno#

Dados do Responsável#

⚠️ Códigos de Status HTTP#

🎯 Cenários de Uso#

Requisição

Exemplos de Requisição

Respostas