Node.js Result API & Webhooks

Result API & Webhook Platform (Node.js)

## 1. Project Overview

We need to develop a **single-page web platform** similar in concept and flow to:
(https://matka-api.com/)

The system will allow users to **subscribe to market result APIs**, configure **webhooks**, and receive **selected game results automatically**.
The backend must be built in **Node.js**, with a clean admin panel and secure API architecture.

---

## 2. Technology Stack (Mandatory)

* **Backend:** Node.js (Express.js)
* **Frontend:** Single Page Application (React / Vue / HTML + JS – open for suggestion)
* **Database:** MySQL or MongoDB
* **Authentication:** JWT-based
* **Webhook System:** Custom-built
* **Hosting:** Linux server (API-ready)
---

## 3. User Dashboard (Frontend)

### 3.1 User Authentication

* User Registration
* User Login
* Secure session handling

---

### 3.2 User Dashboard (Main Screen)

1. **Dashboard**

* Plan expiry date & time
* User API Key (auto-generated)
* API usage information

2. **Postman Collection**

* Downloadable Postman collection link
* Includes all available API endpoints

---

### 3.3 Maharashtra Market

* Input field to **add / update webhook URL**
* Below that:

* List of all available games
* Checkbox-based selection
* User can choose **which game results** they want
* Only selected game results should be:

* Sent to user’s webhook
* Available via API

---

### 3.4 Delhi Market

* Same functionality as Maharashtra Market:

* Webhook URL input
* Game selection list
* Result delivery only for selected games

---

### 3.5 Market Result

* User can:

* View live and historical market results
* Filter by market (Maharashtra / Delhi)
* Filter by game

---

### 3.6 Plan Purchase

* User can purchase plans:

* Demo
* Monthly
* 3 Months
* 6 Months
* 1 Year
* **Payment Method:**

* Paytm UPI QR Code–based payment
* After payment:

* Admin approval OR auto-activation (configurable)
* Plan expiry auto-calculated

---

## 4. Admin Dashboard

### 4.1 Dashboard Analytics

* Total Users
* Active Users
* Inactive Users
* Active Plan Users
* Expired Plan Users

---

### 4.2 User Management

* User list
* Activate / Deactivate user
* Edit user details
* Delete user
* Change user password
* Add new user (simple form)

---

### 4.3 Maharashtra Market Management

* Add new game
* Delete game
* Game list view

---

### 4.4 Delhi Market Management

* Add new game
* Delete game
* Game list view

---

### 4.5 Plan Management

* Create & manage 5 plans:

* Demo
* Monthly
* 3 Months
* 6 Months
* 1 Year
* Set:

* Price
* Duration
* API access limits

---

### 4.6 Purchase List

* View all purchases
* User name
* Plan name
* Purchase date & time
* Status (Pending / Approved / Active)

---

### 4.7 Market Result Management

* Add market results manually
* View result list
* Assign results to:

* Maharashtra games
* Delhi games

---

### 4.8 Settings

* Admin password change
* Paytm UPI ID / QR configuration
* Merchant key settings

---

## 5. Core Business Logic (MOST IMPORTANT)

### 5.1 Central Webhook System (Core Feature)

* The system will receive **game results via internal webhook/API**
* On receiving a result:

1. Save result in the database
2. Identify subscribed users
3. Check:

* Active plan
* Selected market
* Selected games
4. Send result to:

* User’s webhook URL
* User’s API endpoint

---

### 5.2 User Result Delivery

* Each user will receive:

* Only selected game results
* Only for active plans
* Retry mechanism for failed webhooks
* Webhook logs (success / failure)

---

## 6. APIs Required

* Authentication APIs
* Market Result APIs
* Webhook delivery APIs
* User result fetch APIs
---

## 7. Security & Quality Requirements

* Secure API key generation
* Rate limiting
* Input validation
* Webhook signature verification
* Clean and documented code
* Proper error handling

---

## 8. Deliverables

* Complete source code
* Database schema
* Postman collection
* Deployment guide
* Basic documentation

---

## 9. Notes

* The webhook system is the **main and most critical feature**
* Performance and reliability are very important
* The project must be scalable for future markets

---

## 10. Timeline & Communication

* Clear milestones
* Regular progress updates
* Testing before final delivery