listOAuthApplications method

Future<OAuthApplications?> listOAuthApplications({ int? limit, int? offset, String? orderBy, String? nameQuery, })

Get a list of OAuth applications for an instance

This request returns the list of OAuth applications for an instance. Results can be paginated using the optional limit and offset query parameters. The OAuth applications are ordered by descending creation date. Most recent OAuth applications will be returned first.

Parameters:

• int limit: Applies a limit to the number of results returned. Can be used for paginating the results together with offset.

• int offset: Skip the first offset results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with limit.

• String orderBy: Allows to return OAuth applications in a particular order. At the moment, you can order the returned OAuth applications by their created_at and name. In order to specify the direction, you can use the +/- symbols prepended in the property to order by. For example, if you want OAuth applications to be returned in descending order according to their created_at property, you can use -created_at. If you don't use + or -, then + is implied. We only support one order_by parameter, and if multiple order_by parameters are provided, we will only keep the first one. For example, if you pass order_by=name&order_by=created_at, we will consider only the first order_by parameter, which is name. The created_at parameter will be ignored in this case.

• String nameQuery: Returns OAuth applications with names that match the given query, via case-insensitive partial match.

Implementation

Future<OAuthApplications?> listOAuthApplications({
  int? limit,
  int? offset,
  String? orderBy,
  String? nameQuery,
}) async {
  final response = await listOAuthApplicationsWithHttpInfo(
    limit: limit,
    offset: offset,
    orderBy: orderBy,
    nameQuery: nameQuery,
  );
  if (response.statusCode >= HttpStatus.badRequest) {
    throw ApiException(response.statusCode, await _decodeBodyBytes(response));
  }
  // When a remote server returns no body with a status of 204, we shall not decode it.
  // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
  // FormatException when trying to decode an empty string.
  if (response.body.isNotEmpty &&
      response.statusCode != HttpStatus.noContent) {
    return await apiClient.deserializeAsync(
      await _decodeBodyBytes(response),
      'OAuthApplications',
    ) as OAuthApplications;
  }
  return null;
}