$getObjectsSharedInRoom_Request method
- @experimental
Get objects that are shared in the room.
Returns a DynamiteRequest
backing the getObjectsSharedInRoom operation.
Throws a DynamiteApiException
if the API call does not return an expected status code.
Parameters:
apiVersion
Defaults to"v1"
.token
objectType
Type of the objects.lastKnownMessageId
ID of the last known message. Defaults to0
.limit
Maximum number of objects. Defaults to100
.oCSAPIRequest
Required to be true for the API request to pass. Defaults totrue
.
Status codes:
- 200: List of shared objects messages returned
See:
- getObjectsSharedInRoom for a method executing this request and parsing the response.
- $getObjectsSharedInRoom_Serializer for a converter to parse the
Response
from an executed this request.
Implementation
@_i2.experimental
_i3.Request $getObjectsSharedInRoom_Request({
required String token,
required String objectType,
ChatGetObjectsSharedInRoomApiVersion? apiVersion,
int? lastKnownMessageId,
int? limit,
bool? oCSAPIRequest,
}) {
final _parameters = <String, Object?>{};
final __token = _$jsonSerializers.serialize(token, specifiedType: const FullType(String));
_i4.checkString(
__token,
'token',
pattern: RegExp(r'^[a-z0-9]{4,30}$'),
);
_parameters['token'] = __token;
final __objectType = _$jsonSerializers.serialize(objectType, specifiedType: const FullType(String));
_parameters['objectType'] = __objectType;
var __apiVersion =
_$jsonSerializers.serialize(apiVersion, specifiedType: const FullType(ChatGetObjectsSharedInRoomApiVersion));
__apiVersion ??= 'v1';
_parameters['apiVersion'] = __apiVersion;
var __lastKnownMessageId = _$jsonSerializers.serialize(lastKnownMessageId, specifiedType: const FullType(int));
__lastKnownMessageId ??= 0;
_i4.checkNumber(
__lastKnownMessageId,
'lastKnownMessageId',
minimum: 0,
);
_parameters['lastKnownMessageId'] = __lastKnownMessageId;
var __limit = _$jsonSerializers.serialize(limit, specifiedType: const FullType(int));
__limit ??= 100;
_i4.checkNumber(
__limit,
'limit',
maximum: 200,
minimum: 1,
);
_parameters['limit'] = __limit;
final _path = _i5.UriTemplate(
'/ocs/v2.php/apps/spreed/api/{apiVersion}/chat/{token}/share{?objectType*,lastKnownMessageId*,limit*}',
).expand(_parameters);
final _uri = Uri.parse('${_rootClient.baseURL}$_path');
final _request = _i3.Request('get', _uri);
_request.headers['Accept'] = 'application/json';
// coverage:ignore-start
final authentication = _i6.IterableExtension(_rootClient.authentications)?.firstWhereOrNull(
(auth) => switch (auth) {
_i1.DynamiteHttpBearerAuthentication() || _i1.DynamiteHttpBasicAuthentication() => true,
_ => false,
},
);
if (authentication != null) {
_request.headers.addAll(
authentication.headers,
);
}
// coverage:ignore-end
var __oCSAPIRequest = _$jsonSerializers.serialize(oCSAPIRequest, specifiedType: const FullType(bool));
__oCSAPIRequest ??= true;
_request.headers['OCS-APIRequest'] = const _i4.HeaderEncoder().convert(__oCSAPIRequest);
return _request;
}