reso_webapi_js

The RESO Web API JS provides a basic API client that supports the OData protocol as specified by the RESO standards group.

Installing

$ yarn add reso_webapi_js

Setup

Import a client:

const RESOWebApiClient = require('reso_webapi_js');

Initialize a client:

const client = new RESOWebApiClient('http://services.odata.org/V4/OData/OData.svc', auth = {});

API

To get items list of some entity use get method:

client.get('Products')
  .then(response => console.log(response.data.value))
  .catch(err => console.log(`Error: ${err.message}`))

To find some item by attribute from entity list, use find_by:

client.find_by('Products', { Name: 'Coffee' })
  .then(response => console.log(response.data.value))
  .catch(err => console.log(`Error: ${err.message}`))

OR if you are using async/await:

(async function() {
  try {
    const products_response = await client.get('Products');
    console.log(products_response.data.value);
    const product_response = await client.find_by('Products', { Name: 'Coffee' });
    console.log(product_response.data.value);
  } catch(error) {
    console.log(`Error: ${error.message}`)
  }
})();

To add new item use send method:

client.send('Products', { name: 'Example 1' })
  .then(response => console.log(response))
  .catch(err => console.log(`Error: ${err.message}`))

To change item data use edit method:

client.edit('Products', { id: 5, name: 'NewName' })
  .then(response => console.log(response))
  .catch(err => console.log(`Error: ${err.message}`))

To delete item use remove method:

client.remove('Products', { id: 5 })
  .then(response => console.log(response))
  .catch(err => console.log(`Error: ${err.message}`))

Basic Authentication

To secure an oData Web API calls using basic authentication over HTTPS you need to pass the second parameter in your client instance:

  const client = new RESOWebApiClient(
    'http://services.odata.org/V4/OData/OData.svc',
    {
      username: 'xxxxxxxxxxxxx',
      password: 'xxxxxxxxxxxxx'
    }
  );

Examples

Examples of the SDK usage are provided in the example folder.

To run the example:

$ cd example
$ node basic.js

Contributing

Bug reports and pull requests are welcome on: https://github.com/jetthoughts/reso_webapi_js.

Service for testing requests: https://services.odata.org/V3/(S(fsb41nprwii3l3eo2dhgwecc))/OData/OData.svc/.

Tests

You can check how we test requests in the test/specs folder which contains tests for our library API. In the test/mocks folder we hold fake data for testing our requests.

If you want to add tests for existing API you just need to add test case/file in one of the following folders inside specs.

But if you want to add new API you need to create folder with appropriate name, put your test files and add test endpoint inside test/test.js file to make tests work.

License

MIT