Overview
OnDelivery API (OSAS - OnDelivery Smart Agent System) is a comprehensive multi-courier shipping logistics platform built with Node.js. The system enables:
- Multi-courier aggregation - Integrate and manage multiple shipping partners (JNE, Lion Parcel, JT Cargo, AnteRaja, etc.)
- Real-time package tracking - Track shipments from pickup to delivery
- Dynamic pricing - Calculate shipping fees based on origin, destination, weight, and service type
- Warehouse operations - Manage scanning, manifesting, handovers, and quality control
- Financial management - Handle billing, commissions, and VIP customer pricing
- Driver mobile app - Support delivery drivers with marketplace integration
- Marketplace integration - Connect with multiple e-commerce platforms
Project Name: ondelivery-api
Version: 1.0.0
Main Entry Point: ondeliv-backend.js
Default Port: 4220
License: ISC
Architecture & Technology Stack
Core Technologies
| Technology | Version | Purpose |
|---|---|---|
| Node.js | - | Runtime environment |
| Express.js | 5.2.1 | Web application framework |
| PostgreSQL | - | Primary database (dual setup: OSAS + ONMART) |
| Sequelize | 6.37.7 | ORM for database operations |
Key Dependencies
Authentication & Security:
-
jsonwebtoken(9.0.2) - JWT token generation and verification -
passport(0.7.0) - Authentication middleware -
passport-http(0.3.0) - HTTP Basic authentication -
bcryptjs(3.0.3) - Password hashing -
helmet(8.1.0) - Security headers -
express-rate-limit(8.2.1) - Rate limiting protection
Data Validation & Processing:
-
ajv(8.17.1) - JSON schema validation -
ajv-formats(3.0.1) - Additional format validators -
ajv-keywords(5.1.0) - Extended validation keywords
HTTP & External APIs:
-
axios(1.13.2) - HTTP client for external API calls -
cors(2.8.5) - Cross-origin resource sharing
File Processing:
-
multer(2.0.2) - File upload handling -
sharp(0.34.5) - Image processing and optimization -
exceljs(4.4.0) - Excel file generation -
pdfmake(0.2.20) - PDF document generation -
xlsx(0.20.3) - Excel file parsing
Utilities:
-
moment(2.30.1) /dayjs(1.11.19) - Date/time manipulation -
lodash(4.17.21) - Utility functions -
node-cron(4.2.1) - Scheduled tasks -
nodemailer(7.0.11) - Email sending -
nanoid(5.1.6) - Unique ID generation -
morgan(1.10.1) - HTTP request logging -
cli-color(2.0.4) - Colorized console output