kirill-latish/laravel-sportmonks-soccer

Laravel wrapper for Soccerama score API calls v2.0. Fork of rebing/laravel-soccerama

Laravel Sportmonks Soccer API

Laravel wrapper for Sportmonks (live) score API calls. Documentation for the API can be found here, _(*1)

Installation

1- Require the package via Composer in your composer.json., _(*2)

{
  "require": {
    "kirill-latish/laravel-sportmonks-soccer": "^2.0"
  }
}

2- Run Composer to install or update the new requirement., _(*3)

$ composer install

or, _(*4)

$ composer update

3- Add the service provider to your app/config/app.php file, _(*5)

Sportmonks\SoccerAPI\SoccerAPIServiceProvider::class,

4- Add the facade to your app/config/app.php file, _(*6)

'SoccerAPI' => Sportmonks\SoccerAPI\Facades\SoccerAPI::class,

5- Publish the configuration file, _(*7)

$ php artisan vendor:publish --provider="Sportmonks\SoccerAPI\SoccerAPIServiceProvider"

6- Review the configuration file and add your token (preferably through env: 'api_token' => env('API_TOKEN') ), _(*8)

config/soccerapi.php

7- Review the configuration file and add your timezone (preferably through config file: 'timezone' => config('app.timezone') ), _(*9)

config/soccerapi.php

Usage

Refer to the official docs as to which calls can be made and check the calls in traits under Sportmonks\SoccerAPI\Requests., _(*10)

For example, get all leagues (if using facade):, _(*11)

use SoccerAPI;

...

$response = SoccerAPI::leagues()->all();

The above returns an object containing a data array. If you want to directly retrieve the data within data, change your config file: 'without_data' => true, _(*12)

Get a match by its id:, _(*13)

$response = SoccerAPI::fixtures()->byId($id);

If you need to include other relations (check the official docs for which relations can be included):, _(*14)

$include = 'league,fixtures';
// Or: $include = ['league', 'fixtures'];

$response = SoccerAPI::seasons()->setInclude($include)->all();