Skip to content
DailyPlay Docs

API Overview

DailyPlay provides an API that allows third-party applications to programmatically create one-time game sessions for their users. This is ideal for CRMs, marketing platforms, e-commerce systems, and any application that wants to offer DailyPlay games to its end users in a controlled way.

How It Works

Section titled “How It Works”

The integration flow follows a simple pattern:

  1. Your server creates a one-time session token using your API key
  2. Your app redirects the end user to the game URL with the token
  3. DailyPlay validates and consumes the token — the user plays once
  4. The token is single-use and cannot be replayed
Your App                          DailyPlay
────────                          ─────────
   │
   │  1. Create session (x-api-key)
   ├─────────────────────────────────►  POST /api/org-api-keys/sessions
   │                                        │
   │  2. Receive one-time token             │
   ◄────────────────────────────────────────┘
   │
   │  3. Redirect user with token
   ├─────────────────────────────────►  Player opens game URL
   │                                    with ?session_token=<token>
   │
   │                                   4. Token validated & consumed
   │                                   5. User plays the game
   │                                   6. Token cannot be reused

Key Concepts

Section titled “Key Concepts”

API Keys

Section titled “API Keys”

API keys authenticate your server when calling the DailyPlay API. Each key:

  • Belongs to an organization
  • Can be scoped to specific games or streams
  • Has configurable rate limits
  • Can be revoked instantly

See API Keys for setup and management details.

Session Tokens

Section titled “Session Tokens”

Session tokens are one-time-use tokens that grant a single play. They:

  • Are created via your API key
  • Expire after a configurable duration (default: 24 hours)
  • Can only be consumed once
  • Carry optional metadata for tracking

See Session Tokens for the full lifecycle and API reference.

Use Cases

Section titled “Use Cases”
  • E-commerce: Reward customers with a game play after purchase
  • CRM campaigns: Send personalized game links to segmented audiences
  • Loyalty programs: Grant a daily game play to loyalty members
  • Event marketing: Distribute one-time game access at events or via QR codes

Quick Example

Section titled “Quick Example”
Terminal window
# 1. Create a session token from your server
curl -X POST https://app.dailyplay.ai/api/org-api-keys?action=create-session \
  -H "Content-Type: application/json" \
  -H "x-api-key: dpk_YOUR_API_KEY" \
  -d '{
    "game_id": 42,
    "external_ref": "user-12345",
    "expires_in_minutes": 60
  }'


# Response:
# {
#   "success": true,
#   "data": {
#     "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
#     "game_id": 42,
#     "expires_at": "2026-02-17T12:00:00.000Z"
#   }
# }


# 2. Redirect the user to:
# https://app.dailyplay.ai/play/game/42?session_token=a1b2c3d4-e5f6-7890-abcd-ef1234567890

Next Steps

Section titled “Next Steps”