Note: formerly known as iod-node. For the older version, see the iod branch.

Node JS client library for Haven OnDemand

Official client library to help with calling Haven OnDemand APIs http://havenondemand.com.

What is Haven OnDemand?

Haven OnDemand is a set of over 70 APIs for handling all sorts of unstructured data. Here are just some of our APIs' capabilities:

Speech to text
OCR
Text extraction
Indexing documents
Smart search
Language identification
Concept extraction
Sentiment analysis
Web crawlers
Machine learning

For a full list of all the APIs and to try them out, check out https://www.havenondemand.com/developer/apis

Installation

To install, run the following command:

npm install havenondemand

If you want to install the latest module directly from Github, use the following command:

npm install git+https://github.com/HP-Haven-OnDemand/havenondemand-node

Include it

var hod = require('havenondemand')
client = new hod.HODClient(apikey, version)

You can find your API key here after signing up.

version is an optional parameter (defaults to 'v1') and can be either 'v1' or 'v2'.

Callbacks

var callback = function(err,resp,body){
  console.log(body)
}

We can define our callbacks as functions and pass them as arguments

var data = {'text' : 'I like cats'}
client.call('analyzesentiment', callback, data)

Or, we can use the .on('data') hook to do the same thing.

client.call('analyzesentiment',data).on('data',callback)

The order of the arguments after the API name doesn't matter when passed, so all of these are the equivalent.

//1
client.call('analyzesentiment', data, callback)
//2
client.call(data, 'analyzesentiment', callback)
//3
client.call(data, callback, 'analyzesentiment')

Async calls

While node will mostly deal with things asynchronously, Haven OnDemand offers server side asynchronous call method which should be used with large files and slow queries. Pass a boolean for the async parameter.

client.call('analyzesentiment', data, callback, true)

Posting files

File posting is handled using the "file" parameter name which is used for all current file postings in Haven OnDemand

var data = {'file' : 'test.txt'}
client.call('analyzesentiment', data, callback)

Contributing

We encourage you to contribute to this repo! Please send pull requests with modified and updated code.

Fork it ( https://github.com/HPE-Haven-OnDemand/havenondemand-node/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

tobiasc / havenondemand-node