{"id":198,"date":"2022-01-09T09:50:05","date_gmt":"2022-01-09T09:50:05","guid":{"rendered":"http:\/\/frontendguruji.com\/?p=198"},"modified":"2022-01-09T19:20:29","modified_gmt":"2022-01-09T19:20:29","slug":"how-to-create-api-in-nodejs-without-express-js","status":"publish","type":"post","link":"https:\/\/frontendguruji.com\/blog\/how-to-create-api-in-nodejs-without-express-js\/","title":{"rendered":"How to create API in NodeJS without Express JS"},"content":{"rendered":"\n

Hello Friends 🙏, here I am with another 🔥 topic, how to create API in NodeJS without Express<\/strong> 😮😁.<\/p>\n\n\n\n

Whenever we have to create API in Node, first thing we do is 😎 install Express JS<\/strong>, right!. Because it’s easy to write!, but under the hood it is using Node JS only, its just a wrapper.<\/p>\n\n\n\n

Today in this Node JS Tutorial<\/strong>, we will create API in NodeJS without Express<\/strong>, will create POST & GET API<\/strong> and will learn how to use Postman to test API<\/strong>.👍.<\/p>\n\n\n\n

Chalo suru kiya jaye!<\/strong>🍻 Lets start! <\/strong>🕺.<\/p>\n\n\n\n

Step 1: Install\/Upgrade\/Verify Node & Postman<\/h2>\n\n\n\n

To start with the setup, please verify if your machine has node. If not, then\u00a0install node package here<\/a>.<\/p>\n\n\n\n

While upgrading node package on my machine to the latest version: 16.13.1 which includes npm 8.1.2, I faced one issue, maybe you also get this type of error, check here to resolve it: WARN npm does not support Node.js v16.13.1<\/a><\/p>\n\n\n\n

Another tool you will need is Postman<\/a><\/strong>, this is needed to test API<\/strong>, as we are not developing front-end for now.<\/gwmw><\/p>\n\n\n\n

Step 2: Initialize a folder<\/gwmw><\/h2>\n\n\n\n

So friends! first thing we have to do is to create a blank folder 📁 & initialize it using below command<\/p>\n\n\n\n

npm init<\/code><\/pre>\n\n\n\n
This command will run a wizard of questions\/choices related to the project & we have to answer\/select them. This basically creates a package.json<\/strong> file which will include all our answers\/selections.<\/p>\n\n\n\n
\"node<\/figure>\n\n\n\n
Step 3: Server Setup<\/h2>\n\n\n\n
Create server.js<\/strong> file, this will contain the code related to initialization of the server.<\/p>\n\n\n\n
First import NodeJS http module<\/strong>, this allows NodeJS to transfer data over HTTP<\/strong> (Hyper Text Transfer Protocol).<\/p>\n\n\n\n
\/\/ server.js file<\/strong>\nconst http = require(\"http<\/strong>\");<\/code><\/pre>\n\n\n\n
Now we can create the server using http createServer <\/strong>method. It has two parameters:
request<\/strong>: this contains request Object from client
response<\/strong>: this contains response Object for client<\/p>\n\n\n\n
Here we are just returning a string in response for client, so have used “Content-type”: “text\/plain”<\/strong>.<\/p>\n\n\n\n
const server = http.createServer<\/strong>((request<\/strong>, response<\/strong>) => {\n  response.writeHead(200, { \"Content-Type\": \"text\/plain\" });\n  response.write(\"Hello World!\");\n  response.end();\n});<\/code><\/pre>\n\n\n\n
Now lets bind this server to a port<\/strong>, so that server can receive requests. For this, we need to add a listener<\/strong>:<\/p>\n\n\n\n
server.listen<\/strong>(9000<\/strong>, () => {\n  console.log(\"Server is running on Port 9000\");\n});<\/code><\/pre>\n\n\n\n
That’s all, now to run the server open terminal\/cmd prompt and run below command, this will run the server and start listening on port 9000.<\/p>\n\n\n\n
node server.js<\/code><\/pre>\n\n\n\n
\"node<\/figure>\n\n\n\n
Step 4: Use Postman to test API<\/h2>\n\n\n\n
Open Postman, enter the URL and click on Send button.
This will return the default mesage “Hello World!”<\/strong> from the server. 👏<\/p>\n\n\n\n
\"node<\/figure>\n\n\n\n
In this setup, server will return same message every time we hit URL from the Postman. And nothing will change if you make POST or a GET method.<\/p>\n\n\n\n
Step 5: Server Setup for POST & GET API<\/h2>\n\n\n\n
Now to make this server setup ready for creating POST and GET API, we need to modify our server.js<\/strong> code, and instead of directly returning a response, we will check the method type and based on that, will code the logic (in controller.js<\/strong>).<\/p>\n\n\n\n
Here we are fetching URL <\/strong>and Method type<\/strong> from the request <\/strong>parameter. And the switch statement depends upon the Method Type. We will be coding logic for each method type in next steps.
But first we have to declare default case<\/strong>, so that whenever we hit NodeJS server using Postman <\/strong>and if no case matches, then by default it will return “API not found<\/strong>” message.<\/p>\n\n\n\n
\/\/ Update the Server Code<\/strong>\nconst server = http.createServer((request, response) => {\n  const reqURL <\/strong>= request.url;\n  const reqMethod <\/strong>= request.method;\n  switch (reqMethod<\/strong>) {\n    default<\/strong>: {\n      defaultHandler<\/strong>(resquest, response)\n    }\n  }\n});<\/code><\/pre>\n\n\n\n
\/\/ add <\/strong>defaultHandler method in controller.js<\/strong>\nconst defaultHandler <\/strong>= (request, response) => {\r\n  response.writeHead(200, {\r\n    \"Content-Type\": \"application\/json\",\r\n  });\r\n  response.write(\r\n    JSON.stringify({\r\n      message: `API not found at ${request.url}`<\/strong>,\r\n    })\r\n  );\r\n  response.end();\r\n};<\/code><\/pre>\n\n\n\n
 Now again access the API from postman and check the response. <\/p>\n\n\n\n
\"node<\/figure>\n\n\n\n
Create POST API in NodeJS<\/h3>\n\n\n\n
HTTP POST method<\/strong> is required to send data in the body of the API to the server. 
As we will be sending data from Postman, this API must be able to read the data. 
API name: post-api<\/strong><\/p>\n\n\n\n
\/\/<\/strong> add <\/strong>POST case to the switch statement<\/strong> in server.js<\/strong>\ncase \"POST<\/strong>\": {\n  if (reqURL === \"\/post-api<\/strong>\") {\n   postHandler<\/strong>(request, response);\n  }\n  break;\n}<\/code><\/pre>\n\n\n\n
\/\/ add <\/strong>postHandler method in controller.js<\/strong>\nexport const postHandler<\/strong> = (request, response) => {\n  \/\/read the data from request\n  response.writeHead(200, {\n    \"Content-Type\": \"application\/json\"\n  });\n  response.write(JSON.stringify({\n    message: \"POST Successful\"\n  }));\n  response.end()\n}<\/code><\/pre>\n\n\n\n
Now we have to parse the POST request body. In ExpressJS we use body-parser<\/strong> for the same.
But here we are using custom code, it will act as a body-parser to read the POST data. 
I have created an another tutorial on this custom body parser, check here: How to parse the POST request body in NodeJS without using ExpressJS body-parser<\/a><\/strong><\/p>\n\n\n\n
\/\/ update the postHandler with custom body parser code<\/strong>\nconst postHandler <\/strong>= (request, response) => {\n\n  let chunks = [];\n  request.on(\"data\", (chunk) => {\n    chunks.push(chunk);\n  });\n  request.on(\"end\", () => {<\/strong>\n    const data = Buffer.concat(chunks);\n    const parsedData = qs.parse(data.toString());\n    console.log(parsedData);\n    \/\/ Now request data is accessible using parsedData\n    \/\/ And we can do any operation on the same, like saving it to databse<\/strong><\/span>\n\n    \/\/return the success response\n    response.writeHead(200, {\n      \"Content-Type\": \"application\/json\",\n    });\n    response.write(\n      JSON.stringify({\n        message: \"POST Succesfull\",\n      })\n    );\n    response.end();\n  });<\/strong>\n};<\/code><\/pre>\n\n\n\n
Now we can hit  \/post-api<\/strong> from Postman with some data.<\/p>\n\n\n\n
\"node<\/figure>\n\n\n\n
At server we will receive data as:<\/p>\n\n\n\n
\"node<\/figure>\n\n\n\n
 Create GET API in NodeJS<\/h3>\n\n\n\n
HTTP GET method<\/strong> is required if we just want to request data and there is nothing to send. We can send, but in the form of querystring in the URL not in the body of the API.  
API name: get-api<\/strong><\/p>\n\n\n\n
\/\/<\/strong> add GET case to the switch statement<\/strong> in server.js<\/strong>\ncase \"GET\": {\n  if (reqURL === \"\/get-api<\/strong>\") {\n   getHandler<\/strong>();\n  }\n  break;\n}<\/code><\/pre>\n\n\n\n
Below in the controller, I have created a custom data Object, this will go back in response.<\/p>\n\n\n\n
\/\/ add <\/strong>getHandler method in controller.js<\/strong>\nconst getHandler <\/strong>= (request, response) => {\n  const data = {\n    name: \"frontendguruji\",\n    category: \"technology\",\n    website: \"frontendguruji.com\",\n  }<\/strong>;\n  response.writeHead(200, {\n    \"Content-Type\": \"application\/json\",\n  });\n  response.write(\n    JSON.stringify({\n      message: \"GET Succesfull\",\n      data<\/strong>,\n    })\n  );\n  response.end();\n};<\/code><\/pre>\n\n\n\n
Now we can hit  \/get-api<\/strong> from Postman. Here we will receive the above custom data back in response from server.<\/p>\n\n\n\n
\"node<\/figure>\n\n\n\n
Checkout the project here.<\/a><\/strong><\/p>\n\n\n\n
Thats all in this\u00a0NodeJS tutorial<\/strong>, here we learned how to\u00a0create API in NodeJS without Express JS<\/strong> by setting up the server<\/strong>, implementing POST & GET API <\/strong>and learned how to use Postman to test API<\/strong>. 
If you have any question or suggestion, please feel free to comment.<\/p>\n\n\n\n
Thanks 🙏.<\/p>\n","protected":false},"excerpt":{"rendered":"
In this Node JS tutorial, learn how to create API in NodeJS without Express JS, how to implement POST & GET API and how to use Postman for API testing.<\/p>\n","protected":false},"author":1,"featured_media":413,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":""},"categories":[28],"tags":[29,7,27,76,50],"_links":{"self":[{"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/posts\/198"}],"collection":[{"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/comments?post=198"}],"version-history":[{"count":0,"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/posts\/198\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/media\/413"}],"wp:attachment":[{"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/media?parent=198"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/categories?post=198"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/frontendguruji.com\/blog\/wp-json\/wp\/v2\/tags?post=198"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}