My Social Networks API is a RESTful API designed to manage the core features of a social networking platform.
It allows users to register and authenticate, create and join groups, organize events, participate in discussions, share photos, create polls, and manage ticketing for public events.
The API follows REST principles and uses standard HTTP methods and status codes.
Authentication is handled using JSON Web Tokens (JWT) to secure protected routes.
User authentication (register / login)
\nUser profile management
\nGroups creation and membership management
\nEvents creation and participation
\nDiscussion threads with messages and replies
\nPhoto albums linked to events
\nPolls creation and participation
\nTicketing system for public events
\nCreate a new user account.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","auth","register"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"5fbcb78c-bdd1-4147-a92b-f06d7306ed94"},{"name":"/auth/login","id":"cd264a47-6c0a-40dd-bcd2-8b0a90c51b6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"email\": \"zain@test.com\",\n \"password\": \"password123\"\n}\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/v1/auth/login","description":"Authenticate a user and receive a JWT token.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","auth","login"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"cd264a47-6c0a-40dd-bcd2-8b0a90c51b6a"}],"id":"c80ffe5f-6a98-4b63-a89b-9a01d461ec03","description":"This section covers user authentication, including account registration and login, and provides JSON Web Tokens (JWT) required to access protected endpoints of the API.
\n","_postman_id":"c80ffe5f-6a98-4b63-a89b-9a01d461ec03"},{"name":"2. Utilisateurs","item":[{"name":"/users/{user_id}","id":"9711bd2b-a6c8-44f0-97bd-89567a0dd44b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get a specific user by their ID.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","users","6985e5979b09d35b4e96031a"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"9711bd2b-a6c8-44f0-97bd-89567a0dd44b"},{"name":"/me","id":"d26463a1-61a2-484c-8a09-c729f1442110","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get the authenticated user.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","me"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"d26463a1-61a2-484c-8a09-c729f1442110"}],"id":"72ad1500-b1da-4ee0-8025-2e294c3329c9","description":"Routes for managing users.
\n","_postman_id":"72ad1500-b1da-4ee0-8025-2e294c3329c9"},{"name":"3. Groupes","item":[{"name":"/groups","id":"10da7aff-1995-4380-adb7-d776f003f0b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Create a new group (requires auth). The creator becomes the first admin/member.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","groups"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"10da7aff-1995-4380-adb7-d776f003f0b2"},{"name":"/groups/{group_id}","id":"9c2484e5-35b5-4143-906d-25c3a1a34b01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get detailed information for a specific group.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","groups","6985c47d9b09d35b4e9602ec"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"9c2484e5-35b5-4143-906d-25c3a1a34b01"}],"id":"ea047ebb-7eda-4486-a75e-e92182531a11","description":"Routes for managing groups
\n","_postman_id":"ea047ebb-7eda-4486-a75e-e92182531a11"},{"name":"4. Evénements","item":[{"name":"/events","id":"04cf79c9-e444-4f06-a8ea-2336489c5ec8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Create a new event.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","events"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"04cf79c9-e444-4f06-a8ea-2336489c5ec8"},{"name":"/events/{event_id}","id":"2b8f91c4-06d0-4be9-a2a9-c06138422c54","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get detailed information for a specific event.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","events","6985c5519b09d35b4e9602ef"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"2b8f91c4-06d0-4be9-a2a9-c06138422c54"}],"id":"ea01eb60-54ed-4881-b842-710129968e48","description":"Routes for creating, managing, and participating in events.
\n","_postman_id":"ea01eb60-54ed-4881-b842-710129968e48"},{"name":"5. Threads","item":[{"name":"/threads","id":"b3cc376c-8760-41f2-a9ea-b99627bae85e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Create a new thread for a specified event.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","threads"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"b3cc376c-8760-41f2-a9ea-b99627bae85e"},{"name":"/threads/{thread_id}/messages","id":"a92d60cf-43e1-4b30-afc0-c35c0b7b7d89","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Send a message in a specified thread.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","threads","6985c6069b09d35b4e9602f2","messages"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"a92d60cf-43e1-4b30-afc0-c35c0b7b7d89"},{"name":"/threads/{thread_id}/messages/{message_id}/replies","id":"59cc04bc-6597-40bd-bd59-aaa951df3439","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Reply to a specfied message in a thread.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","threads","6985c6069b09d35b4e9602f2","messages","6985c64c9b09d35b4e9602f5","replies"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"59cc04bc-6597-40bd-bd59-aaa951df3439"}],"id":"d13f66ca-792d-4890-8596-c8d96c82f6b0","description":"Routes for interacting with event discussion threads and managing messages.
\n","_postman_id":"d13f66ca-792d-4890-8596-c8d96c82f6b0"},{"name":"6. Albums","item":[{"name":"/albums","id":"07fda685-b1d8-460e-b6d2-bcc431de6774","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Create a new albums for an event.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","albums"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"07fda685-b1d8-460e-b6d2-bcc431de6774"},{"name":"/albums/{album_id}/photos","id":"f33cec15-7a1d-41e1-b885-e4a39790ea6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Post a new photo in a specified album.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","albums","6985c95a9b09d35b4e9602fd","photos"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f33cec15-7a1d-41e1-b885-e4a39790ea6a"},{"name":"/albums/{album_id}/photos/{photo_id}/comments","id":"634b9736-0c5f-4dfe-b48c-32a88041a018","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Add a comment to a photo.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","albums","6985c95a9b09d35b4e9602fd","photos","6985ca5f9b09d35b4e960300","comments"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"634b9736-0c5f-4dfe-b48c-32a88041a018"}],"id":"95b98d41-e17c-4b2f-948f-e43532451091","description":"Routes for managing event photo albums, uploading photos, and commenting.
\n","_postman_id":"95b98d41-e17c-4b2f-948f-e43532451091"},{"name":"7. Polls","item":[{"name":"/polls","id":"c90a1b87-be3a-4cf1-82f9-34b53d86e431","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Create a new poll.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","polls"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"c90a1b87-be3a-4cf1-82f9-34b53d86e431"},{"name":"/polls/{poll_id}/answer","id":"da52c0ba-24a3-4d18-af88-1a6cad24e19a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Submit a vote for a poll.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","polls","6985cb6a9b09d35b4e960307","answer"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"da52c0ba-24a3-4d18-af88-1a6cad24e19a"}],"id":"84f9ff2f-a8de-4f6e-a591-61bb3da1dba3","description":"Routes for creating, managing, and participating in event polls.
\n","_postman_id":"84f9ff2f-a8de-4f6e-a591-61bb3da1dba3"},{"name":"8. Tickets","item":[{"name":"/tickets/types","id":"8f882671-aa0c-4629-8cca-c99b4bb2cb30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Add a specified amount of tickets for an event.
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","tickets","types"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"8f882671-aa0c-4629-8cca-c99b4bb2cb30"},{"name":"tickets/buy","id":"6c7ad6df-c4fa-4c8d-b554-d1da8d1ab295","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"event\": \"6985c5519b09d35b4e9602ef\",\n \"ticketType\": \"6985cdee9b09d35b4e960311\",\n \"buyer\": {\n \"firstname\": \"Jean\",\n \"lastname\": \"Dupont\",\n \"address\": \"10 rue de Paris\"\n }\n}\n"},"url":"http://localhost:3000/api/v1/tickets/buy","description":"Purchase a ticket (no need to be authenticated).
\n","urlObject":{"protocol":"http","port":"3000","path":["api","v1","tickets","buy"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"6c7ad6df-c4fa-4c8d-b554-d1da8d1ab295"}],"id":"19a787ab-505a-4575-b31e-9e7b92d1a461","description":"Route for managing event ticket type and purchasing tickets.
\n","_postman_id":"19a787ab-505a-4575-b31e-9e7b92d1a461"}]}