rest-api-request

0.6.1 • Public • Published

Rest-api-request

npm package

Tutorials NPM version Dependency Status devDependency Status

Install

npm install rest-api-request --save

Full example

I do not have more time for write documentation today. Look at tests folder for more examples. The project is in active development. Architecture is not yet determined. Do not use it in production projects.

I'll update the documentation and write tests once the architecture will be determined definitively.

'use strict'
 
const async = require('async')
 
// Request options
const options = {
  baseUrl: 'http://localhost:3001'
}
 
const API = require('rest-api-request')(options)
 
// Define model
 
const Model = API.model('platform')
 
// Testing method .getUrl()
 
let indexUrl = Model.find({name: 'testname'}).getUrl()
let showUrl = Model.findOne({name: 'testname'}).getUrl()
let createUrl = Model.create().getUrl()
let updateUrl = Model.findOne({name: 'testname'}).getUrl()
let deleteUrl = Model.findOne({name: 'testname'}).getUrl()
 
console.log('GET %s', indexUrl)
// Response: GET /platform/index?where[0][name]=testname
 
console.log('GET %s', showUrl)
// Response: GET /platform/show?where[0][name]=testname
 
console.log('POST %s', createUrl)
// Response: POST /platform/create
 
console.log('PUT %s', updateUrl)
// Response: PUT /platform/show?where[0][name]=testname
 
console.log('DELETE %s', deleteUrl)
// Response: DELETE /platform/show?where[0][name]=testname
 
// Testing CRUD with real API server
 
async.series({
  create: (callback) => {
    Model.create({name: 'testname'}).exec()
    .then(model => callback(null, model))
    .catch(callback)
  },
  find: (callback) => {
    Model.find({name: 'testname'}).exec()
    .then(models => callback(null, models))
    .catch(callback)
  },
  update: (callback) => {
    Model.update({name: 'testname'}, {name: 'newname'}).exec()
    .then(model => callback(null, model))
    .catch(callback)
  },
  findOne: (callback) => {
    Model.findOne({name: 'newname'}).exec()
    .then(model => callback(null, model))
    .catch(callback)
  },
  delete: (callback) => {
    Model.delete({name: 'newname'}).exec()
    .then(model => callback(null, model))
    .catch(callback)
  }
}, (err, response) => {
  if (err) return console.log('Error: ', err)
  console.log(response)
})
 
/*
  Response:
 
  {
    create: {
      _id: '56b60f6605e4d1667563c50c',
      name: 'testname',
    },
 
    find: [
      {
        _id: '56b60f6605e4d1667563c50c',
        name: 'testname',
      }
    ],
 
    update: {
      _id: '56b60f6605e4d1667563c50c',
      name: 'newname',
    },
 
    findOne: {
      _id: '56b60f6605e4d1667563c50c',
      name: 'newname',
    },
 
    delete: {
      _id: '56b60f6605e4d1667563c50c',
      name: 'newname',
    }
  }
 */

Configure

Options are the same as for the package request because it is used in the method .exec() under the hood.

const options = {
  baseUrl: 'http://localhost:3001'
}
 
const API = require('rest-api-request')(options)
 
const User = API.model('user')

Build url string without request

If you do not want to use the package request for api calls, you can get the URL address as a string, without sending a request to the API server.

let query = User.find({name: 'user1'}).select('name type').limit(2).skip(10)
let url = query.getUrl()

Now variable url contains the string:

/user/index?where[0][name]=user1&select[0]=name&select[1]=type&limit=2&skip=10

Error handlers

let query = User.findOne({name: 'user1'}).select('name type').exec()
 
query.catch(error => console.log(error))
 
/* 
  Response:
  { 
    error: { 
      message: "Error text from api server" 
    } 
  }
*/

Readme

Keywords

Package Sidebar

Install

npm i rest-api-request

Weekly Downloads

1

Version

0.6.1

License

MIT

Last publish

Collaborators

  • kulakowka