REST Web Services

About This Space

A demo of how to build and consume Web Services with and without parameters


Last updated on June 6, 2019

Public Permissions:   View   Open/Fork   Run   Comment  

REST Web Services Template

This template provides an example of how to create REST Web Services in NodeRun. Two Web Services are bundled with this template:

  • list.js retrieves a customer list from a database table
  • getCustomer.js retrieves information about a specific customer

Web Services URI

The URI format for the Web Services is:

https://noderun.com/run/[your profile]/[your space name]/[route]/[params]

Before you can run the Web Service, you must create a NodeRun profile and publish a space. The route and params are defined by right-clicking the Node.js file in the Files tree and selecting Properties.

Screenshot

In the Properties window, you can mark a file as a Web Service, and specify the HTTP Method and Route Path.

Screenshot

Testing

This template provides a Node.js module and interface to test the Web Services. Simply select the Launch App option to run the test.

Screenshot

Screenshot

The test uses server-side requests to communicate with the services; however, client-side AJAX requests would work just as well. You can try testing the Web Services using client-side requests by navigating to the appropriate URL in your browser or by using a tool like Postman.

Request and Response Objects

The web server used for NodeRun is Profound.js, which is a superset of Express. Express provides various capabilities for receiving input and sending output using special Request and Response objects. You can refer to the Express API reference for the various properties and methods provided by these objects.

exports.run

NodeRun expects that your Node.js file exports a property named 'run', which must point to the main function to execute when the module is called.

API

Be the first to comment:      

Comments

Write Preview Markdown: bold italic code link
Post

Filters:

Popular Recent

Quick To Do List App

16852

0

2

Advanced To Do List CRUD application with editable grid and drag-and-drop

17725

0

0

Profound Logic Value Recognition Form

7197

0

2

Voting application

16657

0

0

This app allows a team to decide where to go for lunch (or dinner) by using acceptance voting.

14479

1

5