Alexander FieldsAPI Documentation
This page documents the APIs available for integration with my services. The APIs are protected by a proxy system that provides authentication, rate limiting, and security features.
Protected endpoints require authentication using API keys. Improper authentication attempts may result in temporary or permanent IP bans.
Security Features
- IP Blocking: The system maintains a blocklist of IPs that have made unauthorized attempts
- Automatic Banning: IPs making multiple failed authentication attempts are automatically banned
- Intrusion Detection: Attempts to access sensitive files or endpoints result in immediate IP bans
To request API access, please contact me through the Contact Page.
| Endpoint | Method | Description | Auth Required |
|---|---|---|---|
| /products | GET | Retrieves all available products | No |
| /products?type=amazon | GET | Retrieves Amazon marketplace listings | No |
| /products?type=ebay | GET | Retrieves eBay marketplace listings | No |
| /bots/trading/logs | GET | Retrieves trading bot logs | No |
| /deployment/info | GET | Returns deployment timestamp and uptime | No |
| /api/proxy/github-stats | GET | Returns GitHub language statistics with percentages and colors | No |
GitHub Statistics Response Format
The /api/proxy/github-stats endpoint returns language statistics in the following JSON format:
{
"stats": [
{
"name": "Java",
"value": 33.78,
"color": "#b07219"
},
{
"name": "C#",
"value": 25.76,
"color": "#178600"
}
// ... more languages
]
}- name: Programming language name
- value: Percentage of code written in that language
- color: Hex color code for visualization
These endpoints facilitate payment processing through PayPal integration:
| Endpoint | Method | Description |
|---|---|---|
| /paypal/create-order | POST | Creates a new PayPal payment order |
| /paypal/capture-order | POST | Captures (finalizes) a PayPal payment |
These endpoints are primarily used by the shopping cart system on this website.
These endpoints manage audio files for the website's music player functionality. Files are stored using MongoDB GridFS to handle large audio files efficiently.
| Endpoint | Method | Description | Auth Required |
|---|---|---|---|
| /audio/:filename | GET | Retrieves an audio file by filename | No |
| /audio/upload | POST | Uploads a new audio file (multipart/form-data) | Yes |
Technical Details
- Storage: Audio files are compressed with gzip before storage to save space
- Decompression: Files are automatically decompressed when served
- Format: Supports WAV audio files
- Size Limit: Maximum file size is 500MB (configured in Next.js)
- GridFS: Uses MongoDB GridFS for automatic chunking of large files
The audio files are used in the Personality and Products pages for background music.
These endpoints allow authorized users to manage Minecraft server settings and backups. All Minecraft endpoints require authentication.
Server Configuration
| Endpoint | Method | Description |
|---|---|---|
| /games/minecraft/whitelist | GET | Gets the server whitelist |
| /games/minecraft/whitelist | POST | Updates the server whitelist |
| /games/minecraft/operators | GET | Gets server operators |
| /games/minecraft/operators | POST | Updates server operators |
World Save Management
| Endpoint | Method | Description |
|---|---|---|
| /games/minecraft/saves | GET | Gets all world saves |
| /games/minecraft/save/:fileId | GET | Downloads a specific world save |
| /games/minecraft/save | POST | Uploads a new world save |
| /games/minecraft/save/:fileId | DELETE | Deletes a specific save |
| /games/minecraft/save/older-than/:amount | DELETE | Deletes saves older than a specified age |
| /games/minecraft/save/keep/:count | DELETE | Keeps only the specified number of recent saves |
These endpoints allow for automated backup and restoration of Minecraft worlds.
To prevent abuse, the API enforces rate limits on requests. Exceeding these limits may result in temporary blocking.
Default rate limit: 45 requests per minute per IP address.
If you need higher rate limits for a legitimate application, please contact me through the Contact Page.