API v1.0.0 - Now Available

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

Bash
# Production API Base URL
https://api.sonofutred.uk/api/v1

2Authentication

Include your API key in the request headers:

Bash
X-API-Key: your_api_key_here

# Or use Authorization header
Authorization: Bearer your_api_key_here

3Make Your First Request

Bash
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

  1. Open your Telegram bot profile
  2. Click on "👤 Profile"
  3. Click "🔑 Create API Key" (or "🔄 Regenerate API Key" if you already have one)
  4. Important: Copy and save your API key immediately. It will only be shown once!
  5. 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)
🌏 Asia
Asia Pacific region
🌎 America
North & South America
🌍 Europe
European region
🇹🇼 TW/HK/MO
Taiwan, Hong Kong, Macau

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

Bash
# 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.

GET/profile

Get User Profile

Get your complete user profile including balance, tier, and statistics.

Bash
curl -X GET "https://api.sonofutred.uk/api/v1/profile" \
  -H "X-API-Key: your_api_key_here"
GET/balance

Get Balance (Quick)

Get your current balance quickly without full profile data.

Bash
curl -X GET "https://api.sonofutred.uk/api/v1/balance" \
  -H "X-API-Key: your_api_key_here"
POST/player/verify

Verify Player Name

Verify a PUBG Mobile player UID and get their player name.

Bash
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"
  }'
GET/products

Get Available Products

Get a complete list of all available products including games, gift cards, and game keys with prices and stock availability.

Bash
curl -X GET "https://api.sonofutred.uk/api/v1/products" \
  -H "X-API-Key: your_api_key_here"
POST/orders/giftcard

Purchase 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
Bash
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
  }'
POST/orders/gamekey

Purchase Game Keys

Purchase game keys instantly. Keys are delivered immediately.

Bash
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
  }'
POST/orders/game

Place 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
Bash
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"
  }'
GET/orders/:orderId

Get Order Status

Get the status of a specific order.

Bash
curl -X GET "https://api.sonofutred.uk/api/v1/orders/GO-1234567890-123456" \
  -H "X-API-Key: your_api_key_here"
GET/orders

List 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)
Bash
curl -X GET "https://api.sonofutred.uk/api/v1/orders?limit=50&offset=0&status=done" \
  -H "X-API-Key: your_api_key_here"
GET/my-ip

Get 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
Bash
# 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-ip

Code Examples

Integrate the API into your application with these ready-to-use examples.

JavaScript/Node.js

JavaScript
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

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

JSON
{
  "success": false,
  "error": "Error message description"
}

HTTP Status Codes

  • 200 - Success
  • 400 - Bad Request
  • 401 - Unauthorized
  • 403 - Forbidden
  • 404 - Not Found
  • 429 - Rate Limit Exceeded
  • 500 - 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