{"info":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","description":"

This is a microservice-based system for managing books and their reviews and orders, built using Spring Boot. It demonstrates robust inter-service communication using both Feign Clients (REST) and gRPC.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"28117952","collectionId":"63c895fc-37e7-4575-b13e-05a9743885f1","publishedId":"2sB3BALCFz","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-08-01T09:04:39.000Z"},"item":[{"name":"Book","item":[{"name":"Login","id":"fa67df89-b1b4-4bf4-a85a-daa5176f07bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"admin\",\r\n \"password\": \"admin\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8765/api/authenticate","description":"

\n","urlObject":{"path":["api","authenticate"],"host":["http://localhost:8765"],"query":[],"variable":[]}},"response":[{"id":"fc4adbc7-cec3-4764-b1ff-ca0c5aa08ebc","name":"Login","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"admin\",\r\n \"password\": \"admin\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8765/api/authenticate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTc1MzM1OTQ0OCwiYXV0aCI6IlJPTEVfQURNSU4gUk9MRV9VU0VSIiwiaWF0IjoxNzUzMjczMDQ4fQ.kMtz_OQ6kPOG_BTW7lummSjuukjOMu4NIlDX777-Ob19kJI0yWi7azU2YiZKo1d1pA0hStjc_cUtLT9p8ODErA"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"237"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-XSS-Protection","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self' data:"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"id_token\": \"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImV4cCI6MTc1MzM1OTQ0OCwiYXV0aCI6IlJPTEVfQURNSU4gUk9MRV9VU0VSIiwiaWF0IjoxNzUzMjczMDQ4fQ.kMtz_OQ6kPOG_BTW7lummSjuukjOMu4NIlDX777-Ob19kJI0yWi7azU2YiZKo1d1pA0hStjc_cUtLT9p8ODErA\"\n}"}],"_postman_id":"fa67df89-b1b4-4bf4-a85a-daa5176f07bf"},{"name":"Add Book","id":"9cbde02c-f756-4614-b52b-453313ed4b0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":" {\r\n \"title\": \"Jhipster tutorial Vol 2\",\r\n \"author\": \"Odiase-Omoighe Samuel\",\r\n \"isbn\": \"1234567857\",\r\n \"price\": 20767.94,\r\n \"publishedDate\": \"2025-07-23T03:23:26Z\",\r\n \"availableCopies\": 300\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8765/services/bookservice/api/books","description":"

Add Books to the store

Retrieve all books from the store

Retreive a specifc book

Partially update a specific book in the store

Update an existing book in the store

Delete a specific book in the store

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}},"urlObject":{"path":["services","bookservice","api","books",":id"],"host":["http://localhost:8765"],"query":[],"variable":[{"id":"88e9d0dc-c1a3-4662-90af-afaa276c3fbe","type":"any","value":"1051","key":"id"}]}},"response":[{"id":"0246e385-783d-4120-9983-2e412abe7c9a","name":"Delete Book","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"http://localhost:8765/services/bookservice/api/books/:id","host":["http://localhost:8765"],"path":["services","bookservice","api","books",":id"],"variable":[{"key":"id","value":"1001"}]}},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Expires","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"X-bookServiceApp-params","value":"1001"},{"key":"X-bookServiceApp-alert","value":"A bookServiceBook is deleted with identifier 1001"},{"key":"X-XSS-Protection","value":"0"},{"key":"Pragma","value":"no-cache"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Wed, 23 Jul 2025 14:47:12 GMT"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self' data:"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"7bdb6eb7-a054-41cf-8370-786b10fbe349"}],"id":"ccd04a5f-73e2-4e7c-8033-f7d88645e399","_postman_id":"ccd04a5f-73e2-4e7c-8033-f7d88645e399","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}}},{"name":"Review","item":[{"name":"Get All Reviews","id":"f14c8450-2e90-4087-a030-e74c1291d34d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8765/services/reviewservice/api/reviews","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}},"urlObject":{"path":["services","reviewservice","api","reviews"],"host":["http://localhost:8765"],"query":[],"variable":[]}},"response":[{"id":"0e410288-8e14-46d4-bcd4-ea5845f77174","name":"Get All Reviews","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8765/services/reviewservice/api/reviews"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"transfer-encoding","value":"chunked"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Expires","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"X-XSS-Protection","value":"0"},{"key":"Pragma","value":"no-cache"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Fri, 01 Aug 2025 09:02:36 GMT"},{"key":"X-Total-Count","value":"9"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"application/json"},{"key":"Link","value":"; rel=\"last\",; rel=\"first\""},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self' data:"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1,\n \"bookIsbn\": \"1234567890A1\",\n \"rating\": 5,\n \"comment\": \"Excellent read!\",\n \"reviewDate\": \"2024-11-01T10:00:00Z\"\n },\n {\n \"id\": 2,\n \"bookIsbn\": \"9876543210B2\",\n \"rating\": 4,\n \"comment\": \"Very informative.\",\n \"reviewDate\": \"2024-12-15T15:30:00Z\"\n },\n {\n \"id\": 3,\n \"bookIsbn\": \"1234567890A1\",\n \"rating\": 3,\n \"comment\": \"Good, but a bit long.\",\n \"reviewDate\": \"2025-01-10T08:45:00Z\"\n },\n {\n \"id\": 4,\n \"bookIsbn\": \"1111111111C3\",\n \"rating\": 1,\n \"comment\": \"Did not like it at all.\",\n \"reviewDate\": \"2025-05-20T12:00:00Z\"\n },\n {\n \"id\": 5,\n \"bookIsbn\": \"9876543210B2\",\n \"rating\": 2,\n \"comment\": null,\n \"reviewDate\": \"2025-07-01T09:00:00Z\"\n },\n {\n \"id\": 1301,\n \"bookIsbn\": \"1234567898\",\n \"rating\": 5,\n \"comment\": \"Sadily\",\n \"reviewDate\": \"2025-07-29T04:11:05Z\"\n },\n {\n \"id\": 1351,\n \"bookIsbn\": \"1234567898\",\n \"rating\": 5,\n \"comment\": \"Sadily\",\n \"reviewDate\": \"2025-07-29T04:11:05Z\"\n },\n {\n \"id\": 1451,\n \"bookIsbn\": \"1234567898\",\n \"rating\": 5,\n \"comment\": \"Sadily\",\n \"reviewDate\": \"2025-07-29T04:11:05Z\"\n },\n {\n \"id\": 1501,\n \"bookIsbn\": \"1234567898\",\n \"rating\": 5,\n \"comment\": \"Sadily\",\n \"reviewDate\": \"2025-07-29T04:11:05Z\"\n }\n]"}],"_postman_id":"f14c8450-2e90-4087-a030-e74c1291d34d"},{"name":"Get All Reviews By Id","id":"3f3bc868-1862-4d96-90a9-919ad5058b39","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8765/services/reviewservice/api/reviews/:id","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}},"urlObject":{"path":["services","reviewservice","api","reviews",":id"],"host":["http://localhost:8765"],"query":[],"variable":[{"type":"any","value":"1","key":"id"}]}},"response":[{"id":"b93ac4c7-01b0-421a-85c0-77597d9e0cab","name":"Get All Reviews By Id","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:8765/services/reviewservice/api/reviews/:id","host":["http://localhost:8765"],"path":["services","reviewservice","api","reviews",":id"],"variable":[{"key":"id","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"transfer-encoding","value":"chunked"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Expires","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"X-XSS-Protection","value":"0"},{"key":"Pragma","value":"no-cache"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Fri, 01 Aug 2025 09:02:42 GMT"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"application/json"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self' data:"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 1,\n \"bookIsbn\": \"1234567890A1\",\n \"rating\": 5,\n \"comment\": \"Excellent read!\",\n \"reviewDate\": \"2024-11-01T10:00:00Z\"\n}"}],"_postman_id":"3f3bc868-1862-4d96-90a9-919ad5058b39"},{"name":"Add Review","id":"7f141e02-98d6-4a74-9a6f-469f8fe3aa29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"bookIsbn\": \"1234567898\",\r\n \"rating\": 5,\r\n \"comment\": \"Sadily\",\r\n \"reviewDate\": \"2025-07-29T04:11:05Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8765/services/reviewservice/api/reviews","description":"

Review Service to fetch book details (e.g., by ISBN) from the Book Service to validate the book before adding a review.

To enable inter-service communication between Review Service and Book Service, we use Spring Cloud OpenFeign, a declarative REST client. This allows the Review Service to fetch book details (e.g., by ISBN) from the Book Service to validate the book before adding a review.

\n","_postman_id":"537d3a28-5b74-46a5-9383-b6f87d59ba52","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}}},{"name":"Order","item":[{"name":"Get all Orders","id":"94c210a2-dec6-4ee4-92e2-f01f7d095772","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8765/services/orderservice/api/orders","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}},"urlObject":{"path":["services","orderservice","api","orders"],"host":["http://localhost:8765"],"query":[],"variable":[]}},"response":[],"_postman_id":"94c210a2-dec6-4ee4-92e2-f01f7d095772"},{"name":"Place order","id":"b6a928c4-3665-413b-a0f0-de5b0d33eceb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"userId\": \"3\",\r\n \"bookIsbn\": \"1234567887\",\r\n \"quantity\": 5,\r\n \"totalAmount\": 700.00\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8765/services/orderservice/api/orders","description":"

StartFragmentOrder Service and Book Service, we integrate gRPC — a modern, efficient Remote Procedure Call (RPC) framework. This allows the Order Service to query book availability, pricing, or metadata in real time before confirming or processing an order.EndFragment

Order Service and Book Service, we integrate gRPC — a modern, efficient Remote Procedure Call (RPC) framework. This allows the Order Service to query book availability, pricing, or metadata in real time before confirming or processing an order.

\n","_postman_id":"07c9b69e-b675-45b2-ac99-391772285b8c","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"63c895fc-37e7-4575-b13e-05a9743885f1","id":"63c895fc-37e7-4575-b13e-05a9743885f1","name":"Online Bookstore (Feign & gRPC)","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"ff218542-3cb0-4e93-99bd-a987f679bdd3","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"f39d63a7-1b88-4373-b01b-08fbbe29be95","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"baseURL","value":"http://localhost:8765"}]}