api-js-node

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #go #golang #android #deep-learning #macos #java #windows #security #ios #openai #open-source

(★ 10)

A JS Node client for Usabilla API

api-js-node 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Node client for Usabilla API

[![CircleCI](https://circleci.com/gh/usabilla/api-js-node/tree/master.svg?style=svg)](https://circleci.com/gh/usabilla/api-js-node/tree/master) [![Coverage Status](https://coveralls.io/repos/github/usabilla/api-js-node/badge.svg?branch=master)](https://coveralls.io/github/usabilla/api-js-node?branch=master)

The Usabilla API Client for Node.js provides access to the Usabilla database from Node.js applications.

The client has the following features:
* Getting the buttons / campaigns / widgets / forms as well as the feedback they contain.
* Querying over the feedback with different parameters.

## Authentication

The client uses extensive authentication based on a request signing process. For more information,
please see our [developers guide](http://developers.usabilla.com).

## Getting started

Install node client through npm

```bash
$ npm install usabilla-api --save
```

### Usage

An example that displays the number of buttons:

```js
const Usabilla = require('usabilla-api');
const usabilla = new Usabilla('YOUR-ACCESS-KEY', 'YOUR-SECRET-KEY');

usabilla.websites.buttons.get().then((buttons) => {
  console.log('Number of buttons: ', buttons.length);
}).catch((reason) => {
  console.error(reason);
});
```

See the code in the [example folder](https://github.com/usabilla/api-js-node/tree/master/example) for more advanced ideas on how to use the client.

### Configuration

The client can be configured during instantiation with the following options:

- `protocol` (default: `https`) - The protocol to use when making requests, this will also configure the type of node http client either `http` or `https`
- `host` (default: `data.usabilla.com`) - The host to use when making requests
- `port` (default: `null`) - The port to use when making requests
- `iterator` (default: `true`) - Whether to iterate until all results are retrieved

For example:

```js
const Usabilla = require('usabilla-api');
const options = {
  protocol: 'http',
  host: 'proxy-host',
  port: 'proxy-port'
}
const usabilla = new Usabilla('YOUR-ACCESS-KEY', 'YOUR-SECRET-KEY', options);

// usabilla.websites.buttons.get()
```

### Returned errors

In case of an error, the library throws an error object with the following properties:

- `type` - The type of error, usually `Sender`.
- `code` - A machine readable code of the error as defined in the [guide](http://developers.usabilla.com/#GettingStarted-RequestURLStructure).
- `message` - Human readable format of the error.
- `status` - The HTTP status of the response.

## Support

The Usabilla Node.js Client API is maintained by Usabilla Development Team. Everyone is encouraged to file bug reports, feature requests, and pull requests through GitHub. This input is critical and will be carefully considered, but we can’t promise a specific resolution or time frame for any request. For more information please email our Support Team at support@usabilla.com.

api-js-node

api-js-node 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

api-js-node

api-js-node 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README