MattermostApi 1.0.35

Install-Package MattermostApi -Version 1.0.35
dotnet add package MattermostApi --version 1.0.35
<PackageReference Include="MattermostApi" Version="1.0.35" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MattermostApi --version 1.0.35
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: MattermostApi, 1.0.35"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install MattermostApi as a Cake Addin
#addin nuget:?package=MattermostApi&version=1.0.35

// Install MattermostApi as a Cake Tool
#tool nuget:?package=MattermostApi&version=1.0.35
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

MattermostApi

This is a C# wrapper to (the most important bits of) the Mattermost API.

It is provided with a Visual Studio 2019 build solution for .NET Standard, so can be used with any version of .NET.

There is a test project (for net core only) which also demonstrates usage.

Setup before using the API

In order to use the Mattermost API you need to register your application with the relevant Mattermost server - see instructions. This returns a Client Id and Client Secret. When registering, you have to provide a redirect uri for the OAuth2 authorisation process. For simple use, provide something like http://localhost:9999 (choose another port number if you like).

This information has to be provided in an object that implements the ISettings interface, which is then used to create a MattermostApi instance. A Settings class which implements this interface is provided, to save you work. This provides a static Load method, reads the settings from LocalApplicationData/MattermostApi/Settings.json. On a Windows 10 machine, LocalApplicationData is C:\Users\<USER>\AppData\Local, on Linux it is ~user/.local/share.

Testing

In order to run the Unit Tests provided, you must provide additional data in your ISettings object - see the Settings object in UnitTest1.cs.

Hooks for more complex uses

You do not have to use the provided Settings class, provided you have a class that implements ISettings.

As part of the OAuth2 process, the default implementation starts a browser to obtain authorisation. This is done by calling OpenBrowser. You can provide an alternative action to open a browser, or otherwise call the Mattermost OAuth page to ask for authorisation.

Once authorisation is complete, the OAuth2 process will redirect the browser to the redirect url you provide in the settings. The default implementation provides an extremely dumb web server to listed on the redirect url port, and collect the code= parameter from the request. You can provide an alternative by providing a WaitForRedirect async function.

These options would be useful if you were using the Api in your own Web Server, for instance.

License

This wrapper is licensed under creative commons share-alike, see license.txt.

Using the Api

The Unit Tests should give you sufficient examples on using the Api.

An Api instance is created by passing it an object that implements ISettings (a default class is provided which will read the settings from a json file). The Api instance is IDisposable, so should be Disposed when no longer needed (this is because it contains an HttpClient).

C# classes are provided for the objects you can send to or receive from the Mattermost api. For instance the Channel object represents channels. These main objects have methods which call the Mattermost api - such as Channel.Create to create a new channel, Channel.GetById to get channel details, etc.

Some Api calls return a list of items (such as Team.GetChannelsForUser). These are returned as an ApiList<Channel>. The Mattermost api itself usually only returns the first few items in the list, and needs to be called again to return the next chunk of items. This is all done for you by ApiList - it has a method called All(Api) which will return an IEnumerable of the appropriate listed object. Enumerating the enumerable will return all the items in the first chunk, then call the Mattermost api to get the next chunk, return them and so on. It hides all that work from the caller, while remaining as efficient as possible by only getting data when needed - for instance, using Linq calls like Any or First will stop getting data when the first item that matches the selection function is found.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.35 276 10/19/2021
1.0.34 83 10/19/2021
1.0.33 202 7/15/2021
1.0.30 239 2/18/2021
1.0.29 305 11/25/2020
1.0.28 149 11/25/2020
1.0.27 506 4/14/2020
1.0.26 238 3/25/2020
1.0.25 242 3/25/2020
1.0.24 248 3/17/2020
1.0.23 279 2/27/2020
1.0.22 322 1/31/2020
1.0.20 373 12/6/2019
1.0.19 281 12/4/2019
1.0.17 259 11/18/2019
1.0.16 309 9/2/2019
1.0.13 261 8/30/2019
1.0.12 238 8/30/2019
1.0.11 288 8/23/2019
1.0.10 308 8/22/2019
1.0.6 288 8/20/2019
1.0.5 289 8/9/2019
1.0.4 289 7/26/2019
1.0.3 300 7/17/2019
1.0.1 308 7/16/2019
1.0.0 304 7/11/2019

Made bool? fields in NotifyProps a string instead of bool?, as they are not recognised by the server if set to false.