🌐 Base URL

Production: https://api.pharmnow.health/api/v1
Development: http://localhost:8000/api/v1

🚀 API Modules

🔐 Authentication
Complete user authentication system with registration, login, email verification, and password recovery.
POST

Endpoints: /auth/register, /auth/login, /auth/verify-email, /auth/forgot-password, /auth/reset-password
👥 User Management
User profiles, favorites, blocking, orders history, and dashboard analytics.
GET POST PUT DELETE

Endpoints: /users/*, /users/profile/*, /users/favourites/*, /users/orders, /users/dashboard/*
🏪 Pharmacy Management
Pharmacy profiles, product management, order handling, and business analytics.
GET POST PUT DELETE

Endpoints: /pharmacies/*, /pharmacies/products/*, /pharmacies/dashboard/*, /pharmacies/search
💊 Product Management
Product catalog, search, categories, inventory management, and featured products.
GET POST PUT DELETE

Endpoints: /products/*, /products/search, /products/categories, /products/featured
🛒 Order System
Complete order lifecycle management with status tracking, reviews, and payment integration.
GET POST PUT

Endpoints: /orders/*, /orders/my-orders, /orders/pharmacy-orders, /orders/*/status, /orders/*/review
💬 Messaging System
Real-time messaging between users and pharmacies with text, image, and voice support.
GET POST PUT DELETE

Endpoints: /messages/*, /messages/conversations, /messages/search, /messages/media
🔔 Notifications
Push notifications, system alerts, order updates, and promotional messaging.
GET POST PUT DELETE

Endpoints: /notifications/*, /notifications/unread-count, /notifications/stats
📊 Analytics & Reports
Business intelligence, sales analytics, user behavior, and performance metrics.
GET

Endpoints: /*/stats, /*/dashboard/*, /*/analytics

✨ Key Features

🔒
Secure Authentication
JWT-based auth with role-based access control
🎯
Advanced Search
Full-text search with filters and geolocation
📱
Real-time Messaging
Text, image, and voice messaging support
🛡️
User Blocking
Comprehensive blocking system for safety
📊
Analytics Dashboard
Business insights and performance metrics
🔔
Smart Notifications
Event-driven notifications and alerts

🛠️ Technology Stack

Node.js
Express.js
TypeScript
MongoDB
Mongoose
JWT
bcrypt
Express Validator
Socket.io Ready

📋 API Standards

📝
Consistent Responses
Standardized response format across all endpoints
⚡
Optimized Performance
Database indexing and query optimization
🔍
Input Validation
Comprehensive validation and sanitization
📄
Pagination Support
Efficient data pagination for all list endpoints

🔗 Quick Start

Authentication Required

Most endpoints require authentication. Include the JWT token in the Authorization header:

Authorization: Bearer <your_jwt_token>

Response Format

All responses follow a consistent format:

{
  "message": "Operation description",
  "payload": { /* response data */ }
}

📞 Support & Documentation

Need Help?

For detailed API documentation, examples, and support:

📧 isaacolorunfemi330@gmail.com
🐙 https://github.com/TEE2DWHY/api-pharmnow