Listar pacotes

Descrição

Endpoint para listar pacotes disponíveis para matrícula.

📋 Detalhes da Requisição

URL

GET https://seudominio.com/api/packages

Headers Obrigatórios

Query Parameters (Opcionais)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
`page`	int	❌ Não	Número da página (padrão: 1) - apenas se não usar student_id	`?page=2`
`limit`	int	❌ Não	Registros por página (padrão: 100, máx: 200) - apenas se não usar student_id	`?limit=50`

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Pacotes listados com sucesso",
  "data": {
    "packages": [
      {
        "id": 789,
        "nome": "Pacote Completo de Programação",
        "valor": 999.90,
        "promocao": 799.90
      },
      {
        "id": 101112,
        "nome": "Pacote de Marketing Digital",
        "valor": 599.90,
        "promocao": null
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 100,
      "total_records": 15,
      "total_pages": 1,
      "has_next_page": false,
      "has_previous_page": false
    }
  },
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 200
}

✅ Sucesso - Lista Vazia (200 OK)

{
  "success": true,
  "message": "Pacotes listados com sucesso",
  "data": {
    "packages": [],
    "pagination": {
      "current_page": 1,
      "per_page": 100,
      "total_records": 0,
      "total_pages": 0,
      "has_next_page": false,
      "has_previous_page": false
    }
  },
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 200
}

❌ Erro - Token Inválido (401 Unauthorized)

{
  "success": false,
  "message": "Unauthorized - Invalid or missing token",
  "errors": [],
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 401
}

❌ Erro - Erro no Servidor (500 Internal Server Error)

{
  "success": false,
  "message": "Erro ao listar pacotes",
  "errors": [],
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 500
}

🔍 Campos Retornados

Dados do Pacote

Campo	Tipo	Descrição	Exemplo
`id`	int	ID do pacote	`789`
`nome`	string	Nome do pacote	`"Pacote Completo"`
`valor`	float	Valor do pacote	`999.90`
`promocao`	float	Valor promocional	`799.90`

Informações de Paginação

Campo	Tipo	Descrição
`current_page`	int	Página atual
`per_page`	int	Registros por página
`total_records`	int	Total de registros encontrados
`total_pages`	int	Total de páginas
`has_next_page`	bool	Indica se há próxima página
`has_previous_page`	bool	Indica se há página anterior

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	OK	Pacotes recuperados com sucesso
`401`	Unauthorized	Token inválido ou não fornecido
`500`	Internal Server Error	Erro interno do servidor

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": {
        "packages": [
            {
                "id": 0,
                "nome": "string",
                "valor": 0,
                "promocao": 0
            }
        ],
        "pagination": {
            "current_page": 0,
            "per_page": 0,
            "total_records": 0,
            "total_pages": 0,
            "has_next_page": true,
            "has_previous_page": true
        }
    },
    "timestamp": "string",
    "status_code": 0
}

Descrição#

📋 Detalhes da Requisição#

URL#

Headers Obrigatórios#

Query Parameters (Opcionais)#

📤 Respostas da API#

✅ Sucesso (200 OK)#

✅ Sucesso - Lista Vazia (200 OK)#

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

❌ Erro - Erro no Servidor (500 Internal Server Error)#

🔍 Campos Retornados#

Dados do Pacote#

Informações de Paginação#

⚠️ Códigos de Status HTTP#

Requisição

Exemplos de Requisição

Respostas