Developers


Whisper.ws is an app, but also a platform. We are currently in beta of our developer API / SDK's which are now available for evaluation. We'd love for you to build on top of whisper.ws for any scenario where one-time URL's would be valuable. We recently published a Node.js SDK and will soon document our REST API's.

Node.js

Our Node.js library can be downloaded / contributed to / forked over at github. Go grab it here.

We've published the whisper.ws Node.js SDK to npm to make it easy to download (available here). Installation is easy, as simple as:

 npm install --save whisper-ws

Usage of the SDK is quite straightforward:

var Whisper = require('whisper-ws')
var whisper = new Whisper({"token": "Ngb1yfg!gbakeIgbE3!ngjqugBhHgfqe"}); // this is a real token you can use for evaluation 
whisper.set('my secret text', (err, result) => {
    if (err) console.log(err);
    console.log(result);
});

Similarly, getting a secret only requires a couple of lines of code:

whisper.set('my secret text', (err, result) => {
    if (err) console.log(err);
    console.log(result);
    whisper.get(result.key, (err, result) => {
        if (err) console.log(err);
        console.log(result);
    });
});

Head on over to https://github.com/lawrips/whisper for the full documentation.

Console app

Included in the whisper-ws npm module is also a console app which allows for easy access to whisper.ws from the command line.

To install the console app, install whisper-ws globally using npm:

 npm install -g whisper-ws 

Once installed, the following options are enabled:

Options: 
-h, --help                 output usage information
-f, --file [file]          the filename to send to whisper.ws
-t, --text [text]          provide a string rather than a file
-u, --url [url]            optional: overrides destination server (developers only)
-e, --encoding [encoding]  optional: specifies encoding (default is utf-8)

Account / token

This whisper-ws SDK comes with a token included. This can be found in the file ./config/whisper.json after installing or from github. This is rate limited by IP address and will allow for basic testing. Scale / production use is coming soon. For more details, contact us at at our contact page.

Get involved

To stay informed, feel free to check back here for our upcoming REST API, install us from NPM or contact us at github (link above). We'd love to hear from you. ..............