PushRadar 3.0.0

PushRadar .NET Server Library

PushRadar is a realtime API service for the web. The service uses a simple publish-subscribe model, allowing you to broadcast "messages" on "channels" that are subscribed to by one or more clients. Messages are pushed in realtime to those clients.

This is PushRadar's official .NET server library.

Prerequisites

In order to use this library, please ensure that you have the following:

• .NET Standard 2+
• A PushRadar account - you can sign up at pushradar.com

Installation

The easiest way to get up and running is to install the library from NuGet. Run the following command in the Package Manager console:

$ Install-Package PushRadar

Broadcasting Messages

var radar = new PushRadar.PushRadar("your-secret-key");
radar.BroadcastAsync("channel-1", new Dictionary<string, object>() {
    { "message", "Hello world!" }
});

Receiving Messages

<script src="https://pushradar.com/js/v3/pushradar.min.js"></script>
<script>
    var radar = new PushRadar('your-public-key');
    radar.subscribe.to('channel-1', function (data) {
        console.log(data.message);
    });
</script>

Private Channels

Private channels require authentication and start with the prefix private-. We recommend that you use private channels by default to prevent unauthorised access to channels.

You will need to set up an authentication endpoint that returns a token using the Auth(...) method if the user is allowed to subscribe to the channel. For example:

var radar = new PushRadar.PushRadar("your-secret-key");
var channelName = HttpContext.Current.Request.QueryString["channelName"];
var socketID = HttpContext.Current.Request.QueryString["socketID"];

if (/* is user allowed to access channel? */ true) {
    var kvp = new KeyValuePair<string, object>("token", radar.Auth(channelName, socketID));
    return Json(kvp);
}

Then register your authentication endpoint by calling the auth(...) method client-side:

radar.auth('/auth');

Complete Documentation

Complete documentation for PushRadar's .NET server library can be found at: https://pushradar.com/docs/3.x?lang=dotnet

License

Copyright © 2021, PushRadar. PushRadar's .NET server library is licensed under the MIT license: https://opensource.org/licenses/mit-license.php