MembershipClient
public class MembershipClient
An iOS client wrapper of the Cisco Spark Room Memberships REST API .
Since
1.2.0-
Lists all room memberships where the authenticated user belongs.
Since
1.2.0Declaration
Swift
public func list(max: Int? = nil, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<[Membership]>) -> Void)Parameters
maxThe maximum number of items in the response.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Lists all memberships in the given room by room Id.
Since
1.2.0Declaration
Swift
public func list(roomId: String, max: Int? = nil, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<[Membership]>) -> Void)Parameters
roomIdThe identifier of the room where the membership belongs.
maxThe maximum number of memberships in the response.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Lists any room memberships for the given room (by room id) and person (by person id).
Since
1.2.0Declaration
Swift
public func list(roomId: String, personId: String, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<[Membership]>) -> Void)Parameters
roomIdThe identifier of the room where the memberships belong.
personIdThe identifier of the person who has the memberships.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Lists any room memberships for the given room (by room id) and person (by email address).
Since
1.2.0Declaration
Swift
public func list(roomId: String, personEmail: EmailAddress, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<[Membership]>) -> Void)Parameters
roomIdThe identifier of the room where the memberships belong.
personEmailThe email address of the person who has the memberships.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Adds a person to a room by person id; optionally making the person a moderator.
Since
1.2.0Declaration
Swift
public func create(roomId: String, personId: String, isModerator: Bool = false, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<Membership>) -> Void)Parameters
roomIdThe identifier of the room where the person is to be added.
personIdThe identifier of the person to be added.
isModeratorIf true, make the person a moderator of the room. The default is false.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Adds a person to a room by email address; optionally making the person a moderator.
Since
1.2.0Declaration
Swift
public func create(roomId: String, personEmail: EmailAddress, isModerator: Bool = false, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<Membership>) -> Void)Parameters
roomIdThe identifier of the room where the person is to be added.
personEmailThe email address of the person to be added.
isModeratorIf true, make the person a moderator of the room. The default is false.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Retrieves the details for a membership by membership id.
Since
1.2.0Declaration
Swift
public func get(membershipId: String, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<Membership>) -> Void)Parameters
membershipIdThe identifier of the membership.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Updates the properties of a membership by membership id.
Since
1.2.0Declaration
Swift
public func update(membershipId: String, isModerator: Bool, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<Membership>) -> Void)Parameters
membershipIdThe identifier of the membership.
isModeratorIf true, make the person a moderator of the room in this membership. The default is false.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
-
Deletes a membership by membership id. It removes the person from the room where the membership belongs.
Since
1.2.0Declaration
Swift
public func delete(membershipId: String, queue: DispatchQueue? = nil, completionHandler: @escaping (ServiceResponse<Any>) -> Void)Parameters
membershipIdThe identifier of the membership.
queueIf not nil, the queue on which the completion handler is dispatched. Otherwise, the handler is dispatched on the application’s main thread.
completionHandlerA closure to be executed once the request has finished.
Return Value
Void
View on GitHub
MembershipClient Class Reference