Tournament API

Introduction

Welcome to the Unibo Public Tournament API Integration Guide. In the rapidly evolving world of online gaming, delivering timely and engaging content is paramount. Our Tournament API is designed to empower you with real-time, dynamic tournament information, enriching your user experience and ensuring they always have the latest details at their fingertips. This guide is tailored to streamline your integration journey.

Enabling the Tournament API

To get started with this integration, you'll first need to have the Tournament API enabled for your platform. Here's your pathway to activation:

Engage with Unibo: Reach out to your designated Unibo Customer Success Representative.
State Your Requirement: Request access to the Tournament API on your platform.
Obtain Your API Key: Post discussion, your representative will equip you with the requisite API key, acting as your gateway to access the Tournament data.

Implementation Procedure

Our Tournament API has been architected to deliver data seamlessly in a structured JSON format. Whether it's about tournaments on the horizon, those in full swing, or those that have winded up, all this information is at your beck and call, ready to be showcased on your promotional pages.

Endpoint:

https://<your back office URL>/public/api/v1/tournaments/details

Paged API Response Structure

Our focus on performance and efficiency is unwavering, which is why our API responses are paged to ensure brisk and efficient data transfer. Here’s what the structure looks like:

{
    "count": int,            // Total number of results across all pages.
    "next": "URL|absent",    // URL for the next page of results or absent if on the last page.
    "previous": "URL|absent",// URL for the previous page or absent if on the first page.
    "results": [
        // Array of individual tournament objects.
        {
            "campaign": {...},
            "tournament_prizes": [...],
            "total_prizes": [...],
            "leaderboard": [...]
        }
    ]
}

Sample API Response

To set the right expectation, here’s a succinct sample of the kind of data structure and content you can anticipate:

{
    "count": 1,
    "results": [{
        "campaign": {
            "id": 1293,
            "name": "€$1000 cash race",
            "start": "2023-10-05T2200Z",
            "end": "2023-10-08T2100Z",
            "status_for_display": "finished",
            "terms": {
                "content": "sample terms content...",
                "campaign_type_for_display": "tournaments",
                "tournament_type_for_display": "races"
            },
            "game_ids": ["45257", ...]
        },
        "tournament_prizes": [{
            "title": "€300 cash",
            "place_from": 1,
            "place_to": 1
        }, ...],
        "total_prizes": {
            "cash": "€45",
            "free_spins": 6,
            "bonus": "€28",
            "catalog_item": [
                "iPhone 12",
                "Holiday Voucher €500"
            ],
            "deposit_bonus": "2 Deposit Bonuses"
        },
        "leaderboard": [{
            "player_id": "3116686",
            "player_username": "R***3",
            "score": "700.00",
            "prizes": ["€300 cash"]
        }, ...]
    }]
}

We remain committed to ensuring that your integration with the Unibo Public Tournament API is as seamless and enriching as possible. Prioritize security in your implementations and stay aligned with best practices. If uncertainties arise or if you need further assistance, our support team stands ready to assist. We wish you a smooth integration journey!

Example Implementation

This API allows you to create pages and widgets to display Active, Finished, and/or Scheduled Tournaments, with information such as:

Campaign name
Campaign duration (start/end time with or without countdown)
Prize Pool
Leaderboard
Terms and Conditions
Eligible Games

Here are two examples of how it can be done:

Was this helpful?