User Management

Get Users

GET /admin/user_management.php

Retrieve a paginated list of users with filtering options.

Query Parameters

integer

required

Administrator ID making the request

integer

default:"1"

Page number

integer

default:"20"

Number of users per page (max 100)

string

Search query (searches name, email, phone)

string

Filter by user type: pasajero, conductor, admin, empresa

boolean

Filter by active status: 1 for active, 0 for inactive

Response

boolean

Request success status

array

Array of user objects

object

Pagination metadata

Show pagination fields

integer

Current page number

integer

Items per page

integer

Total number of users

integer

Total number of pages

Request Example

curl -X GET "https://76.13.114.194/admin/user_management.php?admin_id=1&page=1&per_page=20" \
  -H "Accept: application/json"

curl -X GET "https://76.13.114.194/admin/user_management.php?admin_id=1&tipo_usuario=conductor&page=1" \
  -H "Accept: application/json"

curl -X GET "https://76.13.114.194/admin/user_management.php?admin_id=1&search=carlos&page=1" \
  -H "Accept: application/json"

Future<Map<String, dynamic>> getUsers({
  required int adminId,
  int page = 1,
  int perPage = 20,
  String? search,
  String? tipoUsuario,
  bool? esActivo,
}) async {
  final queryParams = {
    'admin_id': adminId.toString(),
    'page': page.toString(),
    'per_page': perPage.toString(),
    if (search != null && search.isNotEmpty) 'search': search,
    if (tipoUsuario != null) 'tipo_usuario': tipoUsuario,
    if (esActivo != null) 'es_activo': esActivo ? '1' : '0',
  };

  final uri = Uri.parse('https://76.13.114.194/admin/user_management.php')
      .replace(queryParameters: queryParams);

  final response = await http.get(uri, headers: {'Accept': 'application/json'});
  return jsonDecode(response.body);
}

Response Example

Success

{
  "success": true,
  "usuarios": [
    {
      "id": 456,
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "nombre": "Carlos",
      "apellido": "Rodríguez",
      "email": "carlos.rodriguez@example.com",
      "telefono": "+573001234567",
      "tipo_usuario": "pasajero",
      "es_activo": true,
      "es_verificado": true,
      "creado_en": "2024-01-15T10:30:00.000Z",
      "calificacion": 4.8
    },
    {
      "id": 25,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "nombre": "Juan",
      "apellido": "Martínez",
      "email": "juan.martinez@example.com",
      "telefono": "+573109876543",
      "tipo_usuario": "conductor",
      "es_activo": true,
      "es_verificado": true,
      "empresa_id": 5,
      "creado_en": "2024-02-01T14:30:00.000Z",
      "calificacion": 4.9
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 156,
    "total_pages": 8
  }
}

Update User

PUT /admin/user_management.php

Update user information. Requires admin privileges.

Request Body

integer

required

Administrator ID

integer

required

User ID to update

string

Updated first name

string

Updated last name

string

Updated phone number

string

Updated user type

integer

Active status: 1 for active, 0 for inactive

integer

Verified status: 1 for verified, 0 for unverified

integer

Company ID for drivers

Response

boolean

Update success status

string

Success or error message

Request Example

curl -X PUT https://76.13.114.194/admin/user_management.php \
  -H "Content-Type: application/json" \
  -d '{
    "admin_id": 1,
    "user_id": 456,
    "es_activo": 0
  }'

curl -X PUT https://76.13.114.194/admin/user_management.php \
  -H "Content-Type: application/json" \
  -d '{
    "admin_id": 1,
    "user_id": 25,
    "tipo_usuario": "conductor",
    "empresa_id": 5
  }'

Future<bool> updateUser({
  required int adminId,
  required int userId,
  String? nombre,
  String? apellido,
  String? telefono,
  String? tipoUsuario,
  bool? esActivo,
  bool? esVerificado,
  int? empresaId,
}) async {
  final requestData = {
    'admin_id': adminId,
    'user_id': userId,
    if (nombre != null) 'nombre': nombre,
    if (apellido != null) 'apellido': apellido,
    if (telefono != null) 'telefono': telefono,
    if (tipoUsuario != null) 'tipo_usuario': tipoUsuario,
    if (esActivo != null) 'es_activo': esActivo ? 1 : 0,
    if (esVerificado != null) 'es_verificado': esVerificado ? 1 : 0,
    if (empresaId != null && empresaId > 0) 'empresa_id': empresaId,
  };

  final response = await http.put(
    Uri.parse('https://76.13.114.194/admin/user_management.php'),
    headers: {'Content-Type': 'application/json'},
    body: jsonEncode(requestData),
  );

  final data = jsonDecode(response.body);
  return data['success'] == true;
}

Response Example

Success

{
  "success": true,
  "message": "Usuario actualizado exitosamente"
}

Delete User

DELETE /admin/user_management.php

Permanently delete a user account.

Request Body

integer

required

Administrator ID

integer

required

User ID to delete

Response

boolean

Deletion success status

string

Confirmation message

Request Example

cURL

curl -X DELETE https://76.13.114.194/admin/user_management.php \
  -H "Content-Type: application/json" \
  -d '{
    "admin_id": 1,
    "user_id": 456
  }'

User deletion is permanent and cannot be undone. Consider deactivating users instead of deleting them.

Suspend User

POST /admin/suspender_usuario.php

Temporarily suspend a user account.

Request Body

integer

required

User ID to suspend

string

required

Reason for suspension

Request Example

cURL

curl -X POST https://76.13.114.194/admin/suspender_usuario.php \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 456,
    "motivo": "Violación de términos de servicio"
  }'

Activate User

POST /admin/activar_usuario.php

Reactivate a suspended user account.

Request Body

integer

required

User ID to activate

Request Example

cURL

curl -X POST https://76.13.114.194/admin/activar_usuario.php \
  -H "Content-Type: application/json" \
  -d '{"user_id": 456}'

Error Responses

Bad Request

Invalid parameters or missing required fields

Forbidden

Insufficient admin privileges

Not Found

User not found

Internal Server Error

Server error during operation

Overview

User Endpoints

Driver Endpoints

Trip Endpoints

Map Services

Admin Endpoints

User Management

Get Users

Query Parameters

Response

Request Example

Response Example

Update User

Request Body

Response

Request Example

Response Example

Delete User

Request Body

Response

Request Example

Suspend User

Request Body

Request Example

Activate User

Request Body

Request Example

Error Responses

See Also

​Get Users

​Query Parameters

​Response

​Request Example

​Response Example

​Update User

​Request Body

​Response

​Request Example

​Response Example

​Delete User

​Request Body

​Response

​Request Example

​Suspend User

​Request Body

​Request Example

​Activate User

​Request Body

​Request Example

​Error Responses

​See Also

Get Users

Query Parameters

Response

Request Example

Response Example

Update User

Request Body

Response

Request Example

Response Example

Delete User

Request Body

Response

Request Example

Suspend User

Request Body

Request Example

Activate User

Request Body

Request Example

Error Responses

See Also