Get all countries including disabled ones (Admin only)
GET/company/country/all
Retorna uma lista paginada de TODOS os países do sistema, incluindo aqueles com enabled: false ou deleted: true. Este endpoint destina-se à gestão administrativa do catálogo de países.
Objetivo
Fornecer aos administradores do sistema visibilidade completa de todos os países para fins de gestão, incluindo a capacidade de visualizar registros desativados ou excluídos logicamente.
Casos de uso
- Interface de gestão de países no painel de administração
- Revisar países desativados antes de reativá-los
- Auditar alterações no catálogo de países ao longo do tempo
- Restaurar países excluídos logicamente
Autenticação
Requer: Função de administrador (admin ou dev)
Middleware: m.isAdmin
Diferenças em relação ao endpoint público
GET /company/country/: Retorna apenas países comenabled: true(público)GET /company/country/all: Retorna TODOS os países, incluindo os desativados (apenas admin)
Exemplo de solicitação:
GET /company/country/all?page=1&limit=50
Authorization: Bearer {admin_jwt_token}
Exemplo de resposta:
{
status: 200,
data: {
docs: [
{code: es},
{code: pt},
{code: xx}
],
totalDocs: 30,
limit: 50,
page: 1,
totalPages: 1,
pagingCounter: 1,
hasPrevPage: false,
hasNextPage: false,
prevPage: null,
nextPage: null
}
}
Request
Responses
- 200
- 401
- 500
Operação bem-sucedida
Response Headers
Não autorizado - Função de administrador necessária
Erro interno do servidor