liqen
JS Client for Liqen Core API
Last updated 2 years ago by exacs .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install liqen 
SYNC missed versions from official npm registry.

JS Client for Liqen Core API

This is the official JavaScript API Client for Liqen Core.

Install using yarn or npm.

yarn add liqen
npm install liqen --save

Create a Client instance

The module exposes only one function (and error codes). Call it providing an access token. Leave it blank to connect as annonymous person.

import liqen from 'liqen'

const client = liqen('MY-ACCESS-TOKEN')

You will get a client object with all the methods ready to use.

The package exports the function as a ES6 default export. If you use CommonJS, make sure to require the default:

const liqen = require('liqen').default

const client = liqen('MY-ACCESS-TOKEN')

Using the client

Once you have created the Client instance, use it to make actual calls to the Liqen API. For example to retrieve the annotation 3:

client.annotations.show(3);

It will return a promise that fulfilled with the annotation.

Naming convention

All the methods in the client has the following convention: client.RESOURCE_NAME.METHOD_NAME, where RESOURCE_NAME is the name of a resource, for example, annotations or articles. Every METHOD_NAME is paired with a HTTP request:

  • client.resource.index() is equivalent to GET /resource
  • client.resource.show(id) is equivalent to GET /resource/:id
  • client.resource.create() is equivalent to POST /resource/
  • client.resource.update(id) is equivalent to PUT /resource/:id
  • client.resource.delete(id) is equivalent to DELETE /resource/:id

Optional parameters

The methods index and show accepts one optional parameter (type object) which are converted to HTTP query params. For example:

  • client.annotations.index({article_id: 3}) is equivalent to GET /annotations?article_id=3 for getting all the annotations refering to a single article

The methods create and update accepts one parameter (type object) which will be converted into a JSON object and sent in the request as a body.

For example, you can create an annotation this way:

client.annotations.create({
    article_id: 3,
    target: {
        type: 'FragmentSelector',
        value: 'id1'
    },
    tags: [1]
})

Contribute

  1. git clone or fork the repo
  2. npm install the dependencies
  3. Write code
  4. npm test the code before submitting it

Examples

You can find examples in the examples directory. To run them, use (replace examples/basicExample.js with the appropiate file:

babel-node --presets env examples/basicExample.js

Current Tags

  • 0.5.4                                ...           latest (2 years ago)

22 Versions

  • 0.5.4                                ...           2 years ago
  • 0.5.3                                ...           2 years ago
  • 0.5.2                                ...           2 years ago
  • 0.5.1                                ...           2 years ago
  • 0.5.0                                ...           2 years ago
  • 0.4.1                                ...           2 years ago
  • 0.4.0                                ...           2 years ago
  • 0.3.8                                ...           2 years ago
  • 0.3.7                                ...           2 years ago
  • 0.3.6                                ...           2 years ago
  • 0.3.5                                ...           2 years ago
  • 0.3.4                                ...           3 years ago
  • 0.3.3                                ...           3 years ago
  • 0.3.2                                ...           3 years ago
  • 0.3.1                                ...           3 years ago
  • 0.3.0                                ...           3 years ago
  • 0.2.0                                ...           3 years ago
  • 0.1.1                                ...           3 years ago
  • 0.1.0                                ...           3 years ago
  • 0.0.2                                ...           3 years ago
  • 0.0.1                                ...           3 years ago
  • 0.0.0                                ...           3 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (1)
Dev Dependencies (11)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |