{"info":{"_postman_id":"ff19f537-41c6-4d84-ab2d-5a63bac167f5","name":"My Collection","description":"

Cafe API – Student-Friendly Overview

This collection shows a simple REST API for managing cafes. You can use it to:

Browse all cafes
Search cafes by location
Get a random cafe suggestion
Update a cafe’s coffee price
Mark a cafe as permanently closed

All requests in this collection currently use a local server:\nhttp://localhost:5000

Key Endpoints in This Collection

GET /all – List all cafes
\n
- Request: GET http://localhost:5000/all
- Use it for: Getting a full list of cafes with details such as name, location, wifi, sockets, and price.
- In this collection: Request named \"for all cafes\".
\n
GET /search/ – Search cafes by area
\n
- Request example: GET http://localhost:5000/search/Peckham
- Path parameter:
  - location – the area to search in (e.g., Peckham).
  \n
- Use it for: Finding cafes in a specific location.
- In this collection: Request named \"Search cafee and location\".
\n
GET /random – Get one random cafe
\n
- Request: GET http://localhost:5000/random
- Use it for: Getting a single random cafe suggestion.
- In this collection: Request named \"random one\".
\n
PATCH /update-price/?new_price=... – Update a cafe’s coffee price
\n
- Request example: PATCH http://localhost:5000/update-price/1?new_price=2.80
- Path parameter:
  - id – numeric cafe ID to update.
  \n
- Query parameter:
  - new_price – new coffee price (e.g., 2.80).
  \n
- Use it for: Editing the price of a cafe’s coffee.
- In this collection: Request named \"to update price\".
\n
DELETE /report-closed/?api_key=... – Mark a cafe as closed
\n
- Request example: DELETE http://localhost:5000/report-closed/5?api_key=supersecretkey123
- Path parameter:
  - id – numeric cafe ID to delete/mark closed.
  \n
- Query parameter:
  - api_key – required key that authorizes deletion.
  \n
- Use it for: Removing a cafe that has shut down.
- In this collection: Request named \"to delete a cafe\".
\n

How to Use This Collection in Postman (Step-by-Step)

Start your API server
\n
- Make sure the backend for this Cafe API is running locally on http://localhost:5000.
\n
Send your first request
\n
- Open the My Collection collection.
- Choose \"for all cafes\" (GET /all).
- Click Send.
- You should see a JSON array of cafes in the response.
\n
Try searching by location
\n
- Open \"Search cafee and location\" (GET /search/Peckham).
- Change Peckham in the URL to another location your API supports, if needed.
- Click Send to see cafes filtered by that location.
\n
Get a random cafe
\n
- Open \"random one\" (GET /random).
- Click Send and inspect the single cafe returned.
\n
Update a cafe’s price (PATCH)
\n
- Open \"to update price\" (PATCH /update-price/<id>).
- Change the id in the URL to a valid cafe ID.
- Adjust the new_price query parameter to the value you want.
- Click Send and then check /all or /search to confirm the new price.
\n
Report a cafe as closed (DELETE)
\n
- Open \"to delete a cafe\" (DELETE /report-closed/<id>).
- Change the id to the cafe you want to remove.
- Ensure the api_key query parameter is set to a valid key expected by your server.
- Click Send, then re-run /all to check that the cafe is gone.
\n

Notes for Students

All examples use a local server, so they only work when your API project is running.
You can duplicate these requests, change parameters, and observe how the JSON response changes.
This collection is a good starting point for learning:
- HTTP methods: GET, PATCH, DELETE
- Path vs query parameters
- Basic API testing with Postman.
\n

You can extend this API by adding more endpoints (for example, to create a new cafe) and then adding matching requests to this collection.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"52395039","collectionId":"ff19f537-41c6-4d84-ab2d-5a63bac167f5","publishedId":"2sBXcBo3HV","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-15T11:18:42.000Z"},"item":[{"name":"Search cafee and location","event":[{"listen":"test","script":{"id":"69c6c19e-3447-472e-b2c0-f6c6849dba99","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"e0a78aa1-5ce2-44db-a8fd-bcf81aff7c70","request":{"method":"GET","header":[],"url":"{{base_url}}/search/Peckham","description":"

This is a GET request and it is used to \"get\" data from an endpoint. There is no request body for a GET request, but you can use query parameters to help specify the resource you want data on (e.g., in this request, we have id=1).

A successful GET response will have a 200 OK status, and should include some kind of response body - for example, HTML web content or JSON data.

\n","urlObject":{"path":["search","Peckham"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0a78aa1-5ce2-44db-a8fd-bcf81aff7c70"},{"name":"random one","event":[{"listen":"test","script":{"id":"69c6c19e-3447-472e-b2c0-f6c6849dba99","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"2c590e32-f326-4a44-b6e1-f4c7683956c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/random","urlObject":{"path":["random"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2c590e32-f326-4a44-b6e1-f4c7683956c9"},{"name":"for all cafes","event":[{"listen":"test","script":{"id":"69c6c19e-3447-472e-b2c0-f6c6849dba99","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"65cfe626-10e5-47a5-a823-1b4f8f34c0a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/all","urlObject":{"path":["all"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"42af2db2-f897-4741-98b4-9194a36a073e","name":"for all cafes","originalRequest":{"method":"GET","header":[],"url":"{{base_url}}/all"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Sun, 15 Feb 2026 08:54:05 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"2184"},{"key":"Connection","value":"keep-alive"},{"key":"CF-RAY","value":"9ce3941d3e3d6091-MAA"},{"key":"Content-Encoding","value":"br"},{"key":"rndr-id","value":"d6a8d7c5-3f28-4f25"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-render-origin-server","value":"gunicorn"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"cafes\": [\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"21\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": false,\n \"id\": 1,\n \"img_url\": \"https://atlondonbridge.com/wp-content/uploads/2019/02/Pano_9758_9761-Edit-190918_LTS_Science_Gallery-Medium-Crop-V2.jpg\",\n \"location\": \"London Bridge\",\n \"map_url\": \"https://g.page/scigallerylon?share\",\n \"name\": \"Science Gallery London\",\n \"seats\": \"50+\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.75\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 2,\n \"img_url\": \"https://images.squarespace-cdn.com/content/v1/5734f3ff4d088e2c5b08fe13/1555848382269-9F13FE1WQDNUUDQOAOXF/ke17ZwdGBToddI8pDm48kAeyi0pcxjZfLZiASAF9yCBZw-zPPgdn4jUwVcJE1ZvWQUxwkmyExglNqGp0IvTJZUJFbgE-7XRK3dMEBRBhUpzV8NE8s7067ZLWyi1jRvJklJnlBFEUyq1al9AqaQ7pI4DcRJq_Lf3JCtFMXgpPQyk/copeland-park-bar-peckham\",\n \"location\": \"Peckham\",\n \"map_url\": \"https://g.page/CopelandSocial?share\",\n \"name\": \"Social - Copeland Road\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.75\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 3,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOMzXpKAQNyUvrjTGHqCgWk8spwnzwP8Ml2aDKt=s0\",\n \"location\": \"Peckham\",\n \"map_url\": \"https://g.page/one-all-cafe?share\",\n \"name\": \"One & All Cafe Peckham\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.80\",\n \"has_sockets\": true,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 4,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipPBAt6bYna7pv5c7e_PhCDPMKPb6oFf6kMT2VQ1=s0\",\n \"location\": \"Peckham\",\n \"map_url\": \"https://www.google.com/maps/place/Old+Spike+Roastery/@51.4651552,-0.0666088,17z/data=!4m12!1m6!3m5!1s0x487603a3a7dd838d:0x4105b39b30a737cf!2sOld+Spike+Roastery!8m2!3d51.4651552!4d-0.0666088!3m4!1s0x487603a3a7dd838d:0x4105b39b30a737cf!8m2!3d51.4651552!4d-0.0666088\",\n \"name\": \"Old Spike\",\n \"seats\": \"0-10\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.80\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 6,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipN-C650VmJ1XZhzOIBTg1bUu3_to_GHpyrmUplt=s0\",\n \"location\": \"Hackney\",\n \"map_url\": \"https://goo.gl/maps/DWnwaeeiwdYsBkEH9\",\n \"name\": \"Mare Street Market\",\n \"seats\": \"50+\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£3.00\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 7,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipP_NbZH7A1fIQyp5pRm1jOGwzKsDWewaxka6vDt=s0\",\n \"location\": \"Shoreditch\",\n \"map_url\": \"https://g.page/acehotellondon?share\",\n \"name\": \"Ace Hotel Shoreditch\",\n \"seats\": \"50+\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.10\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 8,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipPnOfo7wTICdiAyybF3iFhD3l5aoQjSO-GErma1=s0\",\n \"location\": \"Clerkenwell\",\n \"map_url\": \"https://goo.gl/maps/D9nXNYK3fa1cxwpK8\",\n \"name\": \"Goswell Road Coffee\",\n \"seats\": \"10-20\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£2.30\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 9,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipMrdTyRRozGBltwxAseQ4QeuNhbED6meQXlCPsx=s0\",\n \"location\": \"London Bridge\",\n \"map_url\": \"https://goo.gl/maps/LU1imQzBCRLFBxKUA\",\n \"name\": \"The Southwark Cathedral Cafe\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.70\",\n \"has_sockets\": false,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 10,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipNtHqqIc3kwhpjknrVcMdkhmpA77LDYKmpOJlxf=s0\",\n \"location\": \"Whitechapel\",\n \"map_url\": \"https://goo.gl/maps/v5tzRBVhPFueYp4x6\",\n \"name\": \"Trade Commercial Road\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£2.70\",\n \"has_sockets\": false,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 11,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOFimpFQmUORVGg0ER3lrfEiEnKpnYJck5guFqC=s0\",\n \"location\": \"Bankside\",\n \"map_url\": \"https://goo.gl/maps/6RvPHyhsDDUPs1ox8\",\n \"name\": \"The Tate Modern Cafe\",\n \"seats\": \"30-40\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£2.50\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 12,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipPyJHFtVzxor4RyQrT-ZEk7ej7OxvmIQYZUHe6G=s0\",\n \"location\": \"Clerkenwell\",\n \"map_url\": \"https://goo.gl/maps/HC4e9FJL48kLRH8W9\",\n \"name\": \"Forage Cafe\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.80\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 13,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipNJQIg-6YTOZhbLu12yGPN3klDxygs7cNAjEo0C=s0\",\n \"location\": \"Shoreditch\",\n \"map_url\": \"https://g.page/citizenm-london-shoreditch?share\",\n \"name\": \"Citizen M Hotel Shoreditch\",\n \"seats\": \"30-40\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£3.00\",\n \"has_sockets\": false,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 14,\n \"img_url\": \"https://images.adsttc.com/media/images/5014/ec99/28ba/0d58/2800/0d0f/large_jpg/stringio.jpg?1414576924\",\n \"location\": \"Barbican\",\n \"map_url\": \"https://goo.gl/maps/XPrcFj91LsQBvUa27\",\n \"name\": \"Barbican Centre\",\n \"seats\": \"50+\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.60\",\n \"has_sockets\": false,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 15,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOL6jxxpE_D3YS-Zzih61DqNXJKvRIDFiP6ieUI=s0\",\n \"location\": \"Clerkenwell\",\n \"map_url\": \"https://goo.gl/maps/mwAG272nQwSUc9bn8\",\n \"name\": \"The Slaughtered Lamb\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£1.80\",\n \"has_sockets\": false,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 16,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOchpT9ipgb7tpqglcTKpp2E8kZhsKvlYjUZ4e1=s0\",\n \"location\": \"South Kensington\",\n \"map_url\": \"https://goo.gl/maps/GPFSEuGEiDvQG8BH7\",\n \"name\": \"Fernandez and Wells Exhibition Road\",\n \"seats\": \"10-20\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£2.60\",\n \"has_sockets\": true,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 17,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOZ3WDAAxphLu657afVVATJ5TGxtturIOr8gt8u=s0\",\n \"location\": \"Whitechapel\",\n \"map_url\": \"https://goo.gl/maps/xv29seioiETAAZgN9\",\n \"name\": \"Whitechapel Grind\",\n \"seats\": \"30-40\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£2.60\",\n \"has_sockets\": true,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 18,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOutkI7wjWNXiPSTdf8CX0jXwyVHFTwFnVhyVJE=s0\",\n \"location\": \"Peckham\",\n \"map_url\": \"https://goo.gl/maps/qpcpX7MWhFSS1qxH9\",\n \"name\": \"The Peckham Pelican\",\n \"seats\": \"0 - 10\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.00\",\n \"has_sockets\": true,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 19,\n \"img_url\": \"https://www.nhm.ac.uk/content/dam/nhmwww/business-services/filming/Earth-Sciences-Library-1.jpg\",\n \"location\": \"South Kensington\",\n \"map_url\": \"https://goo.gl/maps/VU2PwnDDtH1WqCnK7\",\n \"name\": \"Natural History Museum Library\",\n \"seats\": \"40-50\"\n },\n {\n \"can_take_calls\": false,\n \"coffee_price\": \"£2.80\",\n \"has_sockets\": true,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 20,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipNlBWFgXBiP9YjKARy4dgjHGePOmtsfuQPRwGvb=s0\",\n \"location\": \"Shoreditch\",\n \"map_url\": \"https://goo.gl/maps/gYX271NxyuawiMcK8\",\n \"name\": \"The Bike Shed\",\n \"seats\": \"10-20\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"£2.40\",\n \"has_sockets\": true,\n \"has_toilet\": false,\n \"has_wifi\": true,\n \"id\": 21,\n \"img_url\": \"https://lh3.googleusercontent.com/p/AF1QipOhkJk2MBtFW1RydPU0zf3bf8upGkTQWyhDpXzZ=s0\",\n \"location\": \"Borough\",\n \"map_url\": \"https://g.page/fora---borough?share\",\n \"name\": \"FORA Borough\",\n \"seats\": \"20-30\"\n },\n {\n \"can_take_calls\": true,\n \"coffee_price\": \"2.5\",\n \"has_sockets\": true,\n \"has_toilet\": true,\n \"has_wifi\": true,\n \"id\": 22,\n \"img_url\": \"https://example.com/image.jpg\",\n \"location\": \"someplace on earth\",\n \"map_url\": \"hsr\",\n \"name\": \"alibaba\",\n \"seats\": \"20\"\n }\n ]\n}"}],"_postman_id":"65cfe626-10e5-47a5-a823-1b4f8f34c0a3"},{"name":"to update price","id":"50fece40-2263-462b-8b8c-ae686cb2b728","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"name","value":"alibaba","type":"text"},{"key":"map_url","value":"hsr","type":"text"},{"key":"img_url","value":"https://example.com/image.jpg","type":"text"},{"key":"loc","value":"someplace on earth","type":"text"},{"key":"seats","value":"20","type":"text"},{"key":"toilet","value":"0","type":"text"},{"key":"wifi","value":"0","type":"text"},{"key":"sockets","value":"0","type":"text"},{"key":"calls","value":"0","type":"text"},{"key":"coffee_price","value":"2.5","type":"text"}]},"url":"{{base_url}}/update-price/1?new_price=21","urlObject":{"path":["update-price","1"],"host":["{{base_url}}"],"query":[{"key":"new_price","value":"21"}],"variable":[]}},"response":[],"_postman_id":"50fece40-2263-462b-8b8c-ae686cb2b728"},{"name":"to delete a cafe","id":"36ea6034-ec80-40a0-983b-45b9551ab89e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/report-closed/5?api_key={{api_key}}\n","urlObject":{"path":["report-closed","5"],"host":["{{base_url}}"],"query":[{"key":"api_key","value":"{{api_key}}\n"}],"variable":[]}},"response":[],"_postman_id":"36ea6034-ec80-40a0-983b-45b9551ab89e"}],"event":[{"listen":"prerequest","script":{"id":"9bc05101-59cb-4387-8b86-600831687342","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"56d1d376-91fd-41c6-9126-fc7e0050cc1d","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"base_url\n","value":"https://cafe-wifi-api.onrender.com"}]}