WebPlayz

API Documentation

Integrate our massive games catalogue into your platform.

Authentication

To access the API, you must provide a valid API Key in the Authorization header of your requests.

Authorization: Bearer YOUR_API_KEY

Note: You can generate your API Key from your Dashboard.

Rate Limits

To ensure service stability, the API is rate-limited.

  • Limit: 60 requests per minute per API key.
  • Headers: Responses include X-RateLimit-Limit and X-RateLimit-Remaining headers.
  • Exceeded: If you exceed the limit, you will receive a 429 Too Many Requests response.

Endpoints

GET /api/v1/games

Retrieve a paginated list of available games.

Parameters

Name Type Description
page integer Page number for pagination (default: 1).

Example Response

{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "title": "Space Adventure",
            "slug": "space-adventure",
            "description": "Explore the galaxy in this thrilling adventure.",
            "thumbnail_url": "https://example.com/thumb.jpg",
            "play_url": "https://example.com/play/space-adventure",
            "categories": [...]
        },
        ...
    ],
    "first_page_url": "...",
    "from": 1,
    "last_page": 10,
    "last_page_url": "...",
    "links": [...],
    "next_page_url": "...",
    "path": "...",
    "per_page": 20,
    "prev_page_url": null,
    "to": 20,
    "total": 200
}
GET /api/v1/games/{id}

Retrieve details for a specific game.

Example Response

{
    "id": 1,
    "title": "Space Adventure",
    "slug": "space-adventure",
    "description": "Explore the galaxy in this thrilling adventure.",
    "thumbnail_url": "https://example.com/thumb.jpg",
    "play_url": "https://example.com/play/space-adventure",
    "orientation": "landscape",
    "categories": [
        {
            "id": 5,
            "name": "Action",
            "slug": "action"
        }
    ],
    ...
}