Gamers Workshop API
Integrate with our platform programmatically. Purchase gift cards, game keys, and game top-ups with our powerful REST API.
Lightning Fast
Instant delivery for gift cards and game keys. Real-time order processing.
Secure
API key authentication with IP whitelisting. Rate limiting for protection.
Easy Integration
RESTful API with clear documentation. Code examples in multiple languages.
Quick Start
Get up and running with the Gamers Workshop API in minutes.
1Base URL
# Production API Base URL
https://api.sonofutred.uk/api/v12Authentication
Include your API key in the request headers:
X-API-Key: your_api_key_here
# Or use Authorization header
Authorization: Bearer your_api_key_here3Make Your First Request
curl -X GET "https://api.sonofutred.uk/api/v1/balance" \
-H "X-API-Key: your_api_key_here"Authentication
All API requests require authentication using an API key.
Getting Your API Key
- Open your Telegram bot profile
- Click on "👤 Profile"
- Click "🔑 Create API Key" (or "🔄 Regenerate API Key" if you already have one)
- Important: Copy and save your API key immediately. It will only be shown once!
- If you need a new key, use "🔄 Regenerate API Key" - this will revoke your old key immediately
Security Requirements
- • API access requires approval (beta program)
- • IP whitelist must be configured (max 2 IPs)
- • Use environment variables to store your API key
- • Never commit API keys to version control
Game Servers
Some games require server selection. Here are the available server options.
🌍Supported Servers
Games Requiring Server Selection
The following games require a server parameter:
- • Genshin Impact (genshin)
- • Honkai: Star Rail (honkai)
- • Zenless Zone Zero (zenless)
Games Using Zone ID
The following games use zoneId instead of server:
- • Mobile Legends (mobilelegend) - Requires numeric zone ID
- • Mobile Legends Indonesia (mlindo) - Requires numeric zone ID
- • Mobile Legends Philippines (mlph) - Requires numeric zone ID
- • Mobile Legends Russia (mlrussia) - Requires numeric zone ID
- • Magic Chess (magicchess) - Requires numeric zone ID
Example Usage
# Genshin Impact with server
curl -X POST "https://api.sonofutred.uk/api/v1/orders/game" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"game": "genshin",
"pack": "980",
"uid": "123456789",
"server": "Asia"
}'
# Mobile Legends with zoneId
curl -X POST "https://api.sonofutred.uk/api/v1/orders/game" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"game": "mobilelegend",
"pack": "86",
"uid": "1234567890",
"zoneId": "1234"
}'API Endpoints
Complete reference for all available API endpoints.
/profileGet User Profile
Get your complete user profile including balance, tier, and statistics.
curl -X GET "https://api.sonofutred.uk/api/v1/profile" \
-H "X-API-Key: your_api_key_here"/balanceGet Balance (Quick)
Get your current balance quickly without full profile data.
curl -X GET "https://api.sonofutred.uk/api/v1/balance" \
-H "X-API-Key: your_api_key_here"/player/verifyVerify Player Name
Verify a PUBG Mobile player UID and get their player name.
curl -X POST "https://api.sonofutred.uk/api/v1/player/verify" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"uid": "1234567890"
}'/productsGet Available Products
Get a complete list of all available products including games, gift cards, and game keys with prices and stock availability.
curl -X GET "https://api.sonofutred.uk/api/v1/products" \
-H "X-API-Key: your_api_key_here"/orders/giftcardPurchase Gift Cards
Purchase gift cards instantly. Codes are delivered immediately.
Notes:
- • Valid Platforms: psn, xbox, steam, itunes, googleplay, nintendo, roblox, valorant
- • Robux Cards: Use platform 'robux' with denominations: 800, 2000, 4500, 10000
- • Valorant Cards: Use platform 'valorant' with denominations: 5, 10, 15, 25, 50, 80
- • Codes are returned immediately in the response
curl -X POST "https://api.sonofutred.uk/api/v1/orders/giftcard" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"platform": "psn",
"denomination": "50",
"quantity": 2
}'/orders/gamekeyPurchase Game Keys
Purchase game keys instantly. Keys are delivered immediately.
curl -X POST "https://api.sonofutred.uk/api/v1/orders/gamekey" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"game": "pubg",
"pack": "60_uc",
"quantity": 1
}'/orders/gamePlace Game Order
Place an order for game top-ups (e.g., Mobile Legends diamonds, Genshin Impact crystals). These orders are processed automatically.
Notes:
- • zoneId: Required for Mobile Legends and similar games (numeric zone identifier)
- • server: Required for Genshin Impact, Honkai Star Rail, Zenless Zone Zero. Valid values: Asia, America, Europe, TW/HK/MO
- • webhookUrl: Optional HTTPS URL to receive order status updates
- • Orders will be auto completed by our API GW AUTO
curl -X POST "https://api.sonofutred.uk/api/v1/orders/game" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"game": "mobilelegend",
"pack": "86",
"uid": "1234567890",
"zoneId": "1234",
"server": "Asia",
"webhookUrl": "https://your-webhook-url.com/webhook"
}'/orders/:orderIdGet Order Status
Get the status of a specific order.
curl -X GET "https://api.sonofutred.uk/api/v1/orders/GO-1234567890-123456" \
-H "X-API-Key: your_api_key_here"/ordersList User Orders
Get a list of all your orders with pagination.
Notes:
- • limit: Number of orders to return (default: 50, max: 100)
- • offset: Number of orders to skip (default: 0)
- • status: Filter by status (done, processing, cancelled)
curl -X GET "https://api.sonofutred.uk/api/v1/orders?limit=50&offset=0&status=done" \
-H "X-API-Key: your_api_key_here"/my-ipGet Current IP
Get your current client IP address (no authentication required). Use this to add your IP to the whitelist. When accessed from a browser, automatically shows the browser version.
Notes:
- • Browser access: Automatically redirects to browser version
- • API access: Add 'Accept: application/json' header to get JSON response
- • No authentication required for this endpoint
# API Call (returns JSON)
curl -X GET "https://api.sonofutred.uk/api/v1/my-ip" \
-H "Accept: application/json"
# Or open in browser for browser version:
# https://api.sonofutred.uk/my-ipCode Examples
Integrate the API into your application with these ready-to-use examples.
JavaScript/Node.js
const API_BASE_URL = 'https://api.sonofutred.uk/api/v1';
const API_KEY = 'your_api_key_here';
async function getBalance() {
const response = await fetch(`${API_BASE_URL}/balance`, {
headers: {
'X-API-Key': API_KEY
}
});
const data = await response.json();
if (data.success) {
console.log('Balance:', data.data.balance);
} else {
console.error('Error:', data.error);
}
}
async function purchaseGiftCard(platform, denomination, quantity) {
const response = await fetch(`${API_BASE_URL}/orders/giftcard`, {
method: 'POST',
headers: {
'X-API-Key': API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
platform,
denomination,
quantity
})
});
const data = await response.json();
if (data.success) {
console.log('Order ID:', data.data.orderId);
console.log('Codes:', data.data.codes);
} else {
console.error('Error:', data.error);
}
}
// Usage
getBalance();
purchaseGiftCard('psn', '50', 2);Python
import requests
API_BASE_URL = 'https://api.sonofutred.uk/api/v1'
API_KEY = 'your_api_key_here'
headers = {
'X-API-Key': API_KEY
}
def get_balance():
response = requests.get(f'{API_BASE_URL}/balance', headers=headers)
data = response.json()
if data['success']:
print(f"Balance: {data['data']['balance']}")
else:
print(f"Error: {data['error']}")
def purchase_gift_card(platform, denomination, quantity):
response = requests.post(
f'{API_BASE_URL}/orders/giftcard',
headers={**headers, 'Content-Type': 'application/json'},
json={
'platform': platform,
'denomination': denomination,
'quantity': quantity
}
)
data = response.json()
if data['success']:
print(f"Order ID: {data['data']['orderId']}")
print(f"Codes: {data['data']['codes']}")
else:
print(f"Error: {data['error']}")
# Usage
get_balance()
purchase_gift_card('psn', '50', 2)Error Handling
All errors follow a consistent format with appropriate HTTP status codes.
Error Response Format
{
"success": false,
"error": "Error message description"
}HTTP Status Codes
200- Success400- Bad Request401- Unauthorized403- Forbidden404- Not Found429- Rate Limit Exceeded500- Server Error
Rate Limiting
- • Limit: 10 requests per second per API key
- • Window: 1 second sliding window
- • Response: 429 status code when exceeded
- • Reset: Counter resets automatically after 1 second
Order Status Values
processing
Order is being processed
done
Order completed successfully
cancelled
Order was cancelled
failed
Order failed