Official Sensit API library client for node.js

This library is generated by alpaca

Make sure you have npm installed.

$ npm install sensit-client

Works with [ 0.8 / 0.9 / 0.10 / 0.11 ]

var sensit = require('sensit-client');

// Then we instantiate a client (as shown below)

var client = sensit.client();

// If you need to send options
var client = sensit.client({}, options);

var client = sensit.client('1a2b3', options);

All the callbacks provided to an api call will recieve the response as shown below

client.klass('args').method('args', function (err, response) {
    if (err) console.log(err);

    response.body;
    // >>> 'Hello world!'

    response.code;
    // >>> 200

    response.headers;
    // >>> {'content-type': 'text/html'}
}

response.body;
// >>> 'The username is pksunkara!'

response.body;
// >>> {'user': 'pksunkara'}

body = 'username=pksunkara';

body = {'user': 'pksunkara'};

body = {'user': 'pksunkara'};

The following options are available while instantiating a client:

• base: Base url for the api
• api_version: Default version of the api (to be used in url)
• user_agent: Default user-agent for all requests
• headers: Default headers for all requests
• request_type: Default format of the request body

The following options are available while calling a method of an api:

• api_version: Version of the api (to be used in url)
• headers: Headers for the request
• query: Query parameters for the url
• body: Body of the request
• request_type: Format of the request body

A Percolator is a reverse query much like a match rule which is run whenever a new feed is added. These can be used to create alerts by causing the sensit to publish the feed that was just added. A percolator query is defined by a name and and valid query according to the according the the elasticsearch Query DSL. For more information about Percolator queries please refer to the elasticsearch percolator documentation.

The following arguments are required:

• topic_id: The key for the parent topic
• id: The name of the percolator query

var percolator = client.percolator("my_rule", "my_topic");

Returns a list or percolators for a given topic. Requires authorization of read_any_percolators, or read_application_percolators.

percolator.list(options, callback);

Return a specific percolator of the associated Topic by Id. Requires authorization of read_any_percolators, or read_application_percolators.

percolator.find(options, callback);

Create a percolator on the associated Topic with the specified name and query. Requires authorization of manage_any_percolators, or manage_application_percolators.

The following arguments are required:

• percolator: A Hash containing name: The name of the percolator(required).query: The query hash according to the according the the elasticsearch Query DSL

percolator.create("{name: 'Kimchy-User', query:{term: {user: 'kimchy'}}}", options, callback);

Update the query for a specific percolator. Requires authorization of manage_any_percolators, or manage_application_percolators.

The following arguments are required:

• percolator: A Hash containing the query hash according to the according the the elasticsearch Query DSL

percolator.update("{query:{term: {user: 'kimchy'}}}", options, callback);

Delete a percolator on the associated topic. Requires authorization of manage_any_percolators, or manage_application_percolators.

percolator.delete(options, callback);

Reports are stored filter and facet queries on the Feed data. A report is a assigned a name and the query is any elasticsearch query which filters only the desired data for the facets (See the elasticsearch Query DSL for valid queries). A report can have many facets with each facet is referred to by a user defined name. Valid type's of facet include terms, range, histogram, filter, statistical, query, terms_stats, or geo_distance. The query within a facet defines the field counts or statistics which the data is calculated over. See the elasticsearch facet dsl for information about the various facet types and valid query fields.

The following arguments are required:

• topic_id: The key for the parent topic
• id: The identifier of the report

var report = client.report("my_report", "my_topic");

Get all reports for the associated Topic. Requires authorization of read_any_reports, or read_application_reports.

report.list(options, callback);

Retrieve a specific report on the associated topic by Id. Requires authorization of read_any_reports, or read_application_reports.

report.find(options, callback);

Create a new report on the associated Topic which can be easily retrieved later using an id. Requires authorization of manage_any_reports, or manage_application_reports.

The following arguments are required:

• report: A Hash containing name: The name of the report (required).query:The search query acccording to the elasticsearch Query DSL to filter the data for the facets (Defaults to match all).facets:An array of facet hashes which each contain a name ad type of the facet along with its query hash (required).

report.create("{name:'My report', query:{match_all: { }}, facets:[{name: 'facet1', type: 'terms', query: { field: 'value1'}}]}", options, callback);

Update the query, facets or name of the report. Requires authorization of manage_any_reports, or manage_application_reports.

The following arguments are required:

• report: A Hash containing name: The name of the report (required).query:The search query acccording to the elasticsearch Query DSL to filter the data for the facets (Defaults to match all).facets:An array of facet hashes which each contain a name ad type of the facet along with its query hash (required).

report.update("{name:'My report', query:{match_all: { }}, facets:[{name: 'facet1', type: 'terms', query: { field: 'value1'}}]}", options, callback);

Remove a saved report on the associated Topic by Id. Requires authorization of manage_any_reports, or manage_application_reports.

report.delete(options, callback);

var user = client.user();

user.profile(options, callback);

A topic is root that data is attached to. It is the equivalent of a source in searchlight/solink and acts as a table which has columns(Fields) and rows(Feeds).

var topic = client.topic();

Requires authorization of read_any_data, or read_application_data.

topic.list(options, callback);

Requires authorization of read_any_data, or read_application_data.

topic.find(options, callback);

Requires authorization of manage_any_data, or manage_application_data.

The following arguments are required:

• topic: A hash containing the name/id of the topic (required) and a description of the topic.

topic.create("{name:'my_topic', description:'Event data from source A.'}", options, callback);

Requires authorization of manage_any_data, or manage_application_data.

The following arguments are required:

• topic: A hash containing the name/id of the topic (required) and a description of the topic.

topic.update("{name:'my_topic', description:'Event data from source A.'}", options, callback);

Requires authorization of manage_any_data, or manage_application_data.

topic.delete(options, callback);

Returns api instance to get auxilary information about Buffer useful when creating your app.

The following arguments are required:

• topic_id: The key for the parent topic
• id: The id of the feed

var feed = client.feed("1", "my_topic");

Returns a list of feeds for a given topic. Requires authorization of read_any_data, or read_application_data.

feed.list(options, callback);

Returns a specific feed for a topic. Requires authorization of read_any_data, or read_application_data.

feed.find(options, callback);

Create a feed on a given topic. Requires authorization of read_any_data, or read_application_data.

The following arguments are required:

• feed: A Hash containing at: a formatted time of the event. Defaults to the current time if not present.tz: The time zone of the time given in at. Defaults to UTCdata:A hash of data to be stored

feed.create("{at: '2013-02-14T16:13:33.378Z', tz: 'Eastern Time (US & Canada)', data:{key1:123, key2:456.2, city:'alabama'}}", options, callback);

Update an associated Feed to the Topic. Requires authorization of read_any_data, or read_application_data.

The following arguments are required:

• feed: A hash containing data:A hash of data to be stored

feed.update("{data:{key1:123, key2:456.2, city:'alabama'}}", options, callback);

Deletes the desired feed. Requires authorization of read_any_data, or read_application_data.

feed.delete(options, callback);

Get the value of a specific field within a feed

The following arguments are required:

• topic_id: The key for the parent topic
• feed_id: The id of the parent feed
• id: The key of the specific field

var data = client.data("my_topic", "2", "captured_at");

Requires authorization of read_any_data, or read_application_data.

data.find(options, callback);

Update a specific value of a field within a feed with the data passed in. Requires authorization of read_any_data, or read_application_data.

data.update(options, callback);

Subscriptions allows feed data to imported using a socket rather than just using the Feed REST API. By creating a subscription sensit will start to listen for feed data being imported using the specified host and while using the topic name as the channel name.

The following arguments are required:

• id: The identifier for the subscription

var subscription = client.subscription("subscription1");

Get the list of all subscriptions for importing feed data to the associated topics. Requires authorization of read_any_subscriptions, or read_application_subscriptions.

subscription.list(options, callback);

Get the information of a specific subscription. Requires authorization of read_any_subscriptions, or read_application_subscriptions.

subscription.find(options, callback);

Create a subscription which will connect to the server and listen for feed data for any of the associated topics. Requires authorization of manage_any_subscriptions, or manage_application_subscriptions.

The following arguments are required:

• subscription: A Hash containingname:The channel or name to identify the subscription(required).host:The ip address or host of the connection(required).protocol:the protocol to communicate over (http, tcp, udp, mqtt) (required)port:The port of the connection.

subscription.create("{name:'alpha', host:'10.234.12.11', protocol:'tcp', port:8800}", options, callback);

Returns an object with the current configuration that Buffer is using, including supported services, their icons and the varying limits of character and schedules. Requires authorization of manage_any_subscriptions, or manage_application_subscriptions.

The following arguments are required:

• subscription: A Hash containingname:The channel or name to identify the subscription(required).host:The ip address or host of the connection(required).protocol:the protocol to communicate over (http, tcp, udp, mqtt) (required)port:The port of the connection.

subscription.update("{name:'alpha', host:'10.234.12.11', protocol:'udp', port:8800}", options, callback);

Delete the subscription and stop listening for feed data for the associated topics. Requires authorization of manage_any_subscriptions, or manage_application_subscriptions.

subscription.delete(options, callback);

.

The following arguments are required:

• topic_id: The key for the parent topic
• id: Username of the user

var field = client.field("pksunkara", "my_topic");

Get all the fields associated with a topic. Requires authorization of read_any_data, or read_application_data

field.list(options, callback);

Get a Field of the associated a topic and Id. Requires authorization of read_any_data, or read_application_data

field.find(options, callback);

Adds a new field that feed data can be added too. Requires authorization of manage_any_data, or manage_application_data

The following arguments are required:

• field: A Hash containingname: A descriptive name of the field.key:The name that is used to identify the field in a feed (required).datatype:The type of data that is stored in the field. ie. integer, float, string, bool, datetime

field.create("{name:'Transaction ID', key:'tran_id', datatype:'integer'}", options, callback);

Updates the Field data and makes the corresponding changes in the index. Requires authorization of manage_any_data, or manage_application_data

The following arguments are required:

• field: A Hash containingname: A descriptive name of the field.key:The name that is used to identify the field in a feed (required).datatype:The type of data that is stored in the field. ie. integer, float, string, bool, datetime

field.update("{name:'Transaction ID', key:'tran_id', datatype:'integer'}", options, callback);

Deletes a field and the feed data in that field. Requires authorization of manage_any_data, or manage_application_data

field.delete(options, callback);

Publications are stored actions which are taken when a feed is created, updated, deleted, or there is a matching percolator query.

The following arguments are required:

• topic_id: The key for the parent topic
• id: The identifier of the publication

var publication = client.publication("my_publication", "my_topic");

Get all publications for the associated Topic. Requires authorization of read_any_publications, or read_application_publications.

publication.list(options, callback);

Retrieve a specific publication on the associated topic by Id. Requires authorization of read_any_publications, or read_application_publications.

publication.find(options, callback);

Create a new publication on the associated Topic which can be easily retrieved later using an id. Requires authorization of manage_any_publications, or manage_application_publications.

The following arguments are required:

• publication: A Hash containing host:The ip address or host of the connection(required).protocol:the protocol to communicate over (http, tcp, udp, mqtt) (required)port:The port of the connection.

publication.create("{host:'10.234.12.11', protocol:'http', port:80}", options, callback);

Update a publication. Requires authorization of manage_any_publications, or manage_application_publications.

The following arguments are required:

• publication: A Hash containing host:The ip address or host of the connection(required).protocol:the protocol to communicate over (http, tcp, udp, mqtt) (required)port:The port of the connection.

publication.update("{host:'10.234.12.11', protocol:'http', port:80}", options, callback);

Remove a saved publication on the associated Topic by Id. Requires authorization of manage_any_publications, or manage_application_publications.

publication.delete(options, callback);

Here is a list of Contributors

MIT

Report here.

Christopher Waddington (cwadding@gmail.com)