slvler / livescore-service
为 api-football.com 提供的实时比分服务 API
Requires (Dev)
- guzzlehttp/guzzle: ^7.0.1
- orchestra/testbench: ^6.18.0
- phpunit/phpunit: ^9.5
README
api-football.com 的实时比分客户端
欢迎来到 Api-Football!您可以使用我们的 API 访问所有 API 端点,获取有关足球联赛和杯赛的信息。
安装
要安装此软件包,您可以使用 composer
composer require slvler/livescore-service
使用方法
- 首先,您应该将 config/livescore.php 文件提取到 config 文件夹中。
php artisan vendor:publish --tag=livescore
- API 密钥可以从 api-football.com 地址获取。这是您的私有 API 密钥,针对此 API。
'livescore' => [ 'base_url' => 'v3.football.api-sports.io', 'api_key' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', ],
基本用法
示例
use slvler\LiveScoreService\LiveScoreClient; $client = new LiveScoreClient();
可用方法
通用
状态
获取状态列表
$data = $client->general()->getStatus();
国家
国家
获取联赛端点可用的国家列表。
$data = $client->countries()->getAll();
名称和代码字段可以用作其他端点的过滤器。
$data = $client->countries()->getAll(['code' => 'FR']);
联赛
国家
获取可用的联赛和杯赛列表。此端点还返回每个比赛的覆盖范围,这使得可以知道该联赛或杯赛中有什么。
$variable = $client->leagues()->getLeagues(['season' => '2018', 'id' => '33']);
赛季
所有赛季都是四位数字键,因此对于像英格兰超级联赛(EPL)这样的2018-2019赛季,API中的2018-2019赛季将是2018。
$variable = $client->leagues()->getLeaguesSeasons();
球队
球队信息
获取可用球队列表。球队 ID 在 API 中是唯一的,并且球队在参加的所有联赛/杯赛中保持唯一性。
$variable = $client->team()->getTeamsInformation(['name' => 'manchester united']);
球队统计数据
球队 ID 在 API 中是唯一的,并且球队在参加的所有联赛/杯赛中保持唯一性。
$variable = $client->team()->getTeamsStatistics(['league' => '39', 'team' => '33', 'season' => '2019']);
球队赛季
获取球队可用的赛季列表。
$variable = $client->team()->getTeamsSeasons(['team' => '33']);
球队国家
获取球队端点可用的国家列表。
$variable = $client->team()->getTeamCountries();
场地
场地
获取可用场地的列表。场地 ID 在 API 中是唯一的。
$variable = $client->venues()->getVenues(['name' => 'Old Trafford']);
积分榜
积分榜
获取联赛或球队的积分榜。返回一个或多个根据联赛/杯赛排名的表格。
$variable = $client->standings()->getStandings([ 'league' => '39', 'season' => '2019']);
比赛
轮次
获取联赛或杯赛的轮次。轮次可以用作端点比赛的过滤器。
$variable = $client->fixtures()->getRounds(['league' => '39', 'season' => 2019]);
比赛
对于所有对比赛的请求,您可以在请求中添加查询参数 timezone 以获取您选择的时区的比赛列表,例如“Europe/London”
$variable = $client->fixtures()->getFixtures(['id' => '215662']);
对战
获取两队之间的对战。
$variable = $client->fixtures()->getHeadToHead(['h2h' => '33-34']);
统计数据
获取一场比赛的数据。
$variable = $client->fixtures()->getStatistics(['fixture' => '215662']);
事件
从一场比赛中获取事件。
$variable = $client->fixtures()->getEvents(['fixture' => '215662']);
阵容
获取比赛的阵容。当比赛覆盖此功能时,阵容在比赛开始前 20 到 40 分钟可用。您可以通过联赛端点和覆盖字段来检查此功能。
$variable = $client->fixtures()->getLineups(['fixture' => '592872']);
球员统计数据
从一场比赛中获取球员统计数据。
$variable = $client->fixtures()->getPlayersStatistics(['fixture' => '169080']);
伤病
伤病
获取因各种原因(如禁赛、受伤等)无法参加比赛的球员名单。
$variable = $client->injuries()->getInjuries(['league' => '2', 'season' => '2020']);
预测
预测
获取关于比赛的预测。预测使用多种算法进行,包括泊松分布、团队统计数据比较、最后一场比赛、球员等...
$variable = $client->predictions()->getPredictions(['fixture' => '198772']);
教练
教练
获取所有教练及其职业生涯的信息。
$variable = $client->coachs()->getCoachs(['id' => '1']);
球员
赛季
获取球员统计数据可用的所有赛季。
$variable = $client->players()->getSeasons(['player' => '276']);
球员
获取球员统计数据。
$variable = $client->players()->getPlayers(['id' => '19088', 'season' => '2018']);
阵容
当使用团队参数时,返回团队的当前阵容。当使用球员参数时,端点返回与球员关联的团队集。
$variable = $client->players()->getSquads(['team' => '33']);
最佳射手
获取联赛或杯赛的20位最佳球员。
$variable = $client->players()->getTopScorers(['season' => '2018', 'league' => '61']);
最佳助攻
获取联赛或杯赛的20位最佳助攻球员。
$variable = $client->players()->getTopAssists(['season' => '2020', 'league' => '61']);
最佳黄牌
获取联赛或杯赛中获得黄牌最多的20名球员。
$variable = $client->players()->getTopYellowCards(['season' => '2020', 'league' => '61']);
红牌榜
获取联赛或杯赛中获得红牌最多的20名球员。
$variable = $client->players()->getTopRedCards(['season' => '2020', 'league' => '61']);
转会
转会
获取球员和球队的所有可用转会。
$variable = $client->transfer()->getTransfer(['player' => '35845']);
奖杯
转会
获取球员或教练的所有可用奖杯。
$variable = $client->trophies()->getTrophies(['player' => '35845']);
停赛
停赛
获取球员或教练的所有可用停赛信息。
$variable = $client->sidelined()->getSidelined(['player' => '276']);
赔率
赔率 / 实时
此端点返回正在进行的比赛的实时赔率。
$variable = $client->odds()->getOddsLive();
赔率 / 实时 / 投注
获取所有可用实时赔率的投注。
$variable = $client->odds()->getOddsLivBets(['id' => "1"]);
赔率
从比赛、联赛或日期获取赔率。
$variable = $client->odds()->getOdds(['date' => "2020-05-15"]);
映射
获取赔率端点可用的所有比赛ID列表。
$variable = $client->odds()->getOddsMapping();
博彩公司
获取所有可用的博彩公司。
$variable = $client->odds()->getOddsBookmakers();
投注
获取所有可用于赛前赔率的投注。
$variable = $client->odds()->getOddsBets();
测试
composer test
积分
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证文件。