UniShare Backend
API Status: Operational
Welcome to UniShare API
Complete API documentation for the UniShare platform
9
API Modules
50+
Endpoints
3
Access Levels
100%
Uptime
Public APIs
GET /api/notice - View active notices
GET /api/announcements - Browse announcements
GET /api/announcements/:id - Get specific announcement
GET /api/contacts - View emergency contacts
GET /api/contacts/search/:term - Search contacts
GET /api/resources - Browse academic resources
GET /api/rooms - Browse available rooms
GET /api/itemsell - Browse items for sale
GET /api/ticketsell - Browse tickets for sale
GET /api/shareride - Browse available rides
GET /api/lostfound - Browse lost & found items
User APIs
Resources Management
GET /api/resources/my - My resources
POST /api/resources/suggest - Suggest resource
PUT /api/resources/my/:id - Update resource
DELETE /api/resources/my/:id - Delete resource
Room Listings
GET /api/rooms/mine - My room listings
POST /api/rooms - Create room listing
PUT /api/rooms/:id - Update room listing
DELETE /api/rooms/:id - Delete room listing
Item Selling
GET /api/itemsell/mine - My items for sale
POST /api/itemsell - Create item listing
PUT /api/itemsell/:id - Update item
DELETE /api/itemsell/:id - Delete item
Ride Sharing
GET /api/shareride/my - My ride offers
POST /api/shareride/create - Create ride offer
POST /api/shareride/:id/request - Request ride
PUT /api/shareride/requests/:id/respond - Respond to request
PATCH /api/shareride/:id - Update specific fields of posted ride
Lost & Found
GET /api/lostfound/my - My lost/found posts
POST /api/lostfound/create - Report item
POST /api/lostfound/:id/contact - Contact about item
Admin APIs
Full CRUD operations on all modules:
GET /admin/announcements - Manage announcements
GET /admin/contacts - Manage contacts
GET /admin/itemsell - Manage items
GET /admin/lostfound - Manage lost/found
GET /admin/notice - Manage notices
GET /admin/resources - Manage resources
GET /admin/rooms - Manage rooms
GET /admin/shareride - Manage rides
GET /admin/ticketsell - Manage tickets
Authentication
POST /auth/login - User login
POST /auth/register - User registration
POST /auth/logout - User logout
GET /auth/profile - Get user profile