React Blogify is an API project designed to facilitate learning about integrating APIs with frontend applications, particularly in React. The API provides various endpoints for managing blog posts, user authentication, profile management, and interaction with blog content.
\nKey Features:
\nEndpoints:
\n/auth/register: Register a new user./auth/login: Log in an existing user and obtain JWT tokens for authentication./auth/refresh-token: Refresh the access token using the refresh token./blogs: Retrieve all blog posts or create a new blog post./blogs/:id: Retrieve, update, or delete a specific blog post by ID./blogs/:id/comment: Add a comment to a specific blog post./blogs/:id/like: Like a specific blog post./blogs/:id/favorite: Mark a specific blog post as a favorite./profile/:userId: Retrieve the profile information of a specific user./profile/avatar: Upload or retrieve the avatar image for the user's profile./profile: Update the profile information of the authenticated user.Authentication and Authorization:
\nUsage:
\nReact Blogify API serves as an educational resource for developers aiming to enhance their skills in integrating APIs with React applications. With its comprehensive set of endpoints and user-friendly documentation, developers can effectively learn how to build interactive blog websites with React and backend APIs.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"9649334","collectionId":"93f17e5c-7177-436b-894b-878c09f0a747","publishedId":"2sA2rCU2NA","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-02-23T20:00:03.000Z"},"item":[{"name":"User Authentication","item":[{"name":"login","event":[{"listen":"prerequest","script":{"id":"44deaf17-41d1-46dd-ac77-09822285309b","exec":[""],"type":"text/javascript"}}],"id":"d8a39a5d-887a-4b8e-a00f-96ce96c88461","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\" : \"salahuddin@learnwithsumit.com\",\n \"password\" : \"learnwithsumit123\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/auth/login","description":"This API endpoint allows users to authenticate and obtain access tokens for accessing protected resources within the system. Upon successful authentication, the endpoint returns a user object along with an access token and a refresh token.
\nPOST http://localhost:3000/auth/login
curl --location 'http://localhost:3000/auth/login' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"email\" : \"saad.hasan2@gmail.com\",\n \"password\" : \"123as123\"\n}'\n\n{\n \"user\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"email\": \"saad.hasan2@gmail.com\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null,\n \"favourites\": []\n },\n \"token\": {\n \"accessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6ImFjY2VzcyIsImlhdCI6MTcwODUwNTc3NywiZXhwIjoxNzA4NTA5Mzc3fQ.Jbup2LBySUgEoI22ZkvdIY-DOCLPU1l3qgp0AIJpJkQ\",\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6InJlZnJlc2giLCJpYXQiOjE3MDg1MDU3NzcsImV4cCI6MTcwODU5MjE3N30.8pDDHQc3kT0TW_QWDWd0T-hnSM4brSou6qI3RVYNSl4\"\n }\n}\n\nPOST /auth/register\n\nRegisters a new user with the provided email, password, first name, and last name.
\ncurl --location 'http://localhost:3000/auth/register' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n \"email\": \"saad.hasan2@gmail.com\",\n \"password\": \"12300123\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\"\n}'\n\nUpon successful registration, the endpoint returns a JSON object containing the newly registered user's details along with authentication tokens.
\n{\n \"user\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"email\": \"saad.hasan2@gmail.com\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null,\n \"favourites\": []\n },\n \"token\": {\n \"accessToken\": \"<access_token>\",\n \"refreshToken\": \"<refresh_token>\"\n }\n}\n\nThis API endpoint allows users to refresh their access tokens using a valid refresh token. The endpoint receives a refresh token as input and returns a new access token and refresh token pair.
\nPOST http://localhost:3000/auth/refresh-token
curl --location 'http://localhost:3000/auth/refresh-token' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"refreshToken\" : \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIzYzBkMTNjLWRhM2QtNDllZC05N2U1LWI3MzhmZDFjNGEwYyIsImVtYWlsIjoic2FhZC5oYXNhbkBnbWFpbC5jb20iLCJ0eXBlIjoicmVmcmVzaCIsImlhdCI6MTcwODM1NTQ1MCwiZXhwIjoxNzA4NDQxODUwfQ.ENlBE-6fcUw9MYIiltkNrACINmbQTBR1n_3PM_sSejc\"\n}'\n\n{\n \"accessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6ImFjY2VzcyIsImlhdCI6MTcwODUwNjEyMSwiZXhwIjoxNzA4NTA5NzIxfQ.QMtejsIM1kWhD1ExEZv8cAQb_jhakm_2qBCokAM2ETk\",\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6InJlZnJlc2giLCJpYXQiOjE3MDg1MDYxMjEsImV4cCI6MTcwODU5MjUyMX0.NSdZwBJo_q3s44R3VeGPRiLMNyWSPCA9Llr7dDlkwUg\"\n}\n\nThe User Authentication section of the React Blogify API provides endpoints for user registration, login, and token refresh. These endpoints are crucial for securing user access to the API and ensuring that authenticated users can perform authorized actions.
\n","_postman_id":"14ef57cb-4e70-4cc9-9ebe-b5f7f7e10ee1"},{"name":"Blogs","item":[{"name":"Comments","item":[{"name":"Comment","id":"00839735-0a52-4dc2-99b4-7210a0071840","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YWZmMzg5ZjE4MjJhNWU5ZjQzIiwiZW1haWwiOiJzYWxhaHVkZGluQGxlYXJud2l0aHN1bWl0LmNvbSIsInR5cGUiOiJhY2Nlc3MiLCJpYXQiOjE3MDkzMDYwMjksImV4cCI6MTcwOTMwNjA4OX0.I0WW3KBpNz3W1VBtynD-NmfYSi_DKjb0Os0335sbK4E"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"content\" : \"আমি JavaScript এর অনেক টিউটোরিয়াল দেখেছি অন্যান্য ভাইয়াদের channel থেকে। আমার মনে হয়, কিছু কিছু ভাইদের উদ্দেশ্য হয়তো বিগিনারদের ভীতু করা, ভাগিয়ে দেওয়া যে সহজ বিষয় কঠিন করে বুঝানো। আমি আপনার মধ্যে সেটা একদমই দেখি না। সত্যিকার অর্থে- আপনি একজন বিগিনারবান্ধব।। অসংখ্য ধন্যবাদ ভাইয়া আপনাকে।\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/blogs/7c12b4b48531bcc995ae/comment","description":"This API endpoint allows users to add a comment to a specific blog post. Users must provide the blog ID along with the comment content in the request body. Authentication using a bearer token is required to access this endpoint.
\nPOST http://localhost:3000/blogs//comment
curl --location 'http://localhost:3000/blogs/<blog_id>/comment' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <access_token>' \\\n--data '{\n \"content\": \"<comment_body>\"\n}'\n\n{\n \"id\": \"2d716ab74691a2c5c964\",\n \"title\": \"New JavaScript Version is Available\",\n \"content\": \"Hello\",\n \"thumbnail\": null,\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": [\n \"a\"\n ],\n \"likes\": 0,\n \"comments\": [\n {\n \"id\": \"175c33d429e6242203b6\",\n \"content\": \"Aenean eleifend ante maecenas pulvinar montes lorem et pede dis dolor pretium donec dictum. Vici consequat justo enim. Venenatis eget adipiscing luctus lorem.\",\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708589704280-90672434.jpeg\"\n }\n }\n ]\n}\n\nid (string): The unique identifier of the blog post.
\ntitle (string): The title of the blog post.
\ncontent (string): The content of the blog post.
\nthumbnail (string): The filename of the thumbnail image associated with the blog post.
\nauthor (object): Information about the author of the blog post.
\nid (string): The unique identifier of the author.
\nfirstName (string): The first name of the author.
\nlastName (string): The last name of the author.
\navatar (string): The filename of the author's avatar image.
\ntags (array): An array of tags associated with the blog post.
\nlikes (integer): The number of likes on the blog post.
\ncomments (array): An array of comments posted on the blog post. Each comment object contains:
\nid (string): The unique identifier of the comment.
\ncontent (string): The content of the comment.
\nauthor (object): Information about the author of the comment.
\nid (string): The unique identifier of the author.
\nfirstName (string): The first name of the author.
\nlastName (string): The last name of the author.
\navatar (string): The filename of the author's avatar image.
\nThis API endpoint allows users to delete a comment from a specific blog post. Users must provide the blog ID and the comment ID in the URL to specify the blog post and the comment to be deleted. Authentication using a bearer token is required to access this endpoint.
\nDELETE http://localhost:3000/blogs//comment/
curl --location --request DELETE 'http://localhost:3000/blogs/<blog_id>/comment/<comment_id>' \\\n--header 'Authorization: Bearer <access_token>'\n\nUpon successful deletion, the API returns the updated details of the blog post with the comment removed.
\n{\n \"id\": \"2d716ab74691a2c5c964\",\n \"title\": \"New JavaScript Version is Available\",\n \"content\": \"Hello\",\n \"thumbnail\": null,\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": [\n \"a\"\n ],\n \"likes\": 0,\n \"comments\": []\n}\n\nid (string): The unique identifier of the blog post.
\ntitle (string): The title of the blog post.
\ncontent (string): The content of the blog post.
\nthumbnail (string): The filename of the thumbnail image associated with the blog post.
\nauthor (object): Information about the author of the blog post.
\nid (string): The unique identifier of the author.
\nfirstName (string): The first name of the author.
\nlastName (string): The last name of the author.
\navatar (string): The filename of the author's avatar image.
\ntags (array): An array of tags associated with the blog post.
\nlikes (integer): The number of likes on the blog post.
\ncomments (array): An empty array indicating that the comment has been successfully deleted.
\nThere are only two end points are available for comments. Which is creating a comment and deleting a comment. Currently, Editing comment is not available.
\n","_postman_id":"bb35bd32-98c8-434c-8b5d-3cf38ed78fb8"},{"name":"Favourites","item":[{"name":"Favourites","id":"83133da8-1a93-4de5-90e9-74d76f9d4d35","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YWZmMzg5ZjE4MjJhNWU5ZjQzIiwiZW1haWwiOiJzYWxhaHVkZGluQGxlYXJud2l0aHN1bWl0LmNvbSIsInR5cGUiOiJhY2Nlc3MiLCJpYXQiOjE3MDkzMDYwMjksImV4cCI6MTcwOTMwNjA4OX0.I0WW3KBpNz3W1VBtynD-NmfYSi_DKjb0Os0335sbK4E"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/blogs/favourites","urlObject":{"path":["blogs","favourites"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"83133da8-1a93-4de5-90e9-74d76f9d4d35"},{"name":"Toggle Favourite","id":"b9838af9-f50c-44c3-982e-fa85c174dee8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YWZmMzg5ZjE4MjJhNWU5ZjQzIiwiZW1haWwiOiJzYWxhaHVkZGluQGxlYXJud2l0aHN1bWl0LmNvbSIsInR5cGUiOiJhY2Nlc3MiLCJpYXQiOjE3MDkzMDYwMjksImV4cCI6MTcwOTMwNjA4OX0.I0WW3KBpNz3W1VBtynD-NmfYSi_DKjb0Os0335sbK4E"}]},"isInherited":false},"method":"PATCH","header":[],"url":"http://localhost:3000/blogs/7c12b4b48531bcc995ae/favourite","urlObject":{"path":["blogs","7c12b4b48531bcc995ae","favourite"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b9838af9-f50c-44c3-982e-fa85c174dee8"}],"id":"50199063-835a-441a-80a2-9d717cbbdd7d","_postman_id":"50199063-835a-441a-80a2-9d717cbbdd7d","description":""},{"name":"Get Popular","id":"c27ae5db-7141-40c5-8873-2d3783b8eb99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/blogs/popular","description":"This API endpoint allows users to retrieve a list of popular blog posts. The popularity of a blog post is determined based on certain criteria, such as the number of likes or views. This endpoint returns a paginated list of popular blog posts.
\nGET http://localhost:3000/blogs/popular
curl --location 'http://localhost:3000/blogs/popular'\n\nUpon successful retrieval, the API returns a list of popular blog posts along with the total count.
\n{\n \"total\": 5,\n \"blogs\": [\n {\n \"id\": \"2d716ab74691a2c5c964\",\n \"title\": \"New JavaScript Version is Available\",\n \"content\": \"Hello\",\n \"thumbnail\": null,\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": [\n \"a\"\n ],\n \"likes\": 0,\n \"comments\": []\n },\n ... More 4 blogs\n ]\n}\n\nThe limit parameter allows you to specify the maximum number of popular blogs that the API will retrieve. By default, the limit is set to 5.
\n","type":"text/plain"},"key":"limit","value":"5"}],"variable":[]}},"response":[],"_postman_id":"c27ae5db-7141-40c5-8873-2d3783b8eb99"},{"name":"Create New Blog","id":"3c21c239-f743-4066-a8a2-cc003cccc032","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YWZmMzg5ZjE4MjJhNWU5ZjQzIiwiZW1haWwiOiJzYWxhaHVkZGluQGxlYXJud2l0aHN1bWl0LmNvbSIsInR5cGUiOiJhY2Nlc3MiLCJpYXQiOjE3MDkzMDYwMjksImV4cCI6MTcwOTMwNjA4OX0.I0WW3KBpNz3W1VBtynD-NmfYSi_DKjb0Os0335sbK4E"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"title","value":"Node.js back-end debugging process","description":"Title of the Blog
\n","type":"text"},{"key":"content","value":"Node.js Debugging Tools\nNode.js provides a range of debugging tools and techniques to debug back-end applications. Here are some of the popular ones:\n\n1. Console.log()\nConsole.log() is one of the most basic and widely used debugging techniques in Node.js. It is a simple function that logs messages to the console, which can be used to trace the execution flow and identify bugs. For example:\n\n2. Debugger Statement\nDebugger statement is a built-in Node.js debugger that stops the execution of code at a specific point and allows you to inspect variables, call stack, and execute code line by line. For example:3. Node.js Debug Module\nThe Node.js debug module is a powerful tool that provides a range of debugging options, including:\n\nBreakpoints\nConditional breakpoints\nWatch expressions\nStepping over, into, and out of functions\nHere is an example of how to use the debug module:\n\n3. Node.js Debug Module\nThe Node.js debug module is a powerful tool that provides a range of debugging options, including:\n\nBreakpoints\nConditional breakpoints\nWatch expressions\nStepping over, into, and out of functions\nHere is an example of how to use the debug module:\n\n","description":"Actual content of the Post. It may contain plain HTML
\n","type":"text"},{"key":"tags","value":"programming, algorithm, prototype, javascript","description":"Tags are comma separated
\n","type":"text"},{"key":"thumbnail","description":"Thumbnail of the post. Max file size is 5 MB and only accepts Image files
\n","type":"file","src":"/home/saad/Pictures/1_scB2tAgi95VnhXf8BgjzOg.png"}]},"url":"http://localhost:3000/blogs/","description":"This API endpoint allows users to create a new blog post. Users need to provide the title, content, tags, and an optional thumbnail image for the blog post. Authentication using a bearer token is required to access this endpoint.
\nPOST http://localhost:3000/blogs/
curl --location 'http://localhost:3000/blogs/' \\\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6ImFjY2VzcyIsImlhdCI6MTcwODUxNzQyNCwiZXhwIjoxNzA4NTIxMDI0fQ.S_5xMUuiSg__qbup6N9cWpIuQerEvE0B9uVANgmISh0' \\\n--form 'title=\"Title\"' \\\n--form 'content=\"Hello\"' \\\n--form 'tags=\"[\\\"a\\\"]\"' \\\n--form 'thumbnail=@\"/home/saad/Pictures/-2147483648_-220821.jpg\"'\n\n{\n \"status\": \"success\",\n \"message\": \"Blog created successfully\",\n \"blog\": {\n \"id\": \"7a5c4621f80d70b159bc\",\n \"title\": \"Title\",\n \"content\": \"Hello\",\n \"thumbnail\": \"thumbnail-1708518003904-328901220.jpg\",\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": [\n \"a\"\n ],\n \"likes\": 0,\n \"comments\": []\n }\n}\n\nstatus (string): Indicates the status of the request.
\nmessage (string): A message indicating the outcome of the request.
\nblog (object): Information about the created blog post.
\nid (string): The unique identifier of the blog post.
\ntitle (string): The title of the blog post.
\ncontent (string): The content of the blog post.
\nthumbnail (string, nullable): The filename of the uploaded thumbnail image.
\nauthor (object): Information about the author of the blog post.
\nid (string): The unique identifier of the author.
\nfirstName (string): The first name of the author.
\nlastName (string): The last name of the author.
\navatar (string, nullable): URL to the author's avatar image.
\ntags (array): An array of tags associated with the blog post.
\nlikes (integer): The number of likes received by the blog post.
\ncomments (array): An array of comments posted on the blog post.
\nThis API endpoint allows users to retrieve a specific blog post by its unique identifier (ID). Users can use this endpoint to fetch detailed information about a particular blog post.
\nGET http://localhost:3000/blogs/{{blog_id}}
curl --location 'http://localhost:3000/blogs/{{blog_id}}' \\\n--data ''\n\n{\n \"id\": \"2fe4e76d3c093004d58f\",\n \"title\": \" async/await a good idea? 🤔 async/await vs promises\",\n \"content\": \"Understanding Promises 🤝\\nBefore the advent of async/await, Promises were the go-to solution for handling asynchronous operations in JavaScript. A Promise in JavaScript is an object representing the eventual completion or failure of an asynchronous operation. It allows you to attach callbacks instead of using nested callbacks in a complex phenomenon often referred to as \\\"callback hell.\\\"\",\n \"thumbnail\": \"thumbnail-1708704068214-912948094.jpeg\",\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708589704280-90672434.jpeg\"\n },\n \"tags\": [\n \"async\",\n \"js\",\n \"javascript\"\n ],\n \"likes\": [],\n \"comments\": [],\n \"createdAt\": \"2024-02-23T16:01:08.230Z\"\n}\n\nUpdate Thumbnail. Only Images are allowed and Maximum file size is 5 MB.
\n","type":"file","value":null},{"key":"title","value":"","description":"Optional Text Field to update Blog Title
\n","type":"text"},{"key":"content","value":"","description":"Optional Text Field to update Blog Content
\n","type":"text"},{"key":"tags","value":"","description":"Optional Text Field to update Blog Tags. Tags should be comma separated
\n","type":"text"}]},"url":"http://localhost:3000/blogs/2d716ab74691a2c5c964","description":"This API endpoint allows users to update an existing blog post. Users must provide the blog ID in the URL to specify the blog post they want to update. Authentication using a bearer token is required to access this endpoint. Users can update the thumbnail, title, content, and tags of the blog post.
\nPATCH http://localhost:3000/blogs/
curl --location --request PATCH 'http://localhost:3000/blogs/2d716ab74691a2c5c964' \\\n--header 'Authorization: Bearer <access_token>' \\\n--form 'thumbnail=@\"/path/to/file\"' \\\n--form 'title=\"\"' \\\n--form 'content=\"\"' \\\n--form 'tags=\"\"'\n\nUpon successfully updating the blog post, the API returns the updated details of the blog post.
\n{\n \"id\": \"2d716ab74691a2c5c964\",\n \"title\": \"New JavaScript Version is Available\",\n \"content\": \"Hello\",\n \"thumbnail\": \"test\",\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": [\n \"a\"\n ],\n \"likes\": 0,\n \"comments\": []\n}\n\nid (string): The unique identifier of the blog post.
\ntitle (string): The updated title of the blog post.
\ncontent (string): The updated content of the blog post.
\nthumbnail (string): The filename of the updated thumbnail image associated with the blog post.
\nauthor (object): Information about the author of the blog post.
\nid (string): The unique identifier of the author.
\nfirstName (string): The first name of the author.
\nlastName (string): The last name of the author.
\navatar (string): The filename of the author's avatar image.
\ntags (array): An array of updated tags associated with the blog post.
\nlikes (integer): The number of likes on the blog post.
\ncomments (array): An array of comments posted on the blog post.
\nThis API endpoint allows users to delete an existing blog post. Users must provide the blog ID in the URL to specify the blog post they want to delete. Authentication using a bearer token is required to access this endpoint.
\nDELETE http://localhost:3000/blogs/
curl --location --request DELETE 'http://localhost:3000/blogs/2d716ab74691a2c5c964' \\\n--header 'Authorization: Bearer <access_token>'\n\nUpon successfully deleting the blog post, the API returns a success message.
\n{\n \"message\": \"Blog deleted successfully\"\n}\n\nThis API endpoint allows users to retrieve a list of blogs. Users can specify the page number using the page query parameter to paginate through the blog posts. By default, if the page parameter is not provided, the default page is set to 1. Each response will contain 10 blogs by default. Users can also specify the maximum number of blogs to retrieve using the limit query parameter.
GET http://localhost:3000/blogs?page=
curl --location 'http://localhost:3000/blogs?page=1'\n\nUpon successfully retrieving the blog posts, the API returns a list of blogs along with metadata.
\n{\n \"total\": 13,\n \"page\": 1,\n \"limit\": 10,\n \"blogs\": [\n {\n \"id\": \"4787eebfbc2645e977c9\",\n \"title\": \"Title\",\n \"content\": \"Hello...\",\n \"thumbnail\": null,\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": \"javascript, async\",\n \"likes\": [],\n \"comments\": []\n },\n // ... more blogs\n ]\n}\n\nThe limit parameter allows you to specify the maximum number of blogs that the API will retrieve. By default, the limit is set to 10
\n","type":"text/plain"},"key":"limit","value":""},{"description":{"content":"The page parameter allows you to specify the page number of blogs that the API will retrieve. By default, If page parameter is not provided default page is 1
\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"2897a572-6829-4303-89c2-d3942e08b3c9"},{"name":"Like","id":"6cb3ebf8-3712-4c57-a199-00a68a0dc5b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YWZmMzg5ZjE4MjJhNWU5ZjQzIiwiZW1haWwiOiJzYWxhaHVkZGluQGxlYXJud2l0aHN1bWl0LmNvbSIsInR5cGUiOiJhY2Nlc3MiLCJpYXQiOjE3MDkzMDYwMjksImV4cCI6MTcwOTMwNjA4OX0.I0WW3KBpNz3W1VBtynD-NmfYSi_DKjb0Os0335sbK4E"}]},"isInherited":false},"method":"POST","header":[],"url":"http://localhost:3000/blogs/7c12b4b48531bcc995ae/like","description":"This endpoint allows users to like a specific blog post. Upon successful execution, the response will indicate whether the blog post has been liked, and provide an array of likes.
\nThis POST request does not require a request body.
\nisLiked (boolean): Indicates whether the blog post has been liked.likes (array): An array of likes for the specified blog post.Example response:
\n{\n \"isLiked\": true,\n \"likes\": [\n {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\"\n }\n ]\n}\n\nWith the available endpoints under the /blogs route, users have the flexibility to perform CRUD operations on the Blog Collection, as well as interact with individual blog posts by commenting, marking as favorite, and unfavoriting them.
This API endpoint allows users to retrieve their profile information, including details about their account, favorites, authored blogs, and more. Users must provide their user ID in the URL to access their profile information. Authentication using a bearer token is required to access this endpoint.
\nGET http://localhost:3000/profile/
curl --location 'http://localhost:3000/profile/10719efe-0f78-4f86-9377-5d804dedecdf' \\\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6ImFjY2VzcyIsImlhdCI6MTcwODc1MjIwNCwiZXhwIjoxNzA4NzU1ODA0fQ.D7HaXWO12MgGX9kHqxtk5oMPcenGb_sv48YCKZJneWk'\n\nUpon successfully retrieving the user profile information, the API returns details about the user's account, favorites, authored blogs, and more.
\n{\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"email\": \"saad.hasan2@gmail.com\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708589704280-90672434.jpeg\",\n \"favourites\": [\n {\n \"id\": \"2fe4e76d3c093004d58f\",\n \"title\": \" async/await a good idea? 🤔 async/await vs promises\"\n }\n ],\n \"bio\": \"I am Saad Hasan, self-taught Junior Software Developer from Bangladesh. I have been working as a Professional Frontend Developer for the last 1 year, Though I started my Self-Taught Programming Journey In 2014.\",\n \"blogs\": [\n {\n \"id\": \"4787eebfbc2645e977c9\",\n \"title\": \"Title\",\n \"content\": \"Hello\",\n \"thumbnail\": null,\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": null\n },\n \"tags\": \"[\\\"a\\\"]\",\n \"likes\": 0,\n \"comments\": []\n }\n ]\n}\n\nThe updated first name of the user.
\n","type":"text"},{"key":"lastName","value":"Hasan","description":"The updated last name of the user
\n","type":"text"},{"key":"bio","value":"I am Saad Hasan, self-taught Junior Software Developer from Bangladesh. I have been working as a Professional Frontend Developer for the last 1 year, Though I started my Self-Taught Programming Journey In 2014.","description":"The updated biography of the user
\n","type":"text","disabled":true},{"key":"avatar","description":"The updated avatar image of the user.
\n","type":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/home/saad/Pictures/-2147483648_-220821.jpg"],"src":"/home/saad/Pictures/-2147483648_-220821.jpg","disabled":true}]},"url":"http://localhost:3000/profile","description":"This API endpoint allows users to update their profile information, including first name, last name, biography, and avatar image. Users must provide their bearer token for authentication and the updated profile details. Upon successful update, the API returns a message confirming the profile update along with the updated user profile information.
\nPATCH http://localhost:3000/profile
curl --location --request PATCH 'http://localhost:3000/profile' \\\n--header 'Authorization: Bearer <access_token>' \\\n--form 'firstName=\"Saad\"' \\\n--form 'lastName=\"Hasan\"' \\\n--form 'bio=\"I am Saad Hasan, self-taught Junior Software Developer from Bangladesh. I have been working as a Professional Frontend Developer for the last 1 year, Though I started my Self-Taught Programming Journey In 2014.\"' \\\n--form 'avatar=@\"/home/saad/Pictures/-2147483648_-220821.jpg\"'\n\nUpon successfully updating the user profile information, the API returns a success message along with the updated user profile details.
\n{\n \"message\": \"User profile updated successfully\",\n \"user\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"email\": \"saad.hasan2@gmail.com\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708754588198-999077549.jpeg\",\n \"favourites\": [\n {\n \"id\": \"2fe4e76d3c093004d58f\",\n \"title\": \" async/await a good idea? 🤔 async/await vs promises\"\n }\n ],\n \"bio\": \"I am Saad Hasan, self-taught Junior Software Developer from Bangladesh. I have been working as a Professional Frontend Developer for the last 1 year, Though I started my Self-Taught Programming Journey In 2014.\"\n }\n}\n\nThe updated avatar image of the user.
\n","type":"file","src":"/home/saad/Pictures/1685414706221.jpeg"}]},"url":"http://localhost:3000/profile/avatar","description":"This API endpoint allows users to update their avatar image. Users must provide their bearer token for authentication and the path to the new avatar image file. Upon successful upload, the API returns a message confirming the avatar update along with the updated user profile information.
\nPOST http://localhost:3000/profile/avatar
curl --location 'http://localhost:3000/profile/avatar' \\\n--header 'Authorization: Bearer <access_token>' \\\n--form 'avatar=@\"/home/saad/Pictures/22261152.jpeg\"'\n\nUpon successfully uploading the new avatar image, the API returns a success message along with the updated user profile information.
\n{\n \"message\": \"Avatar uploaded successfully\",\n \"user\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"email\": \"saad.hasan2@gmail.com\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708754588198-999077549.jpeg\",\n \"favourites\": [\n {\n \"id\": \"2fe4e76d3c093004d58f\",\n \"title\": \" async/await a good idea? 🤔 async/await vs promises\"\n }\n ],\n \"bio\": \"I am Saad Hasan, self-taught Junior Software Developer from Bangladesh. I have been working as a Professional Frontend Developer for the last 1 year, Though I started my Self-Taught Programming Journey In 2014.\"\n }\n}\n\nThis endpoint allows users to retrieve blog thumbnail image by providing the URL of the image.
\nGET /uploads/blog/thumbnail-1708589704280-90672434.jpeg\n\ncurl --location 'http://localhost:3000/uploads/blog/thumbnail-1708589704280-90672434.jpeg'\n\nThis endpoint retrieves the blog thumbnail image associated with the user's profile. The image is served in JPEG format.
\nThe response is the binary data of the image in JPEG format.
\ncurl --location 'http://localhost:3000/uploads/avatar/avatar-1708589704280-90672434.jpeg' -O\n\nThis endpoint allows users to retrieve their avatar image by providing the URL of the image.
\nGET /uploads/avatar/avatar-1708589704280-90672434.jpeg\n\ncurl --location 'http://localhost:3000/uploads/avatar/avatar-1708589704280-90672434.jpeg'\n\nThis endpoint retrieves the avatar image associated with the user's profile. The image is served in JPEG format.
\nThe response is the binary data of the image in JPEG format.
\ncurl --location 'http://localhost:3000/uploads/avatar/avatar-1708589704280-90672434.jpeg' -O\n\nDevelopers has to show the uploaded images. There is two type of paths of image. In this section you will learn more about how to show images into your website
\n","_postman_id":"b875fc3d-65f9-4f33-bc4e-44e0f6a00e0d"},{"name":"Search","id":"0944f000-81d9-45e5-ab7a-66022a7bff72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YWZmMzg5ZjE4MjJhNWU5ZjQzIiwiZW1haWwiOiJzYWxhaHVkZGluQGxlYXJud2l0aHN1bWl0LmNvbSIsInR5cGUiOiJhY2Nlc3MiLCJpYXQiOjE3MDkzMDYwMjksImV4cCI6MTcwOTMwNjA4OX0.I0WW3KBpNz3W1VBtynD-NmfYSi_DKjb0Os0335sbK4E"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/search?q=await","description":"This API endpoint allows users to search for blog posts based on a query string. Users can provide a search query using the q parameter in the URL. Authentication using a bearer token is required to access this endpoint.
GET http://localhost:3000/search?q={query}
curl --location 'http://localhost:3000/search?q=await' \\\n--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwNzE5ZWZlLTBmNzgtNGY4Ni05Mzc3LTVkODA0ZGVkZWNkZiIsImVtYWlsIjoic2FhZC5oYXNhbjJAZ21haWwuY29tIiwidHlwZSI6ImFjY2VzcyIsImlhdCI6MTcwODcwMTc5MywiZXhwIjoxNzA4NzA1MzkzfQ.J6mH8CDp3ybwoCCk9BuykLUrwHYmorIqnSHaCGZ_Iy4'\n\n{\n \"length\": 2,\n \"query\": \"await\",\n \"data\": [\n {\n \"id\": \"1b18c0a27c245aea0312\",\n \"title\": \" async/await a good idea? 🤔 async/await vs promises\",\n \"content\": \"Undemplex phenomenon often referred to as \\\"callback hell.\\\"\",\n \"thumbnail\": \"thumbnail-1708704041451-647757489.jpeg\",\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708589704280-90672434.jpeg\"\n },\n \"tags\": [\n \"async\",\n \"js\",\n \"javascript\"\n ],\n \"likes\": [],\n \"comments\": [],\n \"createdAt\": \"2024-02-23T16:00:41.463Z\"\n },\n {\n \"id\": \"2fe4e76d3c093004d58f\",\n \"title\": \" async/await a good idea? 🤔 async/await vs promises\",\n \"content\": \"\",\n \"thumbnail\": \"thumbnail-1708704068214-912948094.jpeg\",\n \"author\": {\n \"id\": \"10719efe-0f78-4f86-9377-5d804dedecdf\",\n \"firstName\": \"Saad\",\n \"lastName\": \"Hasan\",\n \"avatar\": \"avatar-1708589704280-90672434.jpeg\"\n },\n \"tags\": [\n \"async\",\n \"js\",\n \"javascript\"\n ],\n \"likes\": [],\n \"comments\": [],\n \"createdAt\": \"2024-02-23T16:01:08.230Z\"\n }\n ]\n}\n\nlength (integer): The number of blog posts matching the search query.
\nquery (string): The search query.
\ndata (array): An array of blog posts matching the search query. Each object in the array contains detailed information about a blog post.
\n