Documentation API
API de ligne sportive Documentation
Tout ce dont vous avez besoin pour intégrer la ligne sportive : authentification, méthodes, paramètres, exemples de code prêts à l'emploi et réponses JSON.
GET /v1/start json
{
"ok": true,
"package": "STANDARD",
"limits": { "requests": 1000000, "rps": 40 },
"sports": 214,
"languages": ["en", "ru", "ua", "es"]
}Par où commencer ?
Méthodes API
Paramètres API
Exemple de requête
GET /v1/menu/live/en python
import requests
url = "https://api.sportapi.net/v1/events/21/101/prematch/en"
headers = {"Package": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json()) GET /v1/menu/live/en php
GET /v1/menu/live/en js
const res = await fetch(
"https://api.sportapi.net/v1/events/21/101/prematch/en",
{ headers: { Package: "YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data); GET /v1/menu/live/en java
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sportapi.net/v1/events/21/101/prematch/en"))
.header("Package", "YOUR_API_KEY")
.GET()
.build();
HttpResponse response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body()); Essayer dans Postman
Pour simplifier l'intégration de notre API, nous avons préparé une collection de requêtes pour Postman. Vous pouvez télécharger le fichier, l'importer dans Postman et commencer à travailler immédiatement avec notre API sans avoir à configurer manuellement les requêtes.
Étapes pour démarrer dans Postman :
Téléchargez la collection Postman et importez-la dans Postman.
Importez le fichier dans Postman :
- Ouvrez Postman.
- Dans le menu supérieur, sélectionnez File -> Import.
- Téléchargez le fichier téléchargé.
Configurez les variables :
Après avoir importé la collection, vous devrez ajouter vos clés API et autres paramètres. Cela peut être fait dans la section Variables de la collection ou ajouté manuellement à chaque requête.Exécutez les requêtes :
Vous pouvez maintenant envoyer des requêtes et recevoir des données de notre API immédiatement.
Récupération des sports, pays et championnats
GET /v1/menu/live/en json
{
"status":1,
"body":[
{
"id":1,
"name":"Football",
"counter":126,
"sub":[
{
"id":12,
"name":"Europe",
"sport_id":1,
"counter":10,
"sub":[
{
"id":118587,
"name":"UEFA Champions League",
"sport_id":1,
"country_id":12,
"counter":3
},
{
"id":218103,
"name":"UEFA Champions League. Winner",
"sport_id":1,
"country_id":12,
"counter":1
},
{
"id":16,
"name":"Italy",
"sport_id":1,
"counter":1,
"sub":[
{
"id":6356,
"name":"Italy. Serie C. Group A",
"sport_id":1,
"country_id":16,
"counter":1
}
]
}
]
}
]
},
{
"id":2,
"name":"Tennis",
"counter":40,
"sub":[
{
"id":14,
"name":"Portugal",
"sport_id":2,
"counter":1,
"sub":[
{
"id":8031,
"name":"Challenger. Braga",
"sport_id":2,
"country_id":14,
"counter":1
}
]
}
]
}
]
}Liste des matchs
GET /v1/events/1/0/list/50/live/en json
// [KG] = list
{
"status": 1,
"body": [
{
"sgame_id": "66f8a2d60d8c0bfbf1af3f93",
"stat_id": "66c914530d8c0bfbf15f5682",
"game_id": 562898620,
"game_mid": 562898620,
"game_dop_name": "Extra-Time",
"game_start": 1707807400,
"game_oc_counter": 38,
"country_id": 231,
"country_name": "England",
"tournament_id": 108319,
"tournament_name": "England. FA Cup",
"opp_1_name": "King's Lynn Town",
"opp_2_name": "Worksop Town",
"opp_1_id": 40547,
"opp_2_id": 40549,
"opp_1_icon": "400098.png",
"opp_2_icon": "1201c9f.png",
"sport_name": "Football",
"sport_id": 1,
"score_full": "0:0",
"score_extra": "0:0",
"score_period": "0:0",
"period_name": "3 Half",
"timer": 6511,
"finale": false,
"pitch": null,
"game_oc_list": [
{
"oc_group_name": "Double Chance",
"oc_name": "1X",
"oc_rate": 1.136,
"oc_pointer": "562898620|8|4|0",
"oc_block": false
}
]
}
]
}
// [KG] = sub
{
"status": 1,
"body": [
{
"tournament_id": 8147,
"tournament_name": "Thailand. League Cup",
"events_list": [
{
"sgame_id": 66f8a2d60d8c0bfbf1af3f93,
"stat_id": 3788a2d60d8c0bfbf1af3f93,
"game_id": 562987092,
"game_mid": 562987092,
"game_dop_name": "",
"game_start": 1707856000,
"game_oc_counter": 183,
"country_id": 180,
"country_name": "Thailand",
"tournament_id": 8147,
"tournament_name": "Thailand. League Cup",
"opp_1_name": "ACDC",
"opp_2_name": "Pattaya United",
"opp_1_id": 505873,
"opp_2_id": 4978,
"opp_1_icon": "729aadb95ad1df.png",
"opp_2_icon": "4978.png",
"sport_name": "Football",
"sport_id": 1,
"score_full": "1:1",
"score_extra": "0:0",
"score_period": "1:1;0:0",
"period_name": "2 Half",
"timer": 4451,
"pitch": null,
"finale": false,
"game_oc_list": [
{
"oc_group_name": "1X2",
"oc_name": "W1",
"oc_rate": 8.19,
"oc_pointer": "562987092|1|1|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "X",
"oc_rate": 1.82,
"oc_pointer": "562987092|1|2|0",
"oc_block": false
}
]
}
]
}
]
}Match spécifique
GET /v1/event/45566556/sub/live/en json
{
"status": 1,
"body": {
"game_oc_list": [
{
"group_id": 1,
"group_name": "1X2",
"columns": 3,
"oc_list": [
{
"oc_group_name": "1X2",
"oc_name": "W1",
"oc_rate": 1.245,
"oc_size": 0,
"oc_pointer": "563034215|1|1|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "X",
"oc_rate": 5.48,
"oc_size": 0,
"oc_pointer": "563034215|1|2|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "W2",
"oc_rate": 7.97,
"oc_size": 0,
"oc_pointer": "563034215|1|3|0",
"oc_block": false
}
]
},
{
"group_id": 2,
"group_name": "Handicap",
"columns": 2,
"oc_list": [
{
"oc_group_name": "Handicap",
"oc_name": "1 (-1.5)",
"oc_rate": 1.904,
"oc_size": -1.5,
"oc_pointer": "563034215|2|7|-1.5",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "1 (0)",
"oc_rate": 1.06,
"oc_size": 0,
"oc_pointer": "563034215|2|7|0",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "2 (0)",
"oc_rate": 6.02,
"oc_size": 0,
"oc_pointer": "563034215|2|8|0",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "2 (+1.5)",
"oc_rate": 1.76,
"oc_size": 1.5,
"oc_pointer": "563034215|2|8|1.5",
"oc_block": false
}
]
}
],
"stat_list": [
{
"id": 45,
"name": "Attacks",
"opp1": "22",
"opp2": "28"
},
{
"id": 58,
"name": "Dangerous attacks",
"opp1": "13",
"opp2": "25"
},
{
"id": 29,
"name": "Possession %",
"opp1": "45",
"opp2": "55"
},
{
"id": 59,
"name": "Shots on target",
"opp1": "3",
"opp2": "2"
},
{
"id": 60,
"name": "Shots off target",
"opp1": "2",
"opp2": "2"
},
{
"id": 26,
"name": "Yellow cards",
"opp1": "0",
"opp2": "0"
},
{
"id": 70,
"name": "Corner",
"opp1": "0",
"opp2": "3"
},
{
"id": 71,
"name": "Red card",
"opp1": "0",
"opp2": "0"
},
{
"id": 72,
"name": "Penalty",
"opp1": "0",
"opp2": "0"
}
],
"sub_games": [
{
"game_id": 563034216,
"game_num": 48560,
"game_name": "1st half"
},
{
"game_id": 563034217,
"game_num": 48561,
"game_name": "2nd half"
},
{
"game_id": 563034286,
"game_num": 42676,
"game_name": "Result + Total"
}
]
}
}Matchs phares
Recherche de match
GET /v1/search/live/en/realmadrid json
{
"status": 1,
"page": "/v1/events",
"body": [
{
"game_id": 563038643,
"dtype": "live",
"opp1": "Real Madrid (Kimmich_8143)",
"opp2": "Bayern Munich (Mata_8254)",
"champname": "FIFA 24. Cyber League",
"sportname": "Football",
"gamestart": 1707871900
},
{
"game_id": 563043348,
"dtype": "live",
"opp1": "Lille OSC U19",
"opp2": "Real Madrid U19",
"champname": "UEFA Youth League",
"sportname": "Football",
"gamestart": 1707874000
},
{
"game_id": 563046811,
"dtype": "live",
"opp1": "Real Madrid (Mevis)",
"opp2": "Chelsea (Mick)",
"champname": "FIFA 23. Volta daily league",
"sportname": "Football",
"gamestart": 1707874485
},
{
"game_id": 563043227,
"dtype": "live",
"opp1": "Real Madrid",
"opp2": "Bayern",
"champname": "FIFA18. Penalty",
"sportname": "FIFA",
"gamestart": 1707874900
}
]
}