# API Integration Helper

> AI-powered API integration toolkit for endpoint mapping, schema validation, authentication management, and rate limiting analysis. Maps endpoints from code, validates JSON schemas, detects auth schemes, and analyzes rate limiting strategies.

- Skill: `xspoonai/api-integration-helper` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add xspoonai/api-integration-helper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xspoonai/api-integration-helper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: XSpoonAi (https://skillmd.com/u/xspoonai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xspoonai/api-integration-helper

---


## Usage Examples

### Endpoint Mapping
```python
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
```python
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
```python
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
```python
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:

```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