Usage Examples
Endpoint Mapping
from scripts.endpoint_mapper import EndpointMapper
mapper = EndpointMapper()
endpoints = mapper.analyze_fastapi_code("""
@app.get('/users/{id}')
@app.post('/users')
""")
print(f"Found {len(endpoints)} endpoints")
Schema Validation
from scripts.schema_validator import SchemaValidator
validator = SchemaValidator()
result = validator.validate_json_schema({
"type": "object",
"properties": {"name": {"type": "string"}}
})
print(f"Valid: {result['is_valid']}")
Authentication Detection
from scripts.auth_handler import AuthHandler
auth = AuthHandler()
detected = auth.detect_auth_scheme({
"Authorization": "Bearer token123",
"X-API-Key": "key456"
})
print(f"Auth types: {detected['auth_types']}")
Rate Limit Analysis
from scripts.rate_limiter import RateLimiter
limiter = RateLimiter()
analysis = limiter.analyze_rate_limits({
"X-RateLimit-Limit": "1000",
"X-RateLimit-Remaining": "999"
})
print(f"Requests remaining: {analysis['remaining']}")
Output Format
All modules return structured JSON:
{
"analysis_type": "string",
"endpoints_found": number,
"authentication_schemes": ["array"],
"validation_status": "valid|invalid|warning",
"rate_limit_info": { "limit": number, "remaining": number },
"security_score": 0-100,
"recommendations": ["array of actionable items"],
"client_code_generated": boolean
}
Severity Levels
| Level | Meaning | Impact | Action |
|---|---|---|---|
| CRITICAL | Security vulnerability in auth/schema | High risk | Fix immediately |
| HIGH | Missing rate limit handling | Moderate risk | Implement within sprint |
| MEDIUM | Schema validation issue | Low-moderate risk | Plan improvement |
| LOW | Minor API consistency issue | Low risk | Consider for future |
Version & Support
- Version: 1.0.0
- Released: February 2026
- Status: Production Ready
- Confidence: 92%
Future Enhancements (v1.1.0)
- GraphQL API support
- gRPC endpoint mapping
- Webhook validation
- API versioning detection
- Mock server generation
- Integration with API gateway tools
- Automated SDK generation
- GraphQL schema analysis