README-en.md

Misskey .NET

日本語・English

A new Misskey API library for .NET that is easy and straightforward to use.

Without Authentication

var io = new Misskey("misskey.io");

try
{
    var user = await io.ApiAsync<Dictionary<string, object>>("users/show", new 
    {
        userId = "7rkr2cvs0v",
    });
    Console.WriteLine(user["username"]); // Admin
}
catch (MisskeyApiException e)
{
    // When an error object is returned from the server
    Console.WriteLine("Failed to fetch the user information.");
}
catch (HttpRequestException e)
{
    // When something happens to the server
    Console.WriteLine(e.Message);
}

MiAuth Authorization (for Misskey v12)

var miAuth = new MiAuth("misskey.io", "MissDeck", "https://missdeck.example.com/icon.png", null, Permission.All);
if (!miAuth.TryOpenBrowser())
{
    Console.WriteLine("Open the following URL in your browser to finish the authorization.");
    Console.WriteLine(miAuth.Url);
}
Console.WriteLine("Press ENTER after authorization is finished.");
Console.ReadLine();

try
{
    Misskey io = await miAuth.CheckAsync();
    var i = io.ApiAsync<Dictionary<string, object>("i");
    Console.WriteLine(user["username"]); // Authorized user's name
}
catch (MisskeyApiException e)
{
    Console.WriteLine("Failed to authorize.");
}
catch (HttpRequestException e)
{
    Console.WriteLine(e.Message);
}

Legacy Authorization (for Misskey v10, v11)

Not supported. (Conrtibution welcome!)

Export auth-information

It's not a good idea to require users to authorize every time they use the app. Misskey class supports import/export auth-information.

// will be serialized as simple INI-formatted string
// You should encrypt it before saving because it contains confidential data.
string serialized = misskey.Export();

// Instantiate a Misskey class from serialized string
string m = Misskey.Import(serialized);

Streaming API

Coming soon