API Playground - Test Live APIs

Interactive API Testing • Execute Real Calls • See Live Responses

This is your interactive API playground where you can test all MAHATI APIs with real JWT tokens and see live responses.

🎯 How to Use This API Playground

1️⃣ Get Your JWT Token

First, authenticate to get your access token:

1. Find "Auth Service" section above
2. Click POST /prisma/api/auth/login
3. Click "Try it out"
4. Enter your credentials in the request body:

   {
     "username": "your-email@example.com",
     "password": "your-password"
   }
   

5. Click "Execute"
6. Copy the token value from the response

2️⃣ Authorize All API Calls

1. Click the 🔒 Authorize button at the top
2. Enter your token in this exact format:

   Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
   

3. Click "Authorize" then "Close"

3️⃣ Test Any API Endpoint

Now you can test any API: 1. Choose any service (Admin, Billing, Claims, etc.) 2. Click on any endpoint (GET, POST, PUT, DELETE) 3. Click "Try it out" 4. Fill in parameters if needed 5. Click "Execute" 6. See the live response instantly! 🚀

🔧 Available Services for Testing

💻 Example API Tests You Can Run

Login and Get Token

POST /prisma/api/auth/login
Content-Type: application/json

{
  "username": "developer@mahati.com",
  "password": "dev123"
}

Get User List

GET /api/admin/users
Authorization: Bearer your-jwt-token

Upload a File

POST /api/documents/upload
Authorization: Bearer your-jwt-token
Content-Type: multipart/form-data

Process Insurance Claim

POST /api/claims/submit
Authorization: Bearer your-jwt-token
Content-Type: application/json

{
  "policyNumber": "POL-2025-001",
  "claimAmount": 5000.00,
  "incidentDate": "2025-12-09",
  "description": "Vehicle accident claim"
}

Create Billing Invoice

POST /api/billing/invoices
Authorization: Bearer your-jwt-token
Content-Type: application/json

{
  "customerId": "CUST-001",
  "amount": 1500.00,
  "description": "Insurance premium",
  "dueDate": "2025-12-31"
}

✅ What You Can Test Here

🔍 All HTTP Methods

• GET - Retrieve data (users, policies, claims)
• POST - Create new records (login, upload, submit)
• PUT - Update existing data (profiles, settings)
• DELETE - Remove records (files, users)

🔐 Authentication Testing

• JWT Bearer token authentication
• Token validation and expiry
• Protected endpoint access
• Permission-based operations

📁 File Operations

• File upload with multipart/form-data
• Document download and retrieval
• Image and PDF handling
• Binary data processing

💾 Data Operations

• JSON request/response handling
• Form data submission
• Query parameter filtering
• Pagination and sorting

🎯 Success Indicators

When your API calls work correctly, you'll see: - ✅ Status: 200-299 (Success codes) - ✅ Response Time (e.g., "145ms") - ✅ JSON Response Data (Properly formatted) - ✅ Response Headers (Content-Type, etc.)

⚠️ Troubleshooting

Common Issues and Solutions

🔴 401 Unauthorized - Check JWT token format: Must start with Bearer - Ensure token hasn't expired - Verify login credentials are correct

🔴 404 Not Found - Verify API service is running on correct port - Check endpoint URL spelling - Confirm service is accessible

🔴 CORS Policy Error - API services need CORS headers - Contact admin to whitelist your domain - May need proxy configuration

🔴 Network Connection Failed - Ensure services are running locally - Check firewall settings - Verify port accessibility