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:
.1Engage with Unibo: Reach out to your designated Unibo Customer Success Representative.
.2State Your Requirement: Request access to the Tournament API on your platform.
.3Obtain 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:
