وثائق واجهة برمجة التطبيقات
وثائق واجهة برمجة تطبيقات خط الرياضة
كل ما تحتاجه لدمج خط الرياضة: المصادقة، الطرق، المعلمات، عينات التعليمات البرمجية الجاهزة واستجابات JSON.
GET /v1/start json
{
"ok": true,
"package": "STANDARD",
"limits": { "requests": 1000000, "rps": 40 },
"sports": 214,
"languages": ["en", "ru", "ua", "es"]
}من أين أبدأ؟
طرق واجهة برمجة التطبيقات
معلمات واجهة برمجة التطبيقات
مثال على الطلب
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()); جرب في Postman
لتسهيل دمج واجهة برمجة التطبيقات الخاصة بنا، قمنا بإعداد مجموعة من الطلبات لـ Postman. يمكنك تنزيل الملف واستيراده إلى Postman والبدء في العمل مع واجهة برمجة التطبيقات الخاصة بنا على الفور دون الحاجة إلى تكوين الطلبات يدوياً.
خطوات البدء في Postman:
قم بتنزيل مجموعة Postman واستوردها إلى تطبيق Postman.
استيراد الملف إلى Postman:
- افتح تطبيق Postman.
- في القائمة العلوية، اختر File -> Import.
- قم بتحميل الملف الذي تم تنزيله.
تكوين المتغيرات:
بعد استيراد المجموعة، ستحتاج إلى إضافة مفاتيح واجهة برمجة التطبيقات والمعلمات الأخرى الخاصة بك. يمكن القيام بذلك في قسم Variables الخاص بالمجموعة أو إضافتها يدوياً إلى كل طلب.تشغيل الطلبات:
يمكنك الآن البدء في إرسال الطلبات وتلقي البيانات من واجهة برمجة التطبيقات الخاصة بنا على الفور.
استرداد الرياضات والدول والبطولات
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
}
]
}
]
}
]
}قائمة المباريات
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
}
]
}
]
}
]
}مباراة معينة
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"
}
]
}
}أهم المباريات
البحث عن مباراة
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
}
]
}