# Alexander Fields API
# https://www.alexanderfields.me

> Public API proxy for Alexander Fields' personal website.
> All endpoints return JSON. No authentication required for listed endpoints.

## API Documentation
- OpenAPI 3.0 Spec: https://www.proxy.alexanderfields.me/openapi.json
- Interactive Docs: https://www.proxy.alexanderfields.me/swagger

## Public Endpoints (No Authentication Required)

### Deployment & Health
- GET /api/proxy/deployment/info - Server deployment information

### GitHub (Public Profile Data)
- GET /api/proxy/github-stats - GitHub profile statistics
- GET /api/proxy/github-recent-repos - Recent public repositories

### Products & E-commerce
- GET /api/proxy/products - Product catalog
- GET /api/proxy/printful/summary - Public sales summary
- GET /api/proxy/printful/donations - Philanthropy/donation totals
- GET /api/proxy/printful/products - Product listing
- GET /api/proxy/printful/enums - Product enums/categories
- GET /api/proxy/printful/sell-goal/public - Public sales goals

### Reviews
- GET /api/proxy/amazon-reviews - Amazon product reviews
- GET /api/proxy/amazon-reviews/stats - Review statistics
- GET /api/proxy/amazon-reviews/best-rated - Best rated products
- GET /api/proxy/reviews/product/{productId} - Product reviews by ID
- POST /api/proxy/reviews/submit - Submit a product review
- POST /api/proxy/reviews/{id}/helpful - Mark review as helpful

### Analytics (Public)
- POST /api/proxy/analytics/product-click - Track product click
- GET /api/proxy/analytics/product-clicks - Product click data
- GET /api/proxy/analytics/product-clicks/summary - Click summary

### URL Shortener
- GET /api/proxy/redirects/public - Public short URLs
- GET /api/proxy/redirects/resolve/{key} - Resolve short URL to destination

### Still Alive Status
- GET /api/proxy/still-alive/status - Personal status check

### Hyperlinks (Read Only)
- GET /api/proxy/hyperlinks - Curated link collection
- GET /api/proxy/hyperlinks/{id} - Get specific hyperlink

### Audio Files (Read Only)
- GET /api/proxy/audio/{filename} - Stream audio file

### Historical Market Data
- GET /api/proxy/historical-data - Historical market data
- GET /api/proxy/historical-data-symbols - Available symbols
- GET /api/proxy/historical-data/{symbol} - Data for specific symbol
- GET /api/proxy/historical-data/{symbol}/csv - Download as CSV

### Contact
- POST /api/proxy/hire/send - Send hire/contact form

## Rate Limiting
All endpoints are rate-limited. Excessive requests will receive 429 responses.

## Contact
- Website: https://www.alexanderfields.me
- Email: me@alexanderfields.me