Developer Troubleshooting Guide
Comprehensive debugging workflows and error analysis techniques
GuidesAll Levels• 25 min read
Quick Error Debugging Checklist
Follow these 6 steps to systematically debug any error in ModernAPI
1
Get Request ID
Find requestId from error response
2
Identify Error Category
Check HTTP status code
3
Search Logs
Use requestId to find exact error
4
Check Context
Look for related log entries
5
Investigate Root Cause
Analyze business logic and data
6
Apply Fix
Implement solution and test
HTTP Status Code Categories
Understand what each error category means and how to approach debugging
400
Bad Request
Client ErrorRequest format issues or business rule violations
Action: Check request format, validation rules, and business constraints
Common Examples:
- Validation errors (missing required fields)
- Business rule violations (USER_NOT_ACTIVE)
- Invalid data format or types
401
Unauthorized
AuthenticationAuthentication issues with JWT tokens or user permissions
Action: Check JWT token validity, expiration, and user permissions
Common Examples:
- Expired JWT token
- Invalid token signature
- Missing authorization header
404
Resource Not Found
Not FoundRequested resource does not exist or user lacks access
Action: Verify resource exists, check IDs, and confirm user permissions
Common Examples:
- Incorrect GUID format
- Resource was deleted
- Permission-based hiding
409
Business Constraint
ConflictBusiness rules prevent the operation from completing
Action: Check business rules, existing data, and constraint violations
Common Examples:
- Duplicate SKU or email
- Inventory constraints
- State transition rules
500
Internal Error
Server ErrorUnexpected server-side errors requiring investigation
Action: Check logs immediately, fix code issues, and monitor system health
Common Examples:
- Unhandled exceptions
- Database connection issues
- Configuration problems