Simple introduction to creating a REST service and api with node
We will show you how to take an existing application and put it into the express structure
First checkout this repository
git clone https://github.com/mjcleme/node-api-server-tutorial.git
Next, create a new express server with
express poki cd poki npm install cd ..
Now copy the files into the correct places in the template
cp node-api-server-tutorial/src/index.html poki/public cp node-api-server-tutorial/src/style.css poki/public/stylesheets/ cp node-api-server-tutorial/src/app.js poki/public/javascripts/
Now create a route to the index.html by editing routes/index.js to be
router.get('/', function(req, res) { res.sendFile('index.html', { root: 'public' }); });
Make sure the server is running correctly by running
npm start
and accessing the URL 'http://yourserver:3000'
You should see that you havent set up the '/pokemon' route
First add the route and make sure it works when you access 'http://yourserver:3000/pokemon'
router.get('/pokemon', function(req, res) { console.log("In Pokemon"); });
Then add the pokemon array from node-api-server-tutorial/api-server.js
var pokemon = [
{
name: 'Pikachu',
avatarUrl: 'http://rs795.pbsrc.com/albums/yy232/PixKaruumi/Pokemon%20Pixels/Pikachu_Icon__free__by_Aminako.gif~c200'
},
{
name: 'Charmander',
avatarUrl: 'http://24.media.tumblr.com/tumblr_ma0tijLFPg1rfjowdo1_500.gif'
},
{
name: 'Mew',
avatarUrl: 'http://media3.giphy.com/media/J5JrPT8r1xGda/giphy.gif'
},
{
name: 'Cubone',
avatarUrl: 'http://rs1169.pbsrc.com/albums/r511/nthndo/tumblr_ljsx6dPMNm1qii50go1_400.gif~c200'
},
{
name: 'Cleffa',
avatarUrl: 'http://media1.giphy.com/media/pTh2K2xTJ1nag/giphy.gif'
},
{
name: 'Gengar',
avatarUrl: 'https://s-media-cache-ak0.pinimg.com/originals/7e/3b/67/7e3b67c53469cc4302035be70a7f2d60.gif'
}
];
Now, send back the array in your route
res.send(pokemon);
##CORS Issues Some of you may want to access a REST service that doesnt have the CORS headers for your project. Lets go through an example of how to do this
Lets say we want to get information about candidates from 'https://zlzlap7j50.execute-api.us-east-1.amazonaws.com/prod'
If we put the URL into our angular controller at public/javascripts/app.js with something like
function pokemonFetcher ($http) {
var API_ROOT = 'pokemon'
return {
get: function () {
return $http
.get(API_ROOT)
.then(function (resp) {
return resp.data
})
},
tryit: function() {
var politics = "https://zlzlap7j50.execute-api.us-east-1.amazonaws.com/prod";
return $http
.get(politics)
.then(function (resp) {
console.log("Get Worked");
console.log(resp.data);
return resp.data
})
}
}
}
function mainCtrl ($scope, pokemonFetcher) {
$scope.pokemon = []
pokemonFetcher.get()
.then(function (data) {
$scope.pokemon = data
})
pokemonFetcher.tryit()
.then(function (data) {
console.log("tryit");
console.log(data);
})
}
You will get a CORS error on the console of your browser.
So, lets make a proxy for this route in routes/index.js
First add the request module to the top of your routes/index.js file
var request = require('request')
Then install the module
npm install request --save
Then use 'request' to pipe the output from the real URL back through the node server to your browser.
var politics = "https://zlzlap7j50.execute-api.us-east-1.amazonaws.com/prod";
router.get('/politics', function(req,res) {
console.log("In politics");
request(politics).pipe(res);
});
Test the route by accessing the URL 'http://yourserver:3000/politics'
And change our angular call to point to this route in public/javascripts/app.js
var politics = "/politics";
First add a form to the public/index.html file.
<h1> Enter A New Poki</h1>
<form id="newPoki" ng-submit="addPoki()">
Name: <input type="text" ng-model="Name" value=""><br>
Url: <input type="url" ng-model="Url" value=""><br>
<input type="submit" value="Submit">
</form>
And add the function to execute on the submit inside of MainCtrl
$scope.addPoki = function() {
var formData = {name:$scope.Name,avatarUrl:$scope.Url};
console.log(formData);
var pokiURL = 'pokemon';
$http({
url: pokiURL,
method: "POST",
data: formData
}).success(function(data, status, headers, config) {
console.log("Post worked");
}).error(function(data, status, headers, config) {
console.log("Post failed");
});
}
And now we need to build the back end. We have created an object that should be pushed directly into the array on the back end. Once we update the array, it should be permanent even if you refresh the browser. Edit routes/index.js
router.post('/pokemon', function(req, res) {
console.log("In Pokemon Post");
console.log(req.body);
pokemon.push(req.body);
res.end('{"success" : "Updated Successfully", "status" : 200}');
});