Python SDK

The official Python SDK provides typed methods for all API endpoints.

View source on GitHub

Installation

pip install weplaytestgames

Quick Start

from weplaytestgames import WPGClient

client = WPGClient(api_key="wpg_sk_...")

# List your games
games = client.games.list()

# Create a playtest
playtest = client.playtests.create(
    game_id="game_abc123",
    visibility="private",
    quantity=3,
    instructions="Focus on the tutorial",
)

# Check credit balance
balance = client.billing.get_balance()
print(f"Balance: ${balance.balance_cents / 100}")

Authentication

import os
from weplaytestgames import WPGClient

client = WPGClient(
    api_key=os.environ["WPG_API_KEY"],
    # Optional: custom base URL
    base_url="https://app.weplaytestgames.com/api/v1",
)

Error Handling

from weplaytestgames import WPGClient, WPGError

try:
    client.playtests.create("game_abc", visibility="private", quantity=1)
except WPGError as e:
    print(e.code)     # "PAYMENT_REQUIRED"
    print(e.message)  # "Insufficient credit"
    print(e.status)   # 402

Pagination

# Iterate all pages
for game in client.games.list():
    print(game.name)

# Get a single page
page = client.games.list(limit=10)
print(page.data)
print(page.meta.has_more)

Async Support

from weplaytestgames import AsyncWPGClient

client = AsyncWPGClient(api_key="wpg_sk_...")

games = await client.games.list()

Available Methods

Namespace	Methods
client.auth	me(), update_profile(), categories(), devices(), platforms()
client.games	list(), create(), get(), update()
client.playtests	create(), list(), get(), update(), slots()
client.slots	get(), accept(), reject(), download_url(), transcript()
client.playtester	profile(), update_profile(), stats(), open_playtests(), my_playtests()
client.billing	get_balance(), payments(), purchase_credit()
client.payouts	list(), quote(), request(), cancel()
client.chat	contacts(), conversation(), send_message(), unread_count()
client.webhooks	list(), create(), update(), delete(), deliveries(), test()