{"info":{"_postman_id":"8fe8de83-7292-4f89-a7cc-334fb28aeaf9","name":"Find-a-Hub API","description":"

This Api allows you to have access to all the hubs in Nigeria, this is V1.0, you can currently Add a hub, Get all hubs, Get a hub by state, Get a hub by name and also by Tag, if you are interested in contributing/suggesting more features to this API, you can checkout the repository here as this project is currently open source or send me a message on twitter here

This API contains the following requests

Get all hubs
Get all hubs by state
Get hub by name
Get hub(s) by tag(s)
Add a new hub

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"13436124","collectionId":"8fe8de83-7292-4f89-a7cc-334fb28aeaf9","publishedId":"TzeTKV7V","public":true,"customColor":{"top-bar":"000","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2021-06-13T09:52:57.000Z"},"item":[{"name":"Get All Hubs","id":"c946778f-9085-480c-b252-1ba75084a597","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://findahub.herokuapp.com/api/gethubs","description":"

This endpoint allows you to get a list of all hubs in Nigeria.

\n","urlObject":{"protocol":"https","path":["api","gethubs"],"host":["findahub","herokuapp","com"],"query":[],"variable":[]}},"response":[{"id":"30c6975d-53e0-4424-987e-d1d38947412e","name":"Get All Hubs Example","originalRequest":{"method":"GET","header":[],"url":"https://findahub.herokuapp.com/api/gethubs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"code\":200,\r\n \"status\":\"success\",\r\n \"data\":[\r\n {\r\n \"name\": \"Sample Hub\",\r\n \"state\": \"Sample State\",\r\n \"address\": \"1, sample street.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"best in lagos\",\r\n \"website\": \"https://example.com\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n },\r\n {\r\n \"name\": \"Sample Hub\",\r\n \"state\": \"Sample State\",\r\n \"address\": \"1, sample street.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"best in lagos, cheapest in abuja\",\r\n \"website\": \"https://example.com\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n }\r\n\r\n ]\r\n}"}],"_postman_id":"c946778f-9085-480c-b252-1ba75084a597"},{"name":"Get Hub by state","id":"56c3a8fa-6ba5-4171-bbf6-5bbcc96d3520","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://findahub.herokuapp.com/api/getbystate?state=","description":"

This endpoint allows you to get the list of all hubs by state.

Path Parameter

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
state	string	state to search for

","urlObject":{"protocol":"https","path":["api","getbystate"],"host":["findahub","herokuapp","com"],"query":[{"key":"state","value":""}],"variable":[]}},"response":[{"id":"b3b84afe-4549-4dcd-b475-767456aca898","name":"Get Hub by state example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://findahub.herokuapp.com/api/getbystate?state=lagos","protocol":"https","host":["findahub","herokuapp","com"],"path":["api","getbystate"],"query":[{"key":"state","value":"lagos"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"code\":200,\r\n \"status\":\"success\",\r\n \"data\":{\r\n \"name\": \"Cc-Hub\",\r\n \"state\": \"Lagos State\",\r\n \"address\": \"19, herbert macauly way, Yaba, Lagos.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"best in lagos\",\r\n \"website\": \"https://test.com\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n }\r\n}"}],"_postman_id":"56c3a8fa-6ba5-4171-bbf6-5bbcc96d3520"},{"name":"Get Hub by name","id":"b267f5ef-e1ba-4fbc-92b1-07c2a96f9e32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://findahub.herokuapp.com/api/getbyname?name=","description":"

This endpoint allows you to get a hub by name.

Path Parameter

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
name	string	hub name to search for

","urlObject":{"protocol":"https","path":["api","getbyname"],"host":["findahub","herokuapp","com"],"query":[{"key":"name","value":""}],"variable":[]}},"response":[{"id":"0ff7f5d9-3f8c-4278-a2a6-41bdfb5b95b6","name":"Get Hub by name example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://findahub.herokuapp.com/api/getbyname?name=cc-hub","protocol":"https","host":["findahub","herokuapp","com"],"path":["api","getbyname"],"query":[{"key":"name","value":"cc-hub"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"code\":200,\r\n \"status\":\"success\",\r\n \"data\":{\r\n \"name\": \"Cc-Hub\",\r\n \"state\": \"Lagos State\",\r\n \"address\": \"19, herbert macauly way, Yaba, Lagos.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"best in lagos\",\r\n \"website\": \"https://test.com\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n }\r\n}"}],"_postman_id":"b267f5ef-e1ba-4fbc-92b1-07c2a96f9e32"},{"name":"Get Hub by tag","id":"64fec51a-0d7b-4cb4-962a-e215a1ea2936","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://findahub.herokuapp.com/api/getbytag?tag=","description":"

This endpoint allows you to get a hub by tag(s).

Path Parameter

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
tag	string	tag used to identify the hub

","urlObject":{"protocol":"https","path":["api","getbytag"],"host":["findahub","herokuapp","com"],"query":[{"key":"tag","value":""}],"variable":[]}},"response":[{"id":"60c0c45b-edf7-4170-87dd-d04d0378a58f","name":"Get Hub by tag","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://findahub.herokuapp.com/api/getbytag?tag=360","protocol":"https","host":["findahub","herokuapp","com"],"path":["api","getbytag"],"query":[{"key":"tag","value":"360"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":" {\r\n \"code\":200,\r\n \"status\":\"success\",\r\n \"data\":{\r\n \"name\": \"360 Creative Hub\",\r\n \"state\": \"Lagos State\",\r\n \"address\": \"34 Ajao Rd off Olufemi Str. off Ogunlana drive Surulere, Lagos.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"360\",\r\n \"website\": \"https://360creativehub.com/\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n }\r\n }"}],"_postman_id":"64fec51a-0d7b-4cb4-962a-e215a1ea2936"},{"name":"Add a Hub","id":"b0687d73-e439-4a18-bdc9-13a0e24ff2b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"test hub\",\r\n \"state\": \"test State\",\r\n \"address\": \"19, test street, test.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"best in lagos, cheapest in abuja\",\r\n \"website\": \"https://test.com\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://findahub.herokuapp.com/api/addhub","description":"

This endpoint allows you to add a hub in your area.

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
name	string	hub name
state	string	state located in
address	string	address(es)
website	string	website url
tags	string	keyword that can be used to identify the hub
imageUrl	string	image url(s)
longitude	string	longitude of the hub
latitude	string	latitude of the hub

","urlObject":{"protocol":"https","path":["api","addhub"],"host":["findahub","herokuapp","com"],"query":[],"variable":[]}},"response":[{"id":"5e7202c5-33e3-438f-b1c7-e16da1b8b172","name":"Add a Hub example","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"test hub\",\r\n \"state\": \"test State\",\r\n \"address\": \"19, test street, test.\",\r\n \"image\": \"https://via.placeholder.com/300\",\r\n \"tags\": \"best in lagos\",\r\n \"website\": \"https://test.com\",\r\n \"longitude\":\"3.293584\",\r\n \"latitude\": \"6.481988\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://findahub.herokuapp.com/api/addhub"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"code\":201,\r\n \"status\":\"success\",\r\n \"message\": \"Hub successfully added\"\r\n}"}],"_postman_id":"b0687d73-e439-4a18-bdc9-13a0e24ff2b6"}]}