{"info":{"_postman_id":"b541d238-2d46-4ee6-86a4-48f3f589f278","name":"Travel Lot","description":"

Base URL : https://assignment13travellot.aasimd.repl.co/

Welcome to our trip advisor API documentation! This API aims to mimic functionality that would be similar to the one used by the Trip Advisor app. This guide provides APIs for interacting and managing database for travel destinations. The API is built on MongoB and Express.

Destination model

The Destination Schema is a data structure used in the context of an API for managing travel destinations. It is designed to represent information about various travel destinations, including their names, locations, descriptions, ratings, and user reviews.

Attributes:

name (String, required): The name of the travel destination. This field is mandatory and must be provided for each destination.
\n
location (String): The location of the travel destination. This field is optional and can contain information about the city, country, or any relevant geographical details.
\n
description (String): A textual description of the travel destination. This field is optional and provides additional information about the destination.
\n
rating (Number): The overall rating of the travel destination. This field is optional and represents a numerical value to indicate the overall quality or popularity of the destination.
\n
reviews (Array of Objects): An array that holds user reviews for the travel destination. Each review is represented as an object containing the following properties:
\n
- user (ObjectID, ref \"User\"): A reference to the user who created the review. It is linked to a User object in the database using its ObjectID.
  \n
- text (String): The textual content of the review provided by the user.
  \n
- rating (Number): The rating assigned by the user for the destination. This field is optional and represents the user's assessment of the destination's quality.
  \n
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"24459577","collectionId":"b541d238-2d46-4ee6-86a4-48f3f589f278","publishedId":"2s9YCBupvx","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-09-22T14:31:38.000Z"},"item":[{"name":"All Destinations","id":"21f87425-d1f0-4aa8-9fcc-31e5b2f87ea7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations","description":"

Title: Read all destinations

Endpoint: /api/destinations

Description: This API endpoint allows users to retrieve information about all the travel destinations stored in the database.

Parameters: None

Returns:

Upon successful execution, this API responds with an Array of JSON objects containing all the Destinations data in the database.

\n","urlObject":{"protocol":"https","path":["destinations"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"51256faf-963e-4d52-ba45-f9989d9b947a","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"2670"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 14:25:04 GMT"},{"key":"Etag","value":"W/\"a6e-WHnbPjFD1vwAdXLYXsze134bHQ0\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7411284; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Retrieved All Destinations.\",\n \"data\": [\n {\n \"location\": {\n \"city\": \"Paris\",\n \"country\": \"France\"\n },\n \"_id\": \"650c9ea03f5c483328b3980b\",\n \"name\": \"Paris\",\n \"description\": \"The City of Light is known for its romantic ambiance, world-class cuisine, and iconic landmarks like the Eiffel Tower.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52e\",\n \"text\": \"Paris is absolutely enchanting. The food, the culture, and the architecture are all incredible!\",\n \"rating\": 4.8,\n \"_id\": \"650d8d8e015565bf825487f4\"\n },\n {\n \"user\": \"650b43935246a3fac187f52c\",\n \"text\": \"I fell in love with Paris. It's a dream destination for anyone.\",\n \"rating\": 4.6,\n \"_id\": \"650d8d8e015565bf825487f5\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:56.500Z\",\n \"updatedAt\": \"2023-09-22T12:50:22.397Z\",\n \"__v\": 0,\n \"rating\": 4.2\n },\n {\n \"location\": {\n \"city\": \"Kyoto\",\n \"country\": \"Japan\"\n },\n \"_id\": \"650c9ea13f5c483328b39811\",\n \"name\": \"Kyoto\",\n \"description\": \"Kyoto is a city where tradition meets modernity. Explore ancient temples and enjoy delicious Japanese cuisine.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52a\",\n \"text\": \"Kyoto's temples are so serene and beautiful. A must-visit for anyone interested in Japanese culture.\",\n \"rating\": 4.5,\n \"_id\": \"650d8de36ebd466e4367af2c\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.103Z\",\n \"updatedAt\": \"2023-09-22T12:51:47.316Z\",\n \"__v\": 0,\n \"rating\": 4.5\n },\n {\n \"location\": {\n \"city\": \"New York\",\n \"country\": \"USA\"\n },\n \"_id\": \"650c9ea13f5c483328b39814\",\n \"name\": \"New York City\",\n \"description\": \"The Big Apple is a bustling metropolis with iconic skyscrapers, Broadway shows, and diverse neighborhoods.\",\n \"reviews\": [],\n \"createdAt\": \"2023-09-21T19:50:57.117Z\",\n \"updatedAt\": \"2023-09-22T11:50:47.385Z\",\n \"__v\": 0,\n \"rating\": 4.65\n },\n {\n \"location\": {\n \"city\": \"Cape Town\",\n \"country\": \"South Africa\"\n },\n \"_id\": \"650c9ea13f5c483328b39816\",\n \"name\": \"Cape Town\",\n \"description\": \"Cape Town offers stunning landscapes, from Table Mountain to beautiful beaches and wildlife safaris.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f528\",\n \"text\": \"Cape Town's natural beauty is jaw-dropping. I had an amazing time exploring the city and its surroundings.\",\n \"rating\": 4.25,\n \"_id\": \"650d8ee9f19786084e1d7bc4\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.128Z\",\n \"updatedAt\": \"2023-09-22T12:56:08.912Z\",\n \"__v\": 0,\n \"rating\": 4.25\n },\n {\n \"location\": {\n \"city\": \"Rome\",\n \"country\": \"Italy\"\n },\n \"_id\": \"650c9ea13f5c483328b39819\",\n \"name\": \"Rome\",\n \"description\": \"Rome is steeped in history, with ancient ruins like the Colosseum and the Roman Forum. Don't forget to try the pasta!\",\n \"reviews\": [\n {\n \"user\": \"650b43925246a3fac187f523\",\n \"text\": \"Rome is like an open-air museum. The food is heavenly, and every corner tells a story.\",\n \"rating\": 4,\n \"_id\": \"650d8f8192817cf3401bd530\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.140Z\",\n \"updatedAt\": \"2023-09-22T12:58:40.994Z\",\n \"__v\": 0,\n \"rating\": 4.01\n }\n ]\n}"},{"id":"b0409278-6f66-4048-9c95-989e6f2a0b1c","name":"Failure Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"34"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 14:26:28 GMT"},{"key":"Etag","value":"W/\"22-UUCyWLL0nuZ+df3h8Vuoh5qXqbQ\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7411199; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Destinations Not Found\"\n}"}],"_postman_id":"21f87425-d1f0-4aa8-9fcc-31e5b2f87ea7"},{"name":"Add Destination","id":"7e8011db-fc70-40c4-91f9-6a72b57c3d63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\t\"name\": \"Some Place\",\r\n\t\"rating\": 4,\r\n\t\"location\": {\r\n\t\t\"city\": \"somecity\",\r\n\t\t\"country\": \"somecountry\"\r\n\t}, \"description\": \"Test Place\",\r\n\t\"reviews\": []\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations","description":"

Title: Add a travel destination

Endpoint: POST /api/destinations

Description: This API endpoint allows users to create a new travel destination and store it in the database.

Parameters: None

Request Body:

name (String, required): The name of the travel destination.
location (String): The location of the travel destination.
description (String): A textual description of the travel destination.
rating (Number): The overall rating of the travel destination.

Returns:
Upon successful execution, this API responds with a JSON object confirming that the Destination data has been added to the Database.

Title: Read Destination by name

Endpoint: GET /api/destinations/:name

Description: This API endpoint allows users to retrieve information about a travel destination by specifying its name.

Parameters:

name (String, required): The name of the travel destination to be retrieved.

Returns:

Upon successful execution, this API responds with a JSON object containing the Destination data with name that matches the name parameter.

\n","urlObject":{"protocol":"https","path":["destinations","Rome"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"07bc6f44-6c3a-423b-8fb3-a3528481f364","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/Rome"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"583"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 14:48:55 GMT"},{"key":"Etag","value":"W/\"247-64iBNK1Xj7Ws4ZKl57Ohtv/iGdI\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7409852; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Retrieved Destination named Rome.\",\n \"data\": {\n \"location\": {\n \"city\": \"Rome\",\n \"country\": \"Italy\"\n },\n \"_id\": \"650c9ea13f5c483328b39819\",\n \"name\": \"Rome\",\n \"description\": \"Rome is steeped in history, with ancient ruins like the Colosseum and the Roman Forum. Don't forget to try the pasta!\",\n \"reviews\": [\n {\n \"user\": \"650b43925246a3fac187f523\",\n \"text\": \"Rome is like an open-air museum. The food is heavenly, and every corner tells a story.\",\n \"rating\": 4,\n \"_id\": \"650d8f8192817cf3401bd530\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.140Z\",\n \"updatedAt\": \"2023-09-22T12:58:40.994Z\",\n \"__v\": 0,\n \"rating\": 4.01\n }\n}"},{"id":"42ad6876-f8ba-4a55-8687-1ec5e34957e4","name":"Error Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/Tokyo"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"46"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 14:50:50 GMT"},{"key":"Etag","value":"W/\"2e-6RbWWcMC1LY2wvq1V4+3RLFY5+4\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7409737; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Destination named Tokyo Not Found.\"\n}"}],"_postman_id":"2ac492a4-34ca-4a57-9a9f-43c97fcd4830"},{"name":"Read Destinations by Location","id":"681e0b9a-c9b5-44f7-b961-8f63901a5528","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/location/Italy","description":"

Title: Read destinations by location

Endpoint: GET/api/destinations/location/:locationName

Description: This API endpoint allows users to retrieve travel destinations based on a specific location name.

Parameters:

locationName (String, required): The name of the location for which you want to retrieve travel destinations

Returns:

Upon successful execution, this API responds with an Array of JSON objects containing the Destination data with city or country that matches the locationName parameter.

\n","urlObject":{"protocol":"https","path":["destinations","location","Italy"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"6b0d24c8-7fc4-4820-b74a-393866f798c5","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/location/rome"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"583"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:04:11 GMT"},{"key":"Etag","value":"W/\"247-GR5gHzpxAP2UBc05vbWt0twbs9g\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7408937; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Retrieved Destinations in rome.\",\n \"data\": [\n {\n \"location\": {\n \"city\": \"Rome\",\n \"country\": \"Italy\"\n },\n \"_id\": \"650c9ea13f5c483328b39819\",\n \"name\": \"Rome\",\n \"description\": \"Rome is steeped in history, with ancient ruins like the Colosseum and the Roman Forum. Don't forget to try the pasta!\",\n \"reviews\": [\n {\n \"user\": \"650b43925246a3fac187f523\",\n \"text\": \"Rome is like an open-air museum. The food is heavenly, and every corner tells a story.\",\n \"rating\": 4,\n \"_id\": \"650d8f8192817cf3401bd530\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.140Z\",\n \"updatedAt\": \"2023-09-22T12:58:40.994Z\",\n \"__v\": 0,\n \"rating\": 4.01\n }\n ]\n}"},{"id":"843ba3b2-4600-441b-963d-0737098474e4","name":"Error Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/location/someplace"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"53"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:06:39 GMT"},{"key":"Etag","value":"W/\"35-af7YbXergzCUjP9w2dGPVBXwIiM\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7408788; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Failed to Find Destination in someplace.\"\n}"}],"_postman_id":"681e0b9a-c9b5-44f7-b961-8f63901a5528"},{"name":"Read Destinations Sorted by Ratings","id":"08ef28c9-1a3e-419e-ad09-f4ad046723d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/rating","description":"

Title: Read destinations Sorted by ratings

Endpoint: GET /api/destinations/rating

Description: This API endpoint allows users to retrieve travel destinations in the descending order of their rating.

Parameters: None

Returns:

Upon successful execution, this API responds with an Array of JSON objects containing the Destination data in descending order based on their rating.

\n","urlObject":{"protocol":"https","path":["destinations","rating"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"b399db65-8ce1-4413-b7cd-530212cbd893","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/rating"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"2930"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:21:24 GMT"},{"key":"Etag","value":"W/\"b72-zhd8Mt/dLy5+TWqAhrz+qjAZjIk\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7407903; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Retrieved Destinations Sorted By Rating.\",\n \"data\": [\n {\n \"location\": {\n \"city\": \"New York\",\n \"country\": \"USA\"\n },\n \"_id\": \"650c9ea13f5c483328b39814\",\n \"name\": \"New York City\",\n \"description\": \"The Big Apple is a bustling metropolis with iconic skyscrapers, Broadway shows, and diverse neighborhoods.\",\n \"reviews\": [],\n \"createdAt\": \"2023-09-21T19:50:57.117Z\",\n \"updatedAt\": \"2023-09-22T11:50:47.385Z\",\n \"__v\": 0,\n \"rating\": 4.65\n },\n {\n \"location\": {\n \"city\": \"Kyoto\",\n \"country\": \"Japan\"\n },\n \"_id\": \"650c9ea13f5c483328b39811\",\n \"name\": \"Kyoto\",\n \"description\": \"Kyoto is a city where tradition meets modernity. Explore ancient temples and enjoy delicious Japanese cuisine.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52a\",\n \"text\": \"Kyoto's temples are so serene and beautiful. A must-visit for anyone interested in Japanese culture.\",\n \"rating\": 4.5,\n \"_id\": \"650d8de36ebd466e4367af2c\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.103Z\",\n \"updatedAt\": \"2023-09-22T12:51:47.316Z\",\n \"__v\": 0,\n \"rating\": 4.5\n },\n {\n \"location\": {\n \"city\": \"Cape Town\",\n \"country\": \"South Africa\"\n },\n \"_id\": \"650c9ea13f5c483328b39816\",\n \"name\": \"Cape Town\",\n \"description\": \"Cape Town offers stunning landscapes, from Table Mountain to beautiful beaches and wildlife safaris.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f528\",\n \"text\": \"Cape Town's natural beauty is jaw-dropping. I had an amazing time exploring the city and its surroundings.\",\n \"rating\": 4.25,\n \"_id\": \"650d8ee9f19786084e1d7bc4\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.128Z\",\n \"updatedAt\": \"2023-09-22T12:56:08.912Z\",\n \"__v\": 0,\n \"rating\": 4.25\n },\n {\n \"location\": {\n \"city\": \"Paris\",\n \"country\": \"France\"\n },\n \"_id\": \"650c9ea03f5c483328b3980b\",\n \"name\": \"Paris\",\n \"description\": \"The City of Light is known for its romantic ambiance, world-class cuisine, and iconic landmarks like the Eiffel Tower.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52e\",\n \"text\": \"Paris is absolutely enchanting. The food, the culture, and the architecture are all incredible!\",\n \"rating\": 4.8,\n \"_id\": \"650d8d8e015565bf825487f4\"\n },\n {\n \"user\": \"650b43935246a3fac187f52c\",\n \"text\": \"I fell in love with Paris. It's a dream destination for anyone.\",\n \"rating\": 4.6,\n \"_id\": \"650d8d8e015565bf825487f5\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:56.500Z\",\n \"updatedAt\": \"2023-09-22T12:50:22.397Z\",\n \"__v\": 0,\n \"rating\": 4.2\n },\n {\n \"location\": {\n \"city\": \"Rome\",\n \"country\": \"Italy\"\n },\n \"_id\": \"650c9ea13f5c483328b39819\",\n \"name\": \"Rome\",\n \"description\": \"Rome is steeped in history, with ancient ruins like the Colosseum and the Roman Forum. Don't forget to try the pasta!\",\n \"reviews\": [\n {\n \"user\": \"650b43925246a3fac187f523\",\n \"text\": \"Rome is like an open-air museum. The food is heavenly, and every corner tells a story.\",\n \"rating\": 4,\n \"_id\": \"650d8f8192817cf3401bd530\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:57.140Z\",\n \"updatedAt\": \"2023-09-22T12:58:40.994Z\",\n \"__v\": 0,\n \"rating\": 4.01\n },\n {\n \"location\": {\n \"city\": \"somecity\",\n \"country\": \"somecountry\"\n },\n \"_id\": \"650da6c23879c2148d274d86\",\n \"name\": \"Some Place\",\n \"rating\": 4,\n \"description\": \"Test Place\",\n \"reviews\": [],\n \"createdAt\": \"2023-09-22T14:37:55.085Z\",\n \"updatedAt\": \"2023-09-22T14:37:55.085Z\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"08ef28c9-1a3e-419e-ad09-f4ad046723d0"},{"name":"Update Destination by ID","id":"e2a1dc3c-5c87-40db-9cbd-9b63a61c0078","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"rating\": 4.8\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b","description":"

Title: Update destination by ID

Endpoint: POST /api/destinations/:destinationId

Description: This API endpoint allows users to update a specific travel destination by providing its unique identifier (ID).

Parameters:

destinationId (String, required): The unique identifier of the destination to be updated. It is typically provided as part of the URL.

Request Body: This should contain the fields you want to update in the destination. This can be ratings, location, any of the parameter included in the destination model.

Returns:

Upon successful execution, this API responds with a JSON object containing the Destination data with destination _id that matches the destinationId parameter.

\n","urlObject":{"protocol":"https","path":["destinations","650c9ea03f5c483328b3980b"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"b14472e3-70d4-4fb6-b22b-6b8ceb29e6ba","name":"Success Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"rating\": 4.8\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"739"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:30:15 GMT"},{"key":"Etag","value":"W/\"2e3-0NR5hD+/vP3WN41Ga5gTKLVcbKE\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7407373; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Updated Destination.\",\n \"data\": {\n \"location\": {\n \"city\": \"Paris\",\n \"country\": \"France\"\n },\n \"_id\": \"650c9ea03f5c483328b3980b\",\n \"name\": \"Paris\",\n \"description\": \"The City of Light is known for its romantic ambiance, world-class cuisine, and iconic landmarks like the Eiffel Tower.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52e\",\n \"text\": \"Paris is absolutely enchanting. The food, the culture, and the architecture are all incredible!\",\n \"rating\": 4.8,\n \"_id\": \"650d8d8e015565bf825487f4\"\n },\n {\n \"user\": \"650b43935246a3fac187f52c\",\n \"text\": \"I fell in love with Paris. It's a dream destination for anyone.\",\n \"rating\": 4.6,\n \"_id\": \"650d8d8e015565bf825487f5\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:56.500Z\",\n \"updatedAt\": \"2023-09-22T15:30:15.298Z\",\n \"__v\": 0,\n \"rating\": 4.8\n }\n}"},{"id":"02506e02-227c-4cfd-8f4c-c620de515335","name":"Error Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"rating\": 4.8\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"75"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:31:14 GMT"},{"key":"Etag","value":"W/\"4b-qJuRlWq1ADe0UIY57/QhVeiLn24\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7407313; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Failed to Update Destination, try again with correct details.\"\n}"}],"_postman_id":"e2a1dc3c-5c87-40db-9cbd-9b63a61c0078"},{"name":"Delete Destination by ID","id":"afbfeb40-dab8-48e4-a13a-03dd355058ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/650da6c23879c2148d274d86","description":"

Title: Delete destination by ID

Endpoint: DELETE /api/destinations/:destinationId

Description: This API endpoint allows users to delete a specific travel destination by providing its unique identifier (ID).

Parameters:

destinationId (String, required): The unique identifier of the destination to be deleted. It is typically provided as part of the URL.

Returns:

Upon Successful execution, the API responds with a JSON object containing the Destination data that has been deleted.

\n","urlObject":{"protocol":"https","path":["destinations","650da6c23879c2148d274d86"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"9f0368c8-e0df-45ed-a65c-4aefc4d4e347","name":"Success Response","originalRequest":{"method":"DELETE","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/650da6c23879c2148d274d86"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"301"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:41:18 GMT"},{"key":"Etag","value":"W/\"12d-dJbM69DIRWQ+gIoB2yJ85xrl7G0\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7406710; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Deleted Destination.\",\n \"data\": {\n \"location\": {\n \"city\": \"somecity\",\n \"country\": \"somecountry\"\n },\n \"_id\": \"650da6c23879c2148d274d86\",\n \"name\": \"Some Place\",\n \"rating\": 4,\n \"description\": \"Test Place\",\n \"reviews\": [],\n \"createdAt\": \"2023-09-22T14:37:55.085Z\",\n \"updatedAt\": \"2023-09-22T14:37:55.085Z\",\n \"__v\": 0\n }\n}"},{"id":"1bc53b09-a994-42d1-8fda-940d8d277070","name":"Error Response","originalRequest":{"method":"DELETE","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/650da6c23879c2148d274d86"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"82"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:43:43 GMT"},{"key":"Etag","value":"W/\"52-wS92PHiTb6OWNTjgX+yU1T6VH1w\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7406564; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Failed to Delete Destination, try again with correct Destination id.\"\n}"}],"_postman_id":"afbfeb40-dab8-48e4-a13a-03dd355058ba"},{"name":"Filter Destinations by Rating","id":"b14dc892-cac3-45f6-897d-bbd8b9aba2b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/rating/4.5","description":"

Title: Filter destinations by Rating

Endpoint: GET /api/destinations/rating/:minRating

Description: This API endpoint allows users to filter travel destinations by their rating.

Parameters:

minRating (Number, required): The minimum rating that destinations must have to be included in the filtered results.

Returns:

Upon Successful execution, the API responds with an Array of JSON objects containing the Destination data that has minimum rating that matches the minRating parameter.

\n","urlObject":{"protocol":"https","path":["destinations","rating","4.5"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"45846b15-8b2a-4952-946a-91117d8fbcac","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/rating/4.6"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"1085"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:49:13 GMT"},{"key":"Etag","value":"W/\"43d-PtY5Xu8CzNnlJ/t5zvYeuhEyEsw\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7406234; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Retrieved Destinations.\",\n \"data\": [\n {\n \"location\": {\n \"city\": \"Paris\",\n \"country\": \"France\"\n },\n \"_id\": \"650c9ea03f5c483328b3980b\",\n \"name\": \"Paris\",\n \"description\": \"The City of Light is known for its romantic ambiance, world-class cuisine, and iconic landmarks like the Eiffel Tower.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52e\",\n \"text\": \"Paris is absolutely enchanting. The food, the culture, and the architecture are all incredible!\",\n \"rating\": 4.8,\n \"_id\": \"650d8d8e015565bf825487f4\"\n },\n {\n \"user\": \"650b43935246a3fac187f52c\",\n \"text\": \"I fell in love with Paris. It's a dream destination for anyone.\",\n \"rating\": 4.6,\n \"_id\": \"650d8d8e015565bf825487f5\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:56.500Z\",\n \"updatedAt\": \"2023-09-22T15:30:15.298Z\",\n \"__v\": 0,\n \"rating\": 4.8\n },\n {\n \"location\": {\n \"city\": \"New York\",\n \"country\": \"USA\"\n },\n \"_id\": \"650c9ea13f5c483328b39814\",\n \"name\": \"New York City\",\n \"description\": \"The Big Apple is a bustling metropolis with iconic skyscrapers, Broadway shows, and diverse neighborhoods.\",\n \"reviews\": [],\n \"createdAt\": \"2023-09-21T19:50:57.117Z\",\n \"updatedAt\": \"2023-09-22T11:50:47.385Z\",\n \"__v\": 0,\n \"rating\": 4.65\n }\n ]\n}"},{"id":"9b5d5b54-fd75-4426-ba4a-69270dcafce7","name":"Error Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/rating/4.5"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"46"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 15:53:54 GMT"},{"key":"Etag","value":"W/\"2e-N+xffwD1HgKhfnr/l4QSol/+7Zs\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7405954; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Failed to Retrieve Destinations.\"\n}"}],"_postman_id":"b14dc892-cac3-45f6-897d-bbd8b9aba2b2"},{"name":"Add Review to Destination","id":"36e43bb1-d889-4982-bab9-6adec4d263ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"user\":\"65074857993193d8b769c94a\",\r\n \"text\": \"Had an amazing trip!\",\r\n \"rating\":4.5\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b/reviews","description":"

Title: Add Review to Destination

Description: This API endpoint allows users to update reviews and ratings for a specific travel destination by providing its unique identifier (ID).

Endpoint: POST /destinations/:destinationId/reviews

Parameters:

destinationId (String, required): The unique identifier of the destination for which you want to update reviews and ratings. It is typically provided as part of the URL.

Request Body: This should contain the review and rating updates for the destination

Returns:

Upon Successful execution, the API responds with a JSON object confirming that the Review has been added to the Destination data.

\n","urlObject":{"protocol":"https","path":["destinations","650c9ea03f5c483328b3980b","reviews"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"b0cd3e16-0d81-4278-8501-6ff65a6b178d","name":"Success Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"user\":\"65074857993193d8b769c94a\",\r\n \"text\": \"Had an amazing trip!\",\r\n \"rating\":4.5\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b/reviews"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"859"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sun, 24 Sep 2023 15:42:47 GMT"},{"key":"Etag","value":"W/\"35b-FtSnAQdSyJa/43HI9Aipd/nPnAE\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7233821; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Added Review to Destination.\",\n \"data\": {\n \"location\": {\n \"city\": \"Paris\",\n \"country\": \"France\"\n },\n \"_id\": \"650c9ea03f5c483328b3980b\",\n \"name\": \"Paris\",\n \"description\": \"The City of Light is known for its romantic ambiance, world-class cuisine, and iconic landmarks like the Eiffel Tower.\",\n \"reviews\": [\n {\n \"user\": \"650b43935246a3fac187f52e\",\n \"text\": \"Paris is absolutely enchanting. The food, the culture, and the architecture are all incredible!\",\n \"rating\": 4.8,\n \"_id\": \"650d8d8e015565bf825487f4\"\n },\n {\n \"user\": \"650b43935246a3fac187f52c\",\n \"text\": \"I fell in love with Paris. It's a dream destination for anyone.\",\n \"rating\": 4.6,\n \"_id\": \"650d8d8e015565bf825487f5\"\n },\n {\n \"user\": \"65074857993193d8b769c94a\",\n \"text\": \"Had an amazing trip!\",\n \"rating\": 4.5,\n \"_id\": \"651058f6363e30f1672b3874\"\n }\n ],\n \"createdAt\": \"2023-09-21T19:50:56.500Z\",\n \"updatedAt\": \"2023-09-24T15:42:47.010Z\",\n \"__v\": 4,\n \"rating\": 4.6\n }\n}"},{"id":"8ae33b3c-8e8f-4b31-a961-c15837637018","name":"Error Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"user\":\"65074857993193d8b769c94a\",\r\n \"rating\":4.5\r\n}","options":{"raw":{"language":"json"}}},"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b/reviews"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"82"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 17:15:34 GMT"},{"key":"Etag","value":"W/\"52-ljoN0stT49EgmKibVnByc3U3tGU\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7401053; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Failed to Add Review to Destination, try again with correct details.\"\n}"}],"_postman_id":"36e43bb1-d889-4982-bab9-6adec4d263ae"},{"name":"Read Reviews for a Destination","id":"21209448-e309-4e52-9ba2-8c904e9f696f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b/reviews","description":"

Title: Read Reviews for a Destination

Endpoint: GET /api/destinations/:destinationId/reviews

Description: This API endpoint allows users to retrieve a limited number of reviews (e.g., 3) for a specific travel destination by providing its unique identifier (ID).

Parameters:

destinationId (String, required): The unique identifier of the destination for which you want to retrieve reviews. It is typically provided as part of the URL.

Returns:

Upon Successful execution, the API responds with an Array of JSON objects containing the top 3 reviews of the Destination data based on their rating.

\n","urlObject":{"protocol":"https","path":["destinations","650c9ea03f5c483328b3980b","reviews"],"host":["assignment13travellot","aasimd","repl","co"],"query":[],"variable":[]}},"response":[{"id":"5ee66f56-6c1a-45b2-a182-027aa0717d38","name":"Success Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b/reviews"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"806"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 17:27:25 GMT"},{"key":"Etag","value":"W/\"326-C/BXzPP9Adkzwpb+F2sTOsJLLFg\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7400342; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Successfully Retrieved Reviews for Requested Destination.\",\n \"data\": [\n {\n \"user\": {\n \"_id\": \"650b43935246a3fac187f52e\",\n \"username\": \"sarah_johnson\"\n },\n \"text\": \"Paris is absolutely enchanting. The food, the culture, and the architecture are all incredible!\",\n \"rating\": 4.8,\n \"_id\": \"650d8d8e015565bf825487f4\"\n },\n {\n \"user\": {\n \"_id\": \"650b43935246a3fac187f52c\",\n \"username\": \"david_wilson\"\n },\n \"text\": \"I fell in love with Paris. It's a dream destination for anyone.\",\n \"rating\": 4.6,\n \"_id\": \"650d8d8e015565bf825487f5\"\n },\n {\n \"user\": {\n \"_id\": \"65074857993193d8b769c94a\",\n \"profilePicUrl\": \"https://www.koimoi.com/wp-content/new-galleries/2022/08/the-batman-2-is-still-happening-the-robert-pattinson-starrer-has-an-update-around-its-script-001.jpg\",\n \"username\": \"aasimd\"\n },\n \"text\": \"Had an amazing trip!\",\n \"rating\": 4.5,\n \"_id\": \"650dcbb6b0a66da2379a1e01\"\n }\n ]\n}"},{"id":"d2a99884-e430-4508-8dcf-d76ef71c39bf","name":"Error Response","originalRequest":{"method":"GET","header":[],"url":"https://assignment13travellot.aasimd.repl.co/destinations/650c9ea03f5c483328b3980b/reviews"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"65"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Fri, 22 Sep 2023 17:25:31 GMT"},{"key":"Etag","value":"W/\"41-B7hvcsANnkB1BLMpp3/mP4CXfZY\""},{"key":"Expect-Ct","value":"max-age=2592000, report-uri=\"https://sentry.repl.it/api/10/security/?sentry_key=615192fd532445bfbbbe966cd7131791\""},{"key":"Replit-Cluster","value":"asia-b"},{"key":"Strict-Transport-Security","value":"max-age=7400457; includeSubDomains"},{"key":"X-Powered-By","value":"Express"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Failed to Retrieve Reviews for Requested Destination.\"\n}"}],"_postman_id":"21209448-e309-4e52-9ba2-8c904e9f696f"}]}