{"info":{"_postman_id":"0e60501f-d745-4c01-b5f5-ac36e99eebc0","name":"Events Rest API","description":"

A REST API made with GO (golang) and Gin (framework)

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21525358","collectionId":"0e60501f-d745-4c01-b5f5-ac36e99eebc0","publishedId":"2s9YsJBCmD","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-01-07T18:38:21.000Z"},"item":[{"name":"All events","id":"2d2bdd05-ea16-43fa-8d83-ff6a04151de2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

To get all events from the db.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"45563caf-306a-4ee9-b460-27c3b6c538c0","name":"Example","originalRequest":{"method":"GET","header":[],"url":"https://events-rest-api-production.up.railway.app/events"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 17:49:51 GMT"},{"key":"content-length","value":"141"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"ID\": 1,\n \"Title\": \"Example Event\",\n \"Description\": \"Event description\",\n \"Location\": \"Event location\",\n \"DateTime\": \"2024-01-01T15:35:00Z\",\n \"UserID\": 1\n }\n]"}],"_postman_id":"2d2bdd05-ea16-43fa-8d83-ff6a04151de2"},{"name":"Single Event","id":"4275ea96-d98a-4fd7-9c40-e11810b8ec15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://events-rest-api-production.up.railway.app/events/1","description":"

To get one single event according to its ID

To signup (register) a new user.

\n","urlObject":{"protocol":"https","path":["signup"],"host":["events-rest-api-production","up","railway","app"],"query":[],"variable":[]}},"response":[{"id":"f359632a-23a4-4182-a06d-46fdf9a18c7c","name":"Example","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"test2@emai.com\",\r\n \"password\": \"test2\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/signup"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 17:08:12 GMT"},{"key":"content-length","value":"40"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"User created successfully!\"\n}"}],"_postman_id":"f9f4640c-d04a-4818-b7e8-ea784013ecd0"},{"name":"Login","id":"cc5363c8-5ee1-4545-86e1-a635c7643099","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"description":"

To login (user should be already registered). It will give you a token.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"f9e5ec7d-aafe-49d9-82ba-3d0af213037f","name":"Example","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"test1@email.com\",\r\n \"password\": \"test1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Mon, 26 Feb 2024 21:02:51 GMT"},{"key":"content-length","value":"210"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 2,\n \"message\": \"Logged in successfully!\",\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWlsLmNvbSIsImV4cCI6MTcwODk4NDk3MSwidXNlcklkIjoyfQ.1_--AeXiJ5QxunG7zp5L-ft1hLI_ae1XpqQ06bVr_HM\"\n}"}],"_postman_id":"cc5363c8-5ee1-4545-86e1-a635c7643099"},{"name":"Create event","id":"63240ea4-0eb3-4a24-96de-c0bb28036b82","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"Example Event\",\r\n \"description\": \"Event description\",\r\n \"location\": \"Event location\",\r\n \"DateTime\": \"2024-01-01T15:35:00.000Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events","description":"

To create an event (it needs the login token in the Authorization headers)

\n","urlObject":{"protocol":"https","path":["events"],"host":["events-rest-api-production","up","railway","app"],"query":[],"variable":[]}},"response":[{"id":"324b4c74-1318-4a00-b501-34179b8a17f0","name":"Created Example","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjUwOTU2LCJ1c2VySWQiOjF9.D7Qe4KjEIOn7E7n6uC0E5subkY92AQ1pmMbxRjOAqDs","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"Example Event\",\r\n \"description\": \"Event description\",\r\n \"location\": \"Event location\",\r\n \"DateTime\": \"2024-01-01T15:35:00.000Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 17:11:25 GMT"},{"key":"content-length","value":"188"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"event\": {\n \"ID\": 1,\n \"Title\": \"Example Event\",\n \"Description\": \"Event description\",\n \"Location\": \"Event location\",\n \"DateTime\": \"2024-01-01T15:35:00Z\",\n \"UserID\": 1\n },\n \"status\": \"Event created successfully!\"\n}"},{"id":"2fbca5a3-11b7-4336-9330-1438b5832b8f","name":"Not authorized example","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1y","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"Example Event\",\r\n \"description\": \"Event description\",\r\n \"location\": \"Event location\",\r\n \"DateTime\": \"2024-01-01T15:35:00.000Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:26:33 GMT"},{"key":"content-length","value":"29"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not authorized!\"\n}"}],"_postman_id":"63240ea4-0eb3-4a24-96de-c0bb28036b82"},{"name":"Update event","id":"1b2ac224-2cf3-49ce-a61d-0bf5be9a2d6e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/1","description":"

To update an event according to its ID (it needs the token of the logged user in the Authorization headers and only the user that created the event can update it).

\n","urlObject":{"protocol":"https","path":["events","1"],"host":["events-rest-api-production","up","railway","app"],"query":[],"variable":[]}},"response":[{"id":"038eda4c-f878-4161-b516-dc06a500e493","name":"Event updated example","originalRequest":{"method":"PUT","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"UPDATED EVENT\",\r\n \"description\": \"Event UPDATED description\",\r\n \"location\": \"Event UPDATED location\",\r\n \"DateTime\": \"2024-06-02T15:35:00.000Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:12:37 GMT"},{"key":"content-length","value":"41"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Event updated successfully!\"\n}"},{"id":"f36ac92d-267e-45c0-89b0-52768535f8a2","name":"Not Authorized example","originalRequest":{"method":"PUT","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjUwOTU2LCJ1c2VySWQiOjF9.D7Qe4KjEIOn7E7n6uC0E5subkY92AQ1pmMbxRjOAqDs","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"title\": \"UPDATED EVENT\",\r\n \"description\": \"Event UPDATED description\",\r\n \"location\": \"Event UPDATED location\",\r\n \"DateTime\": \"2024-06-02T15:35:00.000Z\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events/1"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:11:37 GMT"},{"key":"content-length","value":"29"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not authorized!\"\n}"}],"_postman_id":"1b2ac224-2cf3-49ce-a61d-0bf5be9a2d6e"},{"name":"Delete event","id":"46a31eae-8bd6-424d-b528-bacd8289de9d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events/1","description":"

To delete an event according to its ID (it needs the token in the authorization headers and only the user that created the event can delete it).

\n","urlObject":{"protocol":"https","path":["events","1"],"host":["events-rest-api-production","up","railway","app"],"query":[],"variable":[]}},"response":[{"id":"7e8fb58a-29ab-44ff-af03-a2ce212c0e8e","name":"Event deleted example","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:17:34 GMT"},{"key":"content-length","value":"41"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Event deleted successfully!\"\n}"},{"id":"5a83d8f1-183b-4fae-8b1b-20ac78ac5dfb","name":"Not authorized example","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://events-rest-api-production.up.railway.app/events/1"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:16:49 GMT"},{"key":"content-length","value":"29"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not authorized!\"\n}"}],"_postman_id":"46a31eae-8bd6-424d-b528-bacd8289de9d"},{"name":"Register to an event","id":"b1dd7972-935c-43cc-a44b-45e473985eb9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/2/register","description":"

To register a user in a certain event (based on the event ID). It needs the login token, in the Authorization headers, of the user that is going to be registered in the event.

\n","urlObject":{"protocol":"https","path":["events","2","register"],"host":["events-rest-api-production","up","railway","app"],"query":[],"variable":[]}},"response":[{"id":"6c936dca-af28-450d-8604-18df1a87a772","name":"Registered example","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/2/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:21:18 GMT"},{"key":"content-length","value":"38"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Registered successfully!\"\n}"},{"id":"88eab4ec-9e5f-4986-a76c-7ea3a926cbf6","name":"Not authorized example","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1y","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/2/register"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:21:49 GMT"},{"key":"content-length","value":"29"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not authorized!\"\n}"}],"_postman_id":"b1dd7972-935c-43cc-a44b-45e473985eb9"},{"name":"All registrations","id":"ca806d47-e49c-48c3-99db-d130109c4fdf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

To get all registrations (relations between events and user ids).

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"bb051f61-85f4-48a0-834b-eb06b2bf8319","name":"Example","originalRequest":{"method":"GET","header":[],"url":"https://events-rest-api-production.up.railway.app/events/registrations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:29:03 GMT"},{"key":"content-length","value":"33"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"ID\": 1,\n \"UserID\": 2,\n \"EventID\": 1\n }\n]"}],"_postman_id":"ca806d47-e49c-48c3-99db-d130109c4fdf"},{"name":"Cancel registration","id":"589498fe-1d3c-4aee-81d1-2412a28fa2fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/2/register","description":"

To cancel a user registration to an event (it needs the login token in the Authorization headers).

\n","urlObject":{"protocol":"https","path":["events","2","register"],"host":["events-rest-api-production","up","railway","app"],"query":[],"variable":[]}},"response":[{"id":"a7e2d53d-aa9b-4c07-a14c-aca77b4069d0","name":"Registration canceled example","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1yU","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/2/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:32:03 GMT"},{"key":"content-length","value":"50"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Registration cancelled successfully!\"\n}"},{"id":"b8b56be2-7a74-4208-a775-c2375e3b117a","name":"Not authorized example","originalRequest":{"method":"DELETE","header":[{"key":"Authorization","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InRlc3QxQGVtYWkuY29tIiwiZXhwIjoxNzA0NjU0NzM4LCJ1c2VySWQiOjF9.dVZhJdqU3sqxdiooRBKwN9rWTiWPFGAqz0ufW3AN1y","type":"text"}],"url":"https://events-rest-api-production.up.railway.app/events/2/register"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 07 Jan 2024 18:31:37 GMT"},{"key":"content-length","value":"29"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Not authorized!\"\n}"}],"_postman_id":"589498fe-1d3c-4aee-81d1-2412a28fa2fc"},{"name":"Filtered Events","id":"610d0d0a-33c5-46fe-9b11-0915f52fc5a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

To get the filtered events by year and month query params. These are selected from the search bar in the frontend application.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"b5f9fdaf-8d5a-424c-8106-08b596626276","name":"Example","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://events-rest-api-production.up.railway.app/events/filtered?year=2024&month=4","protocol":"https","host":["events-rest-api-production","up","railway","app"],"path":["events","filtered"],"query":[{"key":"year","value":"2024"},{"key":"month","value":"4"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"date","value":"Sun, 25 Feb 2024 00:58:07 GMT"},{"key":"content-length","value":"227"},{"key":"server","value":"railway"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"ID\": 4,\n \"Title\": \"Kid's Day\",\n \"Description\": \"Celebrate all kids!\",\n \"Location\": \"Around the world\",\n \"Date\": \"2024-04-30T00:00:00Z\",\n \"ImageURL\": \"https://i.pinimg.com/originals/bb/68/c7/bb68c731fe4d404d74aa9ae1f0858613.jpg\",\n \"UserID\": 1\n }\n]"}],"_postman_id":"610d0d0a-33c5-46fe-9b11-0915f52fc5a2"}]}