This system is a REST API designed to manage ticket sales and purchases for various events, such as concerts, conferences or workshops. This API was developed using Node.js and Express as the backend framework, with MongoDB as the main database for storing information related to events, tickets and user transactions. Redis is used for caching and session management, which improves system performance and efficiency.
\nhttp://localhost:3000/api/v1\n\nThis endpoint is used to register new users.
\n","urlObject":{"path":["auth","register"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"31d0e469-6bd8-4528-a49e-059f01f50366","name":"success respon","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"first_name\": \"John\",\r\n \"last_name\": \"Doe\",\r\n \"email\": \"JohnDoe@gmail.com\",\r\n \"gender\": \"male\",\r\n \"birthdate\": \"2024-12-09\",\r\n \"password\": \"123Password\",\r\n \"confirm_password\": \"123Password\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/auth/register"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"61"},{"key":"ETag","value":"W/\"3d-wWuquV2pqcnupndFZA66qtYa5Tc\""},{"key":"Date","value":"Wed, 28 Aug 2024 04:52:34 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"User registered successfully\"\n}"}],"_postman_id":"957ea46a-adcc-4472-8a1c-32c54afec2a0"},{"name":"Login","id":"c95429dc-4256-4e5c-8d7b-4dd833fb14e2","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"JohnDoe@gmail.com\",\r\n \"password\": \"123Password\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/auth/login","description":"This endpoint is used for user login with email and password. If authentication is successful, the server will send the access token and refresh token.
\n","urlObject":{"path":["auth","login"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"4a485188-23b7-4e6a-9cef-8b021a3a3cad","name":"Login","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"JohnDoe@gmail.com\",\r\n \"password\": \"123Password\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"619"},{"key":"ETag","value":"W/\"26b-1pnHRMoOhEkAntZwU45i/q6wgdc\""},{"key":"Date","value":"Wed, 28 Aug 2024 04:54:47 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"User logged in successfully\",\n \"data\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI2NmNlYWQxMjIwY2E2ZGU5ZWE0ZDNkMzEiLCJ0eXBlIjoiYWNjZXNzIiwiaWF0IjoxNzI0ODIwODg3LCJleHAiOjE3MjQ5MDcyODcsImF1ZCI6IkFQSSIsImlzcyI6IkFQSSIsInN1YiI6ImpvaG5kb2VAZ21haWwuY29tIn0.EBhMcpPHmU29CiuFDXeVBdqyqFGt5zA11e0_shSy0o4\",\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI2NmNlYWQxMjIwY2E2ZGU5ZWE0ZDNkMzEiLCJ0eXBlIjoicmVmcmVzaCIsImlhdCI6MTcyNDgyMDg4NywiZXhwIjoxNzI0OTA3Mjg3LCJhdWQiOiJBUEkiLCJpc3MiOiJBUEkiLCJzdWIiOiJqb2huZG9lQGdtYWlsLmNvbSJ9.l3heFM-ZofH1EO4sG_xSZEVbnfsVrlvPTvQhxqY_kkA\"\n }\n}"}],"_postman_id":"c95429dc-4256-4e5c-8d7b-4dd833fb14e2"},{"name":"logout","id":"a7665d6b-baae-43a0-b42a-d43db6e00b94","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"refreshToken\" : \"\" ////gunakan refreshtoken yg disimpan\r\n}","options":{"raw":{"language":"json"}}},"url":"/auth/logout","description":"This endpoint is used to log out the user and remove the refresh token from the server.
\n\n\n","urlObject":{"path":["auth","logout"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"76c8e83b-c5ae-49a6-9791-7c53238d161d","name":"logout","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"refreshToken\" : \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/auth/logout"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"61"},{"key":"ETag","value":"W/\"3d-dOpBAULxHtr7+aIW1TeWWSR6pVo\""},{"key":"Date","value":"Wed, 28 Aug 2024 05:27:25 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"User logged out successfully\"\n}"}],"_postman_id":"a7665d6b-baae-43a0-b42a-d43db6e00b94"},{"name":"Refresh Token","id":"9d229ce3-10e2-47a1-9ae9-845e1cdaf47f","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"method":"POST","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"refreshToken\" : \"\" //gunakan refreshtoken yg disimpan\r\n}","options":{"raw":{"language":"json"}}},"url":"/auth/refresh-token","description":"Dont forget to remove your access token and refresh token from your device when logout
\n
This endpoint is used to get a new access token using a valid refresh token.
\nUse HTTP Interceptor, This endpoint will be called automatically using HTTP interceptor if the access token has expired.
\n","urlObject":{"path":["auth","refresh-token"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"e0bb8ba5-5ab9-4933-b971-19f3511189f4","name":"Refresh Token","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"","type":"text","disabled":true},{"key":"Refresh-Authorization","value":"","type":"text","disabled":true}],"body":{"mode":"urlencoded","urlencoded":[{"key":"refreshToken","value":"","type":"text"}]},"url":"/auth/refresh-token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"341"},{"key":"ETag","value":"W/\"155-3eTaYFaZT6AwFRZrb3cYXsKgKaM\""},{"key":"Date","value":"Wed, 28 Aug 2024 05:27:38 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Token refreshed successfully\",\n \"data\": {\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI2NmNlYWQxMjIwY2E2ZGU5ZWE0ZDNkMzEiLCJ0eXBlIjoiYWNjZXNzIiwiaWF0IjoxNzI0ODIyODU4LCJleHAiOjE3MjQ5MDkyNTgsImF1ZCI6IkFQSSIsImlzcyI6IkFQSSIsInN1YiI6ImpvaG5kb2VAZ21haWwuY29tIn0.MzFRyygY3lJFDg2J3XnfPdSq9iNPPrF673DZcDz-res\"\n }\n}"}],"_postman_id":"9d229ce3-10e2-47a1-9ae9-845e1cdaf47f"}],"id":"41625608-4688-427f-bd87-f7137bb40659","description":"(Auth) is designed to manage user login, registration and authentication processes using JSON Web Tokens (JWT). This system uses access tokens and refresh tokens to provide secure and efficient access to protected resources.
\nWhen Login you will get respon data access token and refresh token
\nAccess Token: It is recommended to store the access token in application memory (for example, in a state variable) and not in local storage or session storage to avoid the risk of XSS (Cross-Site Scripting) attacks.
\nRefresh Token: Refresh tokens should be stored in HTTP-only secure cookies to ensure their security and protect against XSS attacks.
\nFor a more in-depth explanation and code examples, you can refer to these resources:
\n\nEvery request that requires authentication must include an access token in the Authorization header in the following format:
\nAuthorization: Bearer {{youraccesstoken}}\n\nIf the request does not include this header or if the access token is invalid, the server will return 401 Unauthorized.
\nIf the access token expires, it's best to handle the token renewal using an HTTP interceptor on the client (for example, in the frontend application). The HTTP interceptor can detect a 401 Unauthorized response resulting from an expired access token, then automatically send a request to the refresh-token endpoint to obtain a new access token, and repeat the original request with the updated token.
\nExample of handling flow:
\nRequests to Protected Resources: The client sends a request with an access token.
\n401 Unauthorized response: If the access token expires, the server responds with 401 Unauthorized.
\nHTTP Interceptor:
\nRetrieves the refresh token from the cookie.
\nSend a request to the /api/auth/refresh-token endpoint to obtain a new access token.
\nIf the refresh token is valid, the system repeats the original request with the new access token.
\nIf the refresh token also expires, the user will be asked to log in again.
\nWith this approach, the system remains secure and users do not have to re-login frequently, providing a smoother and more efficient experience.
\n","_postman_id":"41625608-4688-427f-bd87-f7137bb40659"},{"name":"User","item":[{"name":"Profile","id":"d2d4ebf3-274f-4cbb-b2d8-43f4e6185c1b","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"x-api-key","value":"","type":"text"}],"url":"/user/profile","description":"Endpoint: GET /api/user/profile/:username?
This endpoint is used to view user profiles based on username. If a username is not provided, the system will display the profile of the currently logged in user.
\nAuthorization:
\nOptional (users can view other people's profiles without authentication, but viewing their own profile requires a token).
\nURL Parameters:
\nusername (optional): Username of the user whose profile you want to view.
\n","urlObject":{"path":["user","profile"],"host":[""],"query":[{"disabled":true,"key":"","value":""}],"variable":[]}},"response":[{"id":"60789b47-c65b-4ca0-99fd-f87afd743575","name":"Without Param Username","originalRequest":{"method":"GET","header":[],"url":"/user/profile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"362"},{"key":"ETag","value":"W/\"16a-yBEIwgYlNqtLfmhSSjLb8suyfgQ\""},{"key":"Date","value":"Wed, 28 Aug 2024 05:29:00 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"User profile fetched successfully\",\n \"data\": {\n \"_id\": \"66bc85f2de0b3c124512b372\",\n \"name\": {\n \"first_name\": \"iqbal anjay\",\n \"last_name\": \"anshori123\"\n },\n \"username\": \"User1723631090741\",\n \"profile_picture\": \"66bc85f2de0b3c124512b372-1724683225748-Logo Himatif.png\",\n \"email\": \"iqbal111@gmail.com\",\n \"birthdate\": \"2024-12-09T00:00:00.000Z\",\n \"gender\": \"female\"\n }\n}"},{"id":"08ff0cec-c39b-49f8-b843-69cf38911545","name":"Search With Param Username","originalRequest":{"method":"GET","header":[],"url":"/user/profile/iqbalanshr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"266"},{"key":"ETag","value":"W/\"10a-iqWICZuxVUalHnnweN/M1AhM900\""},{"key":"Date","value":"Wed, 28 Aug 2024 05:27:59 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"User profile fetched successfully\",\n \"data\": {\n \"_id\": \"66aceb9dfea5e90cbdc694a2\",\n \"name\": {\n \"first_name\": \"iqbal anjay\",\n \"last_name\": \"anshori\"\n },\n \"username\": \"iqbalanshr\",\n \"profile_picture\": \"66aceb9dfea5e90cbdc694a2-1723631428508-Logo Himatif.png\"\n }\n}"}],"_postman_id":"d2d4ebf3-274f-4cbb-b2d8-43f4e6185c1b"},{"name":"Update Profile","id":"43a30a7e-1bca-42ac-babe-d16a892f7ec0","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n// \"first_name\": \"John\",\r\n// \"last_name\": \"Doe\",\r\n// \"email\": \"JohnDoe@gmail.com\",\r\n \"gender\": \"female\",\r\n \"birthdate\": \"2024-12-08\",\r\n \"username\": \"johndoe\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/user/profile","description":"Endpoint: PUT /api/user/profile
This endpoint is used to update a logged in user's profile information, such as name, bio, or other details.
\nAuthorization:
\nRequired (Only authenticated users can update their profile).
\n","urlObject":{"path":["user","profile"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"0034281c-f46a-46ba-8426-7bd8a473c3df","name":"Update Profile","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n// \"first_name\": \"John\",\r\n// \"last_name\": \"Doe\",\r\n// \"email\": \"JohnDoe@gmail.com\",\r\n \"gender\": \"female\",\r\n \"birthdate\": \"2024-12-08\",\r\n \"username\": \"johndoe\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/user/profile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"61"},{"key":"ETag","value":"W/\"3d-Wx+veiXNNfsei1CR7cl4I8Uizig\""},{"key":"Date","value":"Wed, 28 Aug 2024 06:26:03 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Profile updated successfully\"\n}"}],"_postman_id":"43a30a7e-1bca-42ac-babe-d16a892f7ec0"},{"name":"Change Password","id":"5c54b9cb-c050-48e3-aad7-191d12e8a7cf","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"old_password\": \"123Hahaha\",\r\n \"new_password\": \"123Hahaha\",\r\n \"confirm_password\": \"123Hahaha\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/user/change-password","description":"Endpoint: PUT /api/user/change-password
This endpoint is used to change the password of the currently logged in user. User must provide old password and new password.
Authorization: Required.
Endpoint: PUT /api/user/profile-picture
This endpoint is used to upload and update a logged in user's profile picture. Uploaded images must be valid image files.
Authorization: Required.
Request Body: Multipart form-data with image files. (only 1 image can be stored)
Endpoint: DELETE /api/user/profile-picture
This endpoint is used to delete the logged in user's profile picture.
Authorization: Required.
This API route provides multiple endpoints for managing user profiles, including viewing profiles, updating profiles, changing passwords, and managing profile pictures. All endpoints that require authentication will use a JWT access token which must be included in the Authorization header on each request.
\n","_postman_id":"cc96129e-070d-44c1-9860-29555dc7e66e"},{"name":"Event","item":[{"name":"As an Owner Event","item":[{"name":"Get All User Event","id":"a57db415-d090-41fe-a74e-565108243fe5","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"/event/o/?city=Cimahi&month=2024-08&page=1&limit=15","description":"Endpoint: GET /api/events/o
Gets a list of all events created by the currently logged in user.
Authorization: Required.
Query parameters:
\ncity=Cimahi:
month=2024-09:
page=1:
limit=15:
search=concert:
Default Behavior:
\nMonth:
\nmonth parameter is not specified, the system defaults to the current month, meaning it will display events that start within the current month.Limit:
\nlimit parameter is not specified, the system defaults to displaying 15 events per page. This controls how many events are shown in the search results on each page.Search Query:
\nsearch parameter is not specified, the system will return all events that match the other specified filters without performing any text search.Endpoint: GET /api/events/o/:id
Get event details based on the ID for the event owned by the currently logged in user.
Authorization: Required.
URL Parameters:
\nid: id of the event
\n","urlObject":{"path":["event","o","66cdac5801e5760168c6b9d1"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"eea6ac51-41e2-4798-94fa-49051e8e8581","name":"Get Event by Id","originalRequest":{"method":"GET","header":[],"url":"/event/o/66cdac5801e5760168c6b9d1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1222"},{"key":"ETag","value":"W/\"4c6-GVeZ0Q/xLg/kBota1YaSMIBgC0A\""},{"key":"Date","value":"Wed, 28 Aug 2024 07:31:00 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Event fetched successfully\",\n \"data\": {\n \"_id\": \"66cdac5801e5760168c6b9d1\",\n \"name\": \"Cimahi Expo\",\n \"description\": \"Rame pokoknya mah dateng yah\",\n \"date\": \"2024-08-28T01:50:22.727Z\",\n \"location\": {\n \"province\": \"Jawa Barat\",\n \"city\": \"Cimahi Selatan\",\n \"address\": \"Jl. dirgantara\"\n },\n \"organizer\": \"66bc85f2de0b3c124512b372\",\n \"ticket_types\": [\n {\n \"type\": \"regular cat2\",\n \"price\": 20000,\n \"limit\": 100,\n \"sold\": 4,\n \"until\": \"2024-09-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66cdae5f01e5760168c6b9d6\"\n },\n {\n \"type\": \"regular cat1\",\n \"price\": 20000,\n \"limit\": 100,\n \"sold\": 100,\n \"until\": \"2024-09-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66cdae5f01e5760168c6b9d7\"\n },\n {\n \"type\": \"regular cat2\",\n \"price\": 20000,\n \"limit\": 100,\n \"sold\": 0,\n \"until\": \"2024-08-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66ce811fd90ac4d2a02d8dcb\"\n },\n {\n \"type\": \"regular cat3\",\n \"price\": 10000,\n \"limit\": 100,\n \"sold\": 0,\n \"until\": \"2024-08-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66ce811fd90ac4d2a02d8dcc\"\n }\n ],\n \"social_media\": {\n \"facebook\": \"https://facebook.com/jakartatechexpo\",\n \"twitter\": \"https://twitter.com/dhsahdusa\",\n \"instagram\": \"https://instagram.com/jakartatechexpo\",\n \"website\": \"https://jakartatechexpo.com\"\n },\n \"images\": null,\n \"created_at\": \"2024-08-27T10:37:12.933Z\",\n \"updated_at\": \"2024-08-28T01:50:22.794Z\",\n \"__v\": 0\n }\n}"}],"_postman_id":"50fdcfbc-46f7-44e6-96e4-7d7c95e906af"},{"name":"Create Event","id":"22f9f89d-f200-483b-aec0-43a2af7799b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Cimahi Expo\",\r\n \"description\": \"Rame pokoknya mah dateng yah\",\r\n \"date\": \"2026-07-21T21:21:58.183Z\",\r\n \"province\": \"Jawa Barat\",\r\n \"city\": \"Cimahi\",\r\n \"address\": \"Jl. dirgantara\",\r\n \"facebook\": \"https://facebook.com/jakartatechexpo\", // Optional\r\n \"twitter\": \"https://twitter.com/jakartatechexpo\", // Optional\r\n \"instagram\": \"https://instagram.com/jakartatechexpo\", // Optional\r\n \"website\": \"https://jakartatechexpo.com\" // Optional\r\n}","options":{"raw":{"language":"json"}}},"url":"/o/event","description":"Endpoint: POST /api/events/o
Creates a new event that will be owned by the currently logged in user.
Authorization: Required.
Endpoint: PUT /api/events/o/:id
Updates the logged in user's event details based on the event ID.
Authorization: Required.
URL Parameters:
\nid: id of the event
\n","urlObject":{"path":["event","o","66cdac5801e5760168c6b9d1"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"1c6a273f-322e-49e0-a946-e2f6ed4e3510","name":"Update Event","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n // chose field that just want to update \r\n \"name\": \"Cimahi Expo\", \r\n \"description\": \"Rame pokoknya mah dateng yah\", \r\n \"date\": \"2026-07-21T21:21:58.183Z\",\r\n \"province\": \"Jawa Barat\", \r\n \"city\": \"Cimahi Selatan\", \r\n \"address\": \"Jl. dirgantara\",\r\n \"facebook\": \"https://facebook.com/jakartatechexpo\", \r\n \"twitter\": \"https://twitter.com/dhsahdusa\", \r\n \"instagram\": \"https://instagram.com/jakartatechexpo\", \r\n \"website\": \"https://jakartatechexpo.com\" \r\n}","options":{"raw":{"language":"json"}}},"url":"/event/o/66cdac5801e5760168c6b9d1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"59"},{"key":"ETag","value":"W/\"3b-n8pQAa4r3w3J2euGrfw8BdmYuIk\""},{"key":"Date","value":"Wed, 28 Aug 2024 07:31:30 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Event updated successfully\"\n}"}],"_postman_id":"d9d5ca34-cb4c-424e-a447-0831861e8874"},{"name":"Add Event Images","id":"32c06a81-2070-4095-a476-2ecf88362617","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"event_images","type":"file","src":["/C:/Users/Baalee/Pictures/donors.png","/C:/Users/Baalee/Pictures/gambaran dede maika.jpeg","/C:/Users/Baalee/Pictures/p.png"]}]},"url":"/event/o/66cdac5801e5760168c6b9d1/image","description":"Endpoint: POST /api/events/o/:id/image
Uploads images for events owned by the logged in user.
Authorization: Required.
URL Parameters:
\nid: id of the event
\n","urlObject":{"path":["event","o","66cdac5801e5760168c6b9d1","image"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"ccae4f1c-657a-4b32-bc8e-8fbad80fcaca","name":"Add Event Images","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"event_images","type":"file","src":["/C:/Users/Baalee/Pictures/Untitled-1.png","/C:/Users/Baalee/Pictures/Untitled-2.png","/C:/Users/Baalee/Pictures/Untitled-3.png"]}]},"url":"/event/o/66cdac5801e5760168c6b9d1/image"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"67"},{"key":"ETag","value":"W/\"43-SmXNIeZpdoo3kTjSZiggkvukHQ8\""},{"key":"Date","value":"Wed, 28 Aug 2024 07:37:14 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Event images uploaded successfully\"\n}"}],"_postman_id":"32c06a81-2070-4095-a476-2ecf88362617"},{"name":"Delete Event Images","id":"98489e94-df69-41cd-87de-eaf0157be0ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"formdata","formdata":[{"key":"event_images","type":"file","src":["/C:/Users/Baalee/Pictures/donors.png","/C:/Users/Baalee/Pictures/gambaran dede maika.jpeg","/C:/Users/Baalee/Pictures/p.png"]}]},"url":"/event/o/66cdac5801e5760168c6b9d1/image/66bc85f2de0b3c124512b372-1723871103357-gambaran dede maika.jpeg","description":"Endpoint: DELETE /api/events/o/:id/image/:image_name
Removes images from events owned by the logged in user.
Authorization: Required.
URL Parameters:
\nid: id of the event
\nimage_name : image_name from event that you can get from fetching Endpoint: GET /api/events/o/:id
Endpoint: POST /api/events/o/:id/ticket_type
Add a ticket type for events owned by the currently logged in user.
Authorization: Required.
URL Parameters:
\nid : id of the event
\n","urlObject":{"path":["event","o","66cdac5801e5760168c6b9d1","ticket_type"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"2301c506-c2d2-4d4b-90d9-1887cb5fda92","name":"Add Event Ticket Type","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"[\r\n {\r\n \"type\": \"regular cat2\",\r\n \"price\": 20000,\r\n \"limit\": 100,\r\n \"until\": \"2024-08-20T12:00:00Z\",\r\n \"status\": \"open\"\r\n },\r\n {\r\n \"type\": \"regular cat3\",\r\n \"price\": 10000,\r\n \"limit\": 100,\r\n \"until\": \"2024-08-20T12:00:00Z\",\r\n \"status\": \"open\"\r\n }\r\n]\r\n","options":{"raw":{"language":"json"}}},"url":"/event/o/66cdac5801e5760168c6b9d1/ticket_type"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"70"},{"key":"ETag","value":"W/\"46-MX1stxpswtUweU3V8twK6zaWtOo\""},{"key":"Date","value":"Wed, 28 Aug 2024 01:45:03 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Event ticket types added successfully\"\n}"}],"_postman_id":"93266e24-b757-4c4d-80dd-db75dcf5d2d9"},{"name":"Update Event Ticket Type","id":"7b5de3f7-2e81-4c0f-b649-373d653af9ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n // chose field that just want to update \r\n // \"type\": \"regular cat1\",\r\n // \"price\": 20000,\r\n // \"limit\": 100,\r\n \"until\": \"2024-09-20T12:00:00Z\",\r\n \"status\": \"open\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/event/o/66cdac5801e5760168c6b9d1/ticket_type/66cdae5f01e5760168c6b9d6","description":"Endpoint: PUT /api/events/o/:id/ticket_type/:ticket_type_id
Updates the ticket type for an event owned by the currently logged in user.
Authorization: Required.
URL Parameters:
\nid: id of the event
\nticket_type_id : id of ticket_type from event that you can get from fetching Endpoint: GET /api/events/o/:id
Endpoint: POST /api/events/o/:id/checkedin
Checks in tickets for events owned by the currently logged in user.
Authorization: Required.
URL Parameters:
\nid: id of the event
\n","urlObject":{"path":["event","o","66cdac5801e5760168c6b9d1","checkedin"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"773c8451-64ba-4626-9450-7fe707811ef1","name":"Add Event Ticket Type Copy","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"barcode\" : \"3374-97169-1724830713419\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/event/o/66cdac5801e5760168c6b9d1/checkedin"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"345"},{"key":"ETag","value":"W/\"159-JeNlfiYcRBOpXa4/9MO257vAq/s\""},{"key":"Date","value":"Wed, 28 Aug 2024 07:42:03 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Ticket checked in successfully\",\n \"data\": {\n \"_id\": \"66ced3f934163ababaca486c\",\n \"event_id\": \"66cdac5801e5760168c6b9d1\",\n \"user_id\": \"66bc85f2de0b3c124512b372\",\n \"ticket_type_id\": \"66cdae5f01e5760168c6b9d6\",\n \"barcode\": \"3374-97169-1724830713419\",\n \"status\": \"checked-in\",\n \"price\": 20000,\n \"created_at\": \"2024-08-28T07:38:33.419Z\",\n \"__v\": 0\n }\n}"}],"_postman_id":"6c0d793c-3176-47b4-9038-196af166e26b"}],"id":"da7ea42e-cf3a-4ee7-80fb-a6989ac4039f","_postman_id":"da7ea42e-cf3a-4ee7-80fb-a6989ac4039f","description":""},{"name":"As an Buyer Ticket","item":[{"name":"Get All Event","id":"1ca08f80-40e3-4630-9aa0-ad20a898a062","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"method":"GET","header":[{"key":"Authorization","value":"","type":"text"},{"key":"x-api-key","value":"","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"/event?city=Cimahi&minPrice=10000&maxPrice=50000&month=2024-09&page=1&limit=15","description":"Endpoint: GET /api/events
Gets a list of all publicly available events.
Authorization: Not required.
Query Parameters:
\ncity=Cimahi:
month=2024-09:
page=1:
limit=15:
minPrice=10000&maxPrice=50000:
search=concert:
Default Behavior:
\nMonth:
\nmonth parameter is not specified, the system defaults to the current month, meaning it will display events that start within the current month.Limit:
\nlimit parameter is not specified, the system defaults to displaying 15 events per page. This controls how many events are shown in the search results on each page.Price Range:
\nminPrice and maxPrice are not specified, the system may default to displaying events regardless of ticket price, depending on the implementation.Search Query:
\nsearch parameter is not specified, the system will return all events that match the other specified filters without performing any text search.Endpoint: GET /api/events/:id
Get event details by ID for publicly available events.
Authorization: Not required
URL Parameters:
\nid : id of the event
\n","urlObject":{"path":["event","66c02cbd3c0bbad15fdcbf2c"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"6adc8903-73b0-4633-8b86-a68909f98140","name":"Get Event by Id","originalRequest":{"method":"GET","header":[],"url":"/event/66cdac5801e5760168c6b9d1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1452"},{"key":"ETag","value":"W/\"5ac-LFoFYIWB7KT5qllqpqymvo2ANyg\""},{"key":"Date","value":"Wed, 28 Aug 2024 07:42:55 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Event fetched successfully\",\n \"data\": {\n \"_id\": \"66cdac5801e5760168c6b9d1\",\n \"name\": \"Cimahi Expo\",\n \"description\": \"Rame pokoknya mah dateng yah\",\n \"date\": \"2024-08-28T07:31:30.129Z\",\n \"location\": {\n \"province\": \"Jawa Barat\",\n \"city\": \"Cimahi Selatan\",\n \"address\": \"Jl. dirgantara\"\n },\n \"organizer\": {\n \"name\": {\n \"first_name\": \"iqbal anjay\",\n \"last_name\": \"anshori123\"\n },\n \"_id\": \"66bc85f2de0b3c124512b372\",\n \"email\": \"iqbal111@gmail.com\",\n \"profile_picture\": null\n },\n \"ticket_types\": [\n {\n \"type\": \"regular cat2\",\n \"price\": 20000,\n \"limit\": 100,\n \"sold\": 5,\n \"until\": \"2024-09-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66cdae5f01e5760168c6b9d6\"\n },\n {\n \"type\": \"regular cat1\",\n \"price\": 20000,\n \"limit\": 100,\n \"sold\": 100,\n \"until\": \"2024-09-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66cdae5f01e5760168c6b9d7\"\n },\n {\n \"type\": \"regular cat2\",\n \"price\": 20000,\n \"limit\": 100,\n \"sold\": 0,\n \"until\": \"2024-08-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66ce811fd90ac4d2a02d8dcb\"\n },\n {\n \"type\": \"regular cat3\",\n \"price\": 10000,\n \"limit\": 100,\n \"sold\": 0,\n \"until\": \"2024-08-20T12:00:00.000Z\",\n \"status\": \"open\",\n \"_id\": \"66ce811fd90ac4d2a02d8dcc\"\n }\n ],\n \"social_media\": {\n \"facebook\": \"https://facebook.com/jakartatechexpo\",\n \"twitter\": \"https://twitter.com/dhsahdusa\",\n \"instagram\": \"https://instagram.com/jakartatechexpo\",\n \"website\": \"https://jakartatechexpo.com\"\n },\n \"images\": [\n \"66bc85f2de0b3c124512b372-1724830634908-Untitled-2.png\",\n \"66bc85f2de0b3c124512b372-1724830634912-Untitled-3.png\"\n ],\n \"created_at\": \"2024-08-27T10:37:12.933Z\",\n \"updated_at\": \"2024-08-28T07:37:44.909Z\",\n \"__v\": 1\n }\n}"}],"_postman_id":"d09613f4-6e44-4b31-9d33-796d1c320108"},{"name":"Buy Event Ticket / Create Transaction","id":"43ab87c6-def3-4a21-9b19-7bcb4394d55c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"payment_type\": \"bank_transfer\",\r\n \"bank_name\": \"bca\"\r\n}","options":{"raw":{"language":"json"}}},"url":"/event/66cdac5801e5760168c6b9d1/buy_ticket/66cdae5f01e5760168c6b9d6","description":"Endpoint: POST /api/events/:id/buy_ticket/:ticket_type_id
Purchase tickets for events that are available to the public.
Authorization: Required.
URL Parameters:
\nid: id of the event
\nticket_type_id : id of ticket_type from event that you can get from fetching Endpoint: GET /api/events/:id
Payment Method Details
\nCurrent Payment Support: The endpoint supports only bank transfer payments.
\nSupported Banks: Payments can be made through the following banks:
\nBank Central Asia (BCA)
\nBank Negara Indonesia (BNI)
\nBank Rakyat Indonesia (BRI)
\nCIMB Niaga
\npayment_type: Specifies the method of payment. Currently, only bank_transfer is supported.
bank_name: Indicates the bank through which the transfer will be made. Supported banks are:
bca (Bank Central Asia)
bni (Bank Negara Indonesia)
bri (Bank Rakyat Indonesia)
cimb (CIMB Niaga)
Route for Ticket Buyers
\n","_postman_id":"39bce75e-ecb1-4b71-b1a4-7dc4e016b3a9"}],"id":"03e2af0b-a4bb-4999-bb4e-449daa0c754f","description":"This API route provides endpoints for event owners and ticket buyers. Event owners can manage their events, including creating, updating, deleting, and adding ticket types. Ticket buyers can view available events, purchase tickets, and check-in. All endpoints that require authentication use a JWT access token which must be included in the Authorization header on each request.
\n","_postman_id":"03e2af0b-a4bb-4999-bb4e-449daa0c754f"},{"name":"Transaction","item":[{"name":"Get User Transaction","id":"7dd419c3-1c66-419b-a6ac-41e6f6c073b7","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"/transaction?from=2024-07-01","description":"Endpoint: GET /api/transactions/
Gets a list of all transactions made by the currently logged in user.
Authorization: Required.
Query Parameters:
\nfrom=2024-07-01:
Purpose: This parameter sets the start date for the date range filter.
\nDescription: The query will include transactions that occurred on or after July 1, 2024. This allows you to filter transactions that fall within a specific time period starting from this date.
\nto=2024-09-15:
Purpose: This parameter sets the end date for the date range filter.
\nDescription: The query will include transactions that occurred on or before September 15, 2024. This parameter helps to specify the end boundary for the date range, ensuring that only transactions within this period are retrieved.
\nstatus=all:
Purpose: This parameter determines the status filter for transactions.
\nDescription: Setting the status parameter to all means that the query will not filter transactions based on their status. It will include transactions of any status, regardless of whether they are pending, completed, cancelled, or any other status. The all value includes all possible statuses, providing a comprehensive view of all transactions without status-based exclusions.
Details: For more information on the different transaction statuses, you can refer to the Midtrans documentation on transaction statuses. This includes detailed descriptions of various statuses such as capture, settlement, pending, deny, cancel, expire, failure, refund, partial_refund, and authorize. Each status represents a different stage or outcome of the transaction process.
Default Behavior:
\nDate Range Filter:
\nfrom and to parameters are not specified, the system defaults to a date range that covers the last 30 days from today. This ensures that only recent transactions are considered in the query.Status Filter:
\nstatus is not specified, the default behavior is to include all transactions, similar to setting status=all. This provides a full overview of transactions without filtering based on their status.When you make a purchase through the /api/events/:id/buy_ticket/:ticket_type_id endpoint, the payment_details in the response will provide information about the payment transaction. The content and format of payment_details can vary depending on the bank and payment type used.
Handle transaction notifications received from Midtrans regarding changes in payment status.
\n","urlObject":{"path":["transaction","handlingNotification"],"host":[""],"query":[],"variable":[]}},"response":[],"_postman_id":"56972771-85d3-42c7-88c0-46723da81798"}],"id":"f477ace6-af8b-4742-97c2-44f02ca17c9a","_postman_id":"f477ace6-af8b-4742-97c2-44f02ca17c9a","description":""},{"name":"Ticket","item":[{"name":"Get User Ticket","id":"8dd7383b-a61c-4564-8ef9-f610ab47e32a","protocolProfileBehavior":{"disableBodyPruning":true,"strictSSL":false},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"/ticket?status=purchased&from=2024-08-01&to=2024-08-31&search=concert&page=1&limit=10","description":"Endpoint: GET /api/tickets/
Description: Gets a list of all tickets owned by the currently logged in user.
Authorization: Required
Query Parameters:
\nstatus=purchased:
from=2024-08-01&to=2024-08-31:
search=concert:
page=1&limit=10:
Statuses That Can Be Used:
\npending:
Tickets in this status indicate that the transaction has been initiated, but the payment has not yet been completed by the customer.
\nThe customer might be in the process of making a payment through Bank Transfer, E-Wallet, or other payment methods.
\npurchased:
This status indicates that the payment has been successfully completed, and the ticket has been purchased.
\nThe customer now owns the ticket and can use it for entry into the event.
\nchecked-in:
Usage in Queries:
\nstatus=pending:
status=purchased:
status=checked-in:
Default Behavior:
\nDate Range:
\nfrom and to are not specified, the system defaults to a range starting 30 days before the current date up to today.Status:
\nstatus is not specified, it defaults to all, meaning it will include tickets of any status (e.g., pending, purchased, checked-in).Endpoint:GET /api/tickets/:id
Get specific details of a ticket based on the ticket ID, accessible only to the ticket owner.
Authorization: Required.
Tickets purchased by users to attend certain events. Each ticket has information such as ticket type, event name, and attendance status (checked-in or not).
\n","_postman_id":"341107f2-42a1-44ce-b2b1-6ea295e7bd34"},{"name":"ErrorHandler","item":[],"id":"e00e8462-47dd-4c8e-a33a-f3ae5dea3094","description":"The error handling mechanism is designed to manage and respond to errors occurring during request processing. It categorizes errors into client and server errors, providing appropriate responses based on the nature of the error.
\n1.Client Errors:
\nmessages are present:Response: A detailed error response will be provided containing multiple messages.
\n{\n \"status\": \"error\",\n \"name\": \"ClientError\",\n \"messages\": [\n \"Error message 1\",\n \"Error message 2\",\n ...\n ]\n}\n\nExplanation: This response is used when there are multiple validation errors or issues with the request that need to be communicated in detail.
\nmessage is a single string:Response: A simpler error response with a single message.
\n{\n \"status\": \"error\",\n \"name\": \"ClientError\",\n\n \"message\": \"Error message\"\n}\n\n\nExplanation: This response is used for more straightforward issues where only a single message needs to be communicated.
\n2.Server Errors:
\nResponse: An error response indicating that an issue occurred on the server.
\n{\n \"status\": \"error\",\n \"name\": \"Server Error\",\n \"message\": \"An unexpected error occurred on the server.\"\n}\n\n\nExplanation: This response is used for unexpected errors on the server side, such as issues with server resources or configuration problems.
\nClient Errors:
\nThese errors typically arise from issues in the request made by the client. Examples include invalid form submissions, missing required fields, or data validation errors.
\nDetailed Messages: Used when multiple errors need to be communicated, such as in the case of form validation errors where multiple fields may be incorrect.
\nServer Errors:
\nThese errors indicate that something went wrong on the server side. This could include errors due to unhandled exceptions, database issues, or server misconfigurations.
\nSingle Message: Used to communicate a general server issue when the specific details are less critical or not available.
\n