searchUsers method
Search All Users Search and list any users by text query
Parameters:
search
- Searches bydisplayName
. Will return empty array if search query is empty or missing.developerType
- Active user by developer type, none for normal users and internal for moderatorsn
- The number of objects to return.offset
- A zero-based offset from the default object sorting from where search results start.cancelToken
- ACancelToken
that can be used to cancel the operationheaders
- Can be used to add additional headers to the requestextras
- Can be used to add flags to the requestvalidateStatus
- AValidateStatus
callback that can be used to determine request success based on the HTTP status of the responseonSendProgress
- AProgressCallback
that can be used to get the send progressonReceiveProgress
- AProgressCallback
that can be used to get the receive progress
Returns a Future containing a Response
with a List<LimitedUser> as data
Throws DioException
if API call or serialization fails
Implementation
Future<Response<List<LimitedUser>>> searchUsers({
String? search,
String? developerType,
int? n = 60,
int? offset,
CancelToken? cancelToken,
Map<String, dynamic>? headers,
Map<String, dynamic>? extra,
ValidateStatus? validateStatus,
ProgressCallback? onSendProgress,
ProgressCallback? onReceiveProgress,
}) async {
final _path = r'/users';
final _options = Options(
method: r'GET',
headers: <String, dynamic>{
...?headers,
},
extra: <String, dynamic>{
'secure': <Map<String, String>>[
{
'type': 'apiKey',
'name': 'authCookie',
'keyName': 'auth',
'where': '',
},
],
...?extra,
},
validateStatus: validateStatus,
);
final _queryParameters = <String, dynamic>{
if (search != null) r'search': search,
if (developerType != null) r'developerType': developerType,
if (n != null) r'n': n,
if (offset != null) r'offset': offset,
};
final _response = await _dio.request<Object>(
_path,
options: _options,
queryParameters: _queryParameters,
cancelToken: cancelToken,
onSendProgress: onSendProgress,
onReceiveProgress: onReceiveProgress,
);
List<LimitedUser>? _responseData;
try {
final rawData = _response.data;
_responseData = rawData == null
? null
: deserialize<List<LimitedUser>, LimitedUser>(
rawData, 'List<LimitedUser>',
growable: true);
} catch (error, stackTrace) {
throw DioException(
requestOptions: _response.requestOptions,
response: _response,
type: DioExceptionType.unknown,
error: error,
stackTrace: stackTrace,
);
}
return Response<List<LimitedUser>>(
data: _responseData,
headers: _response.headers,
isRedirect: _response.isRedirect,
requestOptions: _response.requestOptions,
redirects: _response.redirects,
statusCode: _response.statusCode,
statusMessage: _response.statusMessage,
extra: _response.extra,
);
}